read_bar_code_modelT_read_bar_code_modelReadBarCodeModelReadBarCodeModel (Operator)

Name

read_bar_code_modelT_read_bar_code_modelReadBarCodeModelReadBarCodeModel — Read a bar code model from a file and create a new model.

Signature

read_bar_code_model( : : FileName : BarCodeHandle)

Description

The operator read_bar_code_modelread_bar_code_modelReadBarCodeModelReadBarCodeModelReadBarCodeModel reads the bar code model from the file FileNameFileNameFileNameFileNamefileName and creates a new model that is an identical copy of the saved model. The parameter BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle returns the handle of the new model. The model file FileNameFileNameFileNameFileNamefileName must have been created by the operator write_bar_code_modelwrite_bar_code_modelWriteBarCodeModelWriteBarCodeModelWriteBarCodeModel. The default HALCON file extension for bar code model is 'bcm'.

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

FileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

Name of the bar code model file.

Default value: 'bar_code_model.bcm' "bar_code_model.bcm" "bar_code_model.bcm" "bar_code_model.bcm" "bar_code_model.bcm"

File extension: .bcm

BarCodeHandleBarCodeHandleBarCodeHandleBarCodeHandlebarCodeHandle (output_control) barcode → (handle)

Handle of the bar code model.

Result

The operator read_bar_code_modelread_bar_code_modelReadBarCodeModelReadBarCodeModelReadBarCodeModel returns the value 2 (H_MSG_TRUE) if the named bar code file was found and correctly read. Otherwise, an exception is raised.