read_ncc_modelT_read_ncc_modelReadNccModelReadNccModelread_ncc_model (Operator)
Name
read_ncc_modelT_read_ncc_modelReadNccModelReadNccModelread_ncc_model — Read an NCC model from a file.
Signature
def read_ncc_model(file_name: str) -> HHandle
Description
The operator read_ncc_modelread_ncc_modelReadNccModelReadNccModelReadNccModelread_ncc_model reads an NCC model, which has
been written with write_ncc_modelwrite_ncc_modelWriteNccModelWriteNccModelWriteNccModelwrite_ncc_model, from the file
FileNameFileNameFileNameFileNamefileNamefile_name. The default HALCON file extension for
the NCC model is 'ncm'.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
Parameters
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
File name.
File extension:
.ncm
ModelIDModelIDModelIDModelIDmodelIDmodel_id (output_control) ncc_model → HNCCModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the model.
Result
If the file name is valid, the operator read_ncc_modelread_ncc_modelReadNccModelReadNccModelReadNccModelread_ncc_model
returns the value 2 (
H_MSG_TRUE)
. If necessary an exception is raised.
Possible Successors
find_ncc_modelfind_ncc_modelFindNccModelFindNccModelFindNccModelfind_ncc_model,
find_ncc_modelsfind_ncc_modelsFindNccModelsFindNccModelsFindNccModelsfind_ncc_models
See also
create_ncc_modelcreate_ncc_modelCreateNccModelCreateNccModelCreateNccModelcreate_ncc_model,
clear_ncc_modelclear_ncc_modelClearNccModelClearNccModelClearNccModelclear_ncc_model
Module
Matching