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. The metrology model is defined by the handle MetrologyHandle. The parameter 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_generic, 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 performed using align_metrology_model, these values influence the current pose of the metrology objects and thus the pose of the contours returned in Contour.
The resolution of the returned Contour is controlled via 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.
Index of the metrology object.
Default value: 'all'
Suggested values: 'all', 0, 1, 2
Distance between neighboring contour points.
Default value: 1.5
Restriction: 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.
add_metrology_object_generic, add_metrology_object_circle_measure, add_metrology_object_ellipse_measure, add_metrology_object_rectangle2_measure, add_metrology_object_line_measure
set_metrology_model_param, get_metrology_object_measures, align_metrology_model