clear_structured_light_modelclear_structured_light_modelClearStructuredLightModelClearStructuredLightModel (Operator)

Name

clear_structured_light_modelclear_structured_light_modelClearStructuredLightModelClearStructuredLightModel — Clear a structured light model and free the allocated memory.

Signature

clear_structured_light_model( : : StructuredLightModel : )

Description

The operator clear_structured_light_modelclear_structured_light_modelClearStructuredLightModelClearStructuredLightModelClearStructuredLightModel deletes a structured light model that was created by create_structured_light_modelcreate_structured_light_modelCreateStructuredLightModelCreateStructuredLightModelCreateStructuredLightModel. All memory used by the model is freed. The handle of the model is passed in StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel. It is invalid after the operator call.

For an explanation of the concept of structured light and its supported applications, see the introduction of chapter Inspection / Structured Light.

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

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel (input_control, state is modified) structured_light_model(-array) → (integer)

Handle of the structured light model.

Example (HDevelop)

* Create the model
create_structured_light_model ('deflectometry', StructuredLightModel)
* Generate the patterns to project
gen_structured_light_pattern (PatternImages, StructuredLightModel)
* Decode the camera images
decode_structured_light_pattern (CameraImages, StructuredLightModel)
* Clean up
clear_structured_light_model (StructuredLightModel)

The operator clear_structured_light_modelclear_structured_light_modelClearStructuredLightModelClearStructuredLightModelClearStructuredLightModel returns the value 2 (H_MSG_TRUE) if a valid handle is passed and the referred structured light model can be freed correctly. Otherwise, an exception will be raised.

Module

3D Metrology

Operators