get_metrology_object_model_contour — Query the model contour of a metrology object in image coordinates.
get_metrology_object_model_contour returns the contours for the
chosen metrology objects in image coordinates.
For an explanation of the concept of 2D metrology see the introduction of chapter 2D Metrology.
The metrology model is defined by the handle
Index specifies for which metrology objects the contours
are queried. For
Index set to 'all', the contours of all
metrology objects are returned.
The form and pose of each contour is determined by the
parameters set when adding the object using e.g.,
add_metrology_object_circle_measure, etc. If a different
reference coordinate system was set for the metrology model using
set_metrology_model_param or an alignment of the metrology model was
align_metrology_model, these values influence the
current pose of the metrology objects and thus the pose of the contours
The resolution of the returned
Resolution containing the Euclidean
distance (in pixel) between neighboring contour points. If the input value
falls below the minimal possible value (1.192e-7), the resolution is set
internally to the smallest valid value.
Handle of the metrology model.
→(integer / string)
Index of the metrology object.
Default value: 0
Suggested values: 'all', 0, 1, 2
Distance between neighboring contour points.
Default value: 1.5
Resolution >= 1.192e-7
If the parameters are valid, the operator
get_metrology_object_model_contour returns the value 2 (H_MSG_TRUE).
If necessary, an exception is raised.