get_structured_light_object — Get (intermediate) iconic results of a structured light model.
get_structured_light_object( : Object : StructuredLightModel, ObjectName : )
With the operator get_structured_light_object you can
access and inspect (intermediate) iconic results of a structured light
measurement setup that has already been decoded using
decode_structured_light_pattern.
On the one hand, this is useful to query the results of the decoding process
('correspondence_image') together with further processed results
i.e. the defect image ('defect_image').
On the other hand, get_structured_light_object is also useful for
troubleshooting the decoding process.
Note that to collect the intermediate results, the 'persistence'
mode has to be enabled for the StructuredLightModel
(see set_structured_light_model_param) before
decoding the model.
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.
Segmented region in which the camera images have been decoded. This region is identical to the domain of the correspondence images.
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.
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.
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' was set
to 'inverted_pattern' using
set_structured_light_model_param, this refers to the first image
of an inverted pair.
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'.
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' is set to 'single_stripe'.
Correspondence image computed solely from the Gray code images. If 'pattern_type' is set to 'gray_code_and_phase_shift', the actual correspondence image is a combination of this image with the decoded phase shift images. If 'pattern_type' is set to 'single_stripe', the actual correspondence image is a combination of this image with the decoded phase shift images and the decoded single stripe images.
Object (output_object) (multichannel-)object(-array) → object
Iconic result.
StructuredLightModel (input_control) structured_light_model → (handle)
Handle of the structured light model.
ObjectName (input_control) string(-array) → (string)
Name of the iconic result to be returned.
Default value: 'correspondence_image'
Suggested values: 'correspondence_image', 'pattern_region', 'decoded_single_stripe_image', 'binarized_image', 'decoded_phase_shift_image', 'gray_code_correspondence_image', 'defect_image'
* 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')
The operator get_structured_light_object returns the value
2 (H_MSG_TRUE) if the given parameters are valid. Otherwise, an exception will be
raised.
decode_structured_light_pattern
3D Metrology