get_structured_light_objectT_get_structured_light_objectGetStructuredLightObjectGetStructuredLightObject (Operator)

Name

get_structured_light_objectT_get_structured_light_objectGetStructuredLightObjectGetStructuredLightObject — Get (intermediate) iconic results of a structured light model.

Signature

get_structured_light_object( : Object : StructuredLightModel, ObjectName : )

Herror T_get_structured_light_object(Hobject* Object, const Htuple StructuredLightModel, const Htuple ObjectName)

void GetStructuredLightObject(HObject* Object, const HTuple& StructuredLightModel, const HTuple& ObjectName)

HObject HStructuredLightModel::GetStructuredLightObject(const HTuple& ObjectName) const

HObject HStructuredLightModel::GetStructuredLightObject(const HString& ObjectName) const

HObject HStructuredLightModel::GetStructuredLightObject(const char* ObjectName) const

HObject HStructuredLightModel::GetStructuredLightObject(const wchar_t* ObjectName) const   (Windows only)

static void HOperatorSet.GetStructuredLightObject(out HObject objectVal, HTuple structuredLightModel, HTuple objectName)

HObject HStructuredLightModel.GetStructuredLightObject(HTuple objectName)

HObject HStructuredLightModel.GetStructuredLightObject(string objectName)

Description

With the operator get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectGetStructuredLightObject you can access and inspect (intermediate) iconic results of a structured light measurement setup that has already been decoded using decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPattern.

On the one hand, this is useful to query the results of the decoding process ('correspondence_image'"correspondence_image""correspondence_image""correspondence_image""correspondence_image") together with further processed results i.e. the defect image ('defect_image'"defect_image""defect_image""defect_image""defect_image"). On the other hand, get_structured_light_objectget_structured_light_objectGetStructuredLightObjectGetStructuredLightObjectGetStructuredLightObject is also useful for troubleshooting the decoding process. Note that to collect the intermediate results, the 'persistence'"persistence""persistence""persistence""persistence" mode has to be enabled for the StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel (see set_structured_light_model_paramset_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamSetStructuredLightModelParam) before decoding the model.

Objects that can be accessed without persistence mode enabled:

'correspondence_image'"correspondence_image""correspondence_image""correspondence_image""correspondence_image":

Image that describes the correspondences between the monitor and the camera. If the decoding has been performed in vertical and horizontal direction, both correspondence images are returned in an array. Otherwise, only the image of the appropriate direction is returned.

'pattern_region'"pattern_region""pattern_region""pattern_region""pattern_region":

Segmented region in which the camera images have been decoded. This region is identical to the domain of the correspondence images.

'defect_image'"defect_image""defect_image""defect_image""defect_image":

Image that describes possible defects on the surface which reflects the projected patterns towards the camera. Basically, high gray values in the defect image indicate that the gradients of the correspondence images differ significantly from gradients in the neighborhood.

Objects that can be accessed only when in persistence mode:

If the decoding has been performed in vertical and horizontal direction, images of both directions are returned in an array. Otherwise, only the images of the appropriate direction are returned.

'binarized_image'"binarized_image""binarized_image""binarized_image""binarized_image":

Images of the Gray code sequence where white and black gray values indicate that the camera pixel observed reflections of white or black regions of the projected patterns. If 'normalization'"normalization""normalization""normalization""normalization" was set to 'inverted_pattern'"inverted_pattern""inverted_pattern""inverted_pattern""inverted_pattern" using set_structured_light_model_paramset_structured_light_model_paramSetStructuredLightModelParamSetStructuredLightModelParamSetStructuredLightModelParam, this refers to the first image of an inverted pair.

'decoded_phase_shift_image'"decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image":

Decoded phase shift images containing the phase or angle corresponding to the projected phase images. One phase period covers stripes in the projected pattern of an extent 'min_stripe_width'"min_stripe_width""min_stripe_width""min_stripe_width""min_stripe_width".

'decoded_single_stripe_image'"decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image":

Decoded single stripe image computed solely from the single stripe images. The correspondence image is a combination of this image with the Gray code and phase shift images, if 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type" is set to 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe".

'gray_code_correspondence_image'"gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image":

Correspondence image computed solely from the Gray code images. If 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type" is set to 'gray_code_and_phase_shift'"gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift""gray_code_and_phase_shift", the actual correspondence image is a combination of this image with the decoded phase shift images. If 'pattern_type'"pattern_type""pattern_type""pattern_type""pattern_type" is set to 'single_stripe'"single_stripe""single_stripe""single_stripe""single_stripe", the actual correspondence image is a combination of this image with the decoded phase shift images and the decoded single stripe images.

Execution Information

Parameters

ObjectObjectObjectObjectobjectVal (output_object)  (multichannel-)object(-array) objectHObjectHObjectHobject *

Iconic result.

StructuredLightModelStructuredLightModelStructuredLightModelStructuredLightModelstructuredLightModel (input_control)  structured_light_model HStructuredLightModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the structured light model.

ObjectNameObjectNameObjectNameObjectNameobjectName (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the iconic result to be returned.

Default value: 'correspondence_image' "correspondence_image" "correspondence_image" "correspondence_image" "correspondence_image"

Suggested values: 'correspondence_image'"correspondence_image""correspondence_image""correspondence_image""correspondence_image", 'pattern_region'"pattern_region""pattern_region""pattern_region""pattern_region", 'decoded_single_stripe_image'"decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image""decoded_single_stripe_image", 'binarized_image'"binarized_image""binarized_image""binarized_image""binarized_image", 'decoded_phase_shift_image'"decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image""decoded_phase_shift_image", 'gray_code_correspondence_image'"gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image""gray_code_correspondence_image", 'defect_image'"defect_image""defect_image""defect_image""defect_image"

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)
* Get the computed correspondences and defects
get_structured_light_object (CorrespondenceImages, StructuredLightModel, \
                             'correspondence_image')
set_structured_light_model_param (StructuredLightModel, \
                                  'derivative_sigma', Sigma)
get_structured_light_object (DefectImage, StructuredLightModel, \
                             'defect_image')

Result

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

Possible Predecessors

decode_structured_light_patterndecode_structured_light_patternDecodeStructuredLightPatternDecodeStructuredLightPatternDecodeStructuredLightPattern

Possible Successors

clear_structured_light_modelclear_structured_light_modelClearStructuredLightModelClearStructuredLightModelClearStructuredLightModel

See also

gen_structured_light_patterngen_structured_light_patternGenStructuredLightPatternGenStructuredLightPatternGenStructuredLightPattern

Module

3D Metrology