create_structured_light_modelCreateStructuredLightModelCreateStructuredLightModelcreate_structured_light_modelT_create_structured_light_model

HALCON ScriptCpp++.NETPythonC

Short description

create_structured_light_modelCreateStructuredLightModelCreateStructuredLightModelcreate_structured_light_modelT_create_structured_light_model — Create a structured light model.

Signature

create_structured_light_model( string ModelType, out structured_light_model StructuredLightModel )void CreateStructuredLightModel( const HTuple& ModelType, HTuple* StructuredLightModel )static void HOperatorSet.CreateStructuredLightModel( HTuple modelType, out HTuple structuredLightModel )def create_structured_light_model( model_type: str ) -> HHandle

Herror T_create_structured_light_model( const Htuple ModelType, Htuple* StructuredLightModel )

void HStructuredLightModel::HStructuredLightModel( const HString& ModelType )

void HStructuredLightModel::HStructuredLightModel( const char* ModelType )

void HStructuredLightModel::HStructuredLightModel( const wchar_t* ModelType ) (Windows only)

public HStructuredLightModel( string modelType )

void HStructuredLightModel::CreateStructuredLightModel( const HString& ModelType )

void HStructuredLightModel::CreateStructuredLightModel( const char* ModelType )

void HStructuredLightModel::CreateStructuredLightModel( const wchar_t* ModelType ) (Windows only)

void HStructuredLightModel.CreateStructuredLightModel( string modelType )

Description

create_structured_light_modelCreateStructuredLightModel creates a new structured light model of type ModelTypemodelTypemodel_type. Currently, the types 'deflectometry'"deflectometry" and '3d_reconstruction'"3d_reconstruction" are supported.

The parameters of the structured light model can be queried with get_structured_light_model_paramGetStructuredLightModelParam and manipulated by calls to set_structured_light_model_paramSetStructuredLightModelParam.

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

Execution information

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

ModelTypemodelTypemodel_type (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

The type of the created structured light model.

Default: 'deflectometry'"deflectometry"
List of values: '3d_reconstruction', 'deflectometry'"3d_reconstruction", "deflectometry"

StructuredLightModelstructuredLightModelstructured_light_model (output_control) structured_light_model → (handle)HTuple (HHandle)HStructuredLightModel, HTuple (IntPtr)HHandleHtuple (handle)

Handle for using and accessing 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)

Result

The operator create_structured_light_modelCreateStructuredLightModel returns the value 2 (H_MSG_TRUE) if the structured light model can be allocated correctly. Otherwise, an exception will be raised.

Combinations with other operators

Combinations

Possible successors

set_structured_light_model_paramSetStructuredLightModelParam, get_structured_light_model_paramGetStructuredLightModelParam

Module

3D Metrology