Operator Reference

HALCON Operator Reference / Inspection / Structured Light
ClassesClasses | | Operators

deserialize_structured_light_modelT_deserialize_structured_light_modelDeserializeStructuredLightModelDeserializeStructuredLightModeldeserialize_structured_light_model (Operator)

deserialize_structured_light_modelT_deserialize_structured_light_modelDeserializeStructuredLightModelDeserializeStructuredLightModeldeserialize_structured_light_model — Deserialize a structured light model.

Signature

deserialize_structured_light_model( : : SerializedItemHandle : StructuredLightModel)

Herror T_deserialize_structured_light_model(const Htuple SerializedItemHandle, Htuple* StructuredLightModel)

void DeserializeStructuredLightModel(const HTuple& SerializedItemHandle, HTuple* StructuredLightModel)

void HStructuredLightModel::DeserializeStructuredLightModel(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeStructuredLightModel(HTuple serializedItemHandle, out HTuple structuredLightModel)

void HStructuredLightModel.DeserializeStructuredLightModel(HSerializedItem serializedItemHandle)

def deserialize_structured_light_model(serialized_item_handle: HHandle) -> HHandle

Description

deserialize_structured_light_modeldeserialize_structured_light_modelDeserializeStructuredLightModelDeserializeStructuredLightModeldeserialize_structured_light_model deserializes a structured light model that was serialized by serialize_structured_light_modelserialize_structured_light_modelSerializeStructuredLightModelSerializeStructuredLightModelserialize_structured_light_model (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item for an introduction of the basic principle of serialization). The serialized structured light model is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle. The deserialized values are stored in an automatically created structured light model with the handle StructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModelstructured_light_model.

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:

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

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (input_control)  serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

StructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModelstructured_light_model (output_control, state is modified)  structured_light_model → HStructuredLightModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (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_modelDeserializeStructuredLightModelDeserializeStructuredLightModeldeserialize_structured_light_model 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_itemFreadSerializedItemFreadSerializedItemfread_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item, serialize_structured_light_modelserialize_structured_light_modelSerializeStructuredLightModelSerializeStructuredLightModelserialize_structured_light_model

See also

create_structured_light_modelcreate_structured_light_modelCreateStructuredLightModelCreateStructuredLightModelcreate_structured_light_model, write_structured_light_modelwrite_structured_light_modelWriteStructuredLightModelWriteStructuredLightModelwrite_structured_light_model, serialize_structured_light_modelserialize_structured_light_modelSerializeStructuredLightModelSerializeStructuredLightModelserialize_structured_light_model

Module

3D Metrology

ClassesClasses | | Operators