read_structured_light_model — Read a structured light model from a file.
read_structured_light_model reads the structured light model StructuredLightModel that has been stored with write_structured_light_model. The default HALCON file extension for the structured light model is 'hslm'.
It can be helpful to write a model after setting all the optimal parameters for a particular setup. The model can be read later to easily regenerate pattern images. The objects already generated in the model before writing it can be also revisited later after reading the model.
For an explanation of the concept of structured light and its supported applications, see the introduction of chapter Inspection / Structured Light.
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.
File extension: .hslm
Handle of the structured light model.
* Read the model read_structured_light_model ('ExampleModel.hslm', StructuredLightModel) * Get a previously decoded result get_structured_light_object (CorrespondenceImages, StructuredLightModel, \ 'correspondence_image') * Decode new camera images decode_structured_light_pattern (CameraImages, StructuredLightModel) * Get the decoded result get_structured_light_object (CorrespondenceImagesNew, StructuredLightModel, \ 'correspondence_image')
The operator read_structured_light_model returns the value 2 (H_MSG_TRUE) if the given parameters are valid. Otherwise, an exception will be raised.