deserialize_structured_light_modelT_deserialize_structured_light_modelDeserializeStructuredLightModelDeserializeStructuredLightModel (Operator)

Name

deserialize_structured_light_modelT_deserialize_structured_light_modelDeserializeStructuredLightModelDeserializeStructuredLightModel — Deserialize a structured light model.

Signature

deserialize_structured_light_model( : : SerializedItemHandle : StructuredLightModel)

Description

deserialize_structured_light_modeldeserialize_structured_light_modelDeserializeStructuredLightModelDeserializeStructuredLightModelDeserializeStructuredLightModel deserializes a structured light model that was serialized by serialize_structured_light_modelserialize_structured_light_modelSerializeStructuredLightModelSerializeStructuredLightModelSerializeStructuredLightModel (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized structured light model is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. The deserialized values are stored in an automatically created structured light model with the handle StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel.

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 modifies the state of the following input parameter:

StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control) serialized_item → (handle)

Handle of the serialized item.

StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel (output_control, state is modified) structured_light_model → (handle)

Handle of the structured light model.

Example (HDevelop)

* Deserialize the model
deserialize_structured_light_model (SerializedItemHandle, \
                                    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')

Result

The operator deserialize_structured_light_modeldeserialize_structured_light_modelDeserializeStructuredLightModelDeserializeStructuredLightModelDeserializeStructuredLightModel returns the value 2 (H_MSG_TRUE) if the given parameters are valid. Otherwise, an exception will be raised.

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem, serialize_structured_light_modelserialize_structured_light_modelSerializeStructuredLightModelSerializeStructuredLightModelSerializeStructuredLightModel

Module

3D Metrology

Operators