get_structured_light_object — Get (intermediate) iconic results of a structured light model.
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.
Handle of the structured light model.
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.