ClassesClassesClassesClasses | | | | Operators

get_metrology_object_model_contourget_metrology_object_model_contourGetMetrologyObjectModelContourget_metrology_object_model_contourGetMetrologyObjectModelContourGetMetrologyObjectModelContour (Operator)

Name

get_metrology_object_model_contourget_metrology_object_model_contourGetMetrologyObjectModelContourget_metrology_object_model_contourGetMetrologyObjectModelContourGetMetrologyObjectModelContour — Query the model contour of a metrology object in image coordinates.

Signature

get_metrology_object_model_contour( : Contour : MetrologyHandle, Index, Resolution : )

Herror get_metrology_object_model_contour(Hobject* Contour, const Hlong MetrologyHandle, const Hlong Index, double Resolution)

Herror T_get_metrology_object_model_contour(Hobject* Contour, const Htuple MetrologyHandle, const Htuple Index, const Htuple Resolution)

Herror get_metrology_object_model_contour(Hobject* Contour, const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Resolution)

HXLDContArray HMetrologyModel::GetMetrologyObjectModelContour(const HTuple& Index, const HTuple& Resolution) const

void GetMetrologyObjectModelContour(HObject* Contour, const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Resolution)

HXLDCont HMetrologyModel::GetMetrologyObjectModelContour(const HTuple& Index, double Resolution) const

HXLDCont HMetrologyModel::GetMetrologyObjectModelContour(Hlong Index, double Resolution) const

void HOperatorSetX.GetMetrologyObjectModelContour(
[out] IHUntypedObjectX*Contour, [in] VARIANT MetrologyHandle, [in] VARIANT Index, [in] VARIANT Resolution)

IHXLDContX* HMetrologyModelX.GetMetrologyObjectModelContour(
[in] VARIANT Index, [in] double Resolution)

static void HOperatorSet.GetMetrologyObjectModelContour(out HObject contour, HTuple metrologyHandle, HTuple index, HTuple resolution)

HXLDCont HMetrologyModel.GetMetrologyObjectModelContour(HTuple index, double resolution)

HXLDCont HMetrologyModel.GetMetrologyObjectModelContour(int index, double resolution)

Description

get_metrology_object_model_contourget_metrology_object_model_contourGetMetrologyObjectModelContourget_metrology_object_model_contourGetMetrologyObjectModelContourGetMetrologyObjectModelContour 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 MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle. The parameter IndexIndexIndexIndexIndexindex specifies for which metrology objects the contours are queried. For IndexIndexIndexIndexIndexindex set to 'all'"all""all""all""all""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_genericadd_metrology_object_genericAddMetrologyObjectGenericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGeneric, add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure, etc. If a different reference coordinate system was set for the metrology model using set_metrology_model_paramset_metrology_model_paramSetMetrologyModelParamset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParam or an alignment of the metrology model was performed using align_metrology_modelalign_metrology_modelAlignMetrologyModelalign_metrology_modelAlignMetrologyModelAlignMetrologyModel, these values influence the current pose of the metrology objects and thus the pose of the contours returned in ContourContourContourContourContourcontour.

The resolution of the returned ContourContourContourContourContourcontour is controlled via ResolutionResolutionResolutionResolutionResolutionresolution 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.

Parallelization

Parameters

ContourContourContourContourContourcontour (output_object)  xld_cont(-array) objectHXLDContHXLDContHXLDContHXLDContXHobject *

Model contour.

MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control)  metrology_model HMetrologyModel, HTupleHTupleHMetrologyModel, HTupleHMetrologyModelX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle of the metrology model.

IndexIndexIndexIndexIndexindex (input_control)  integer(-array) HTupleHTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*) (Hlong / BSTR) (Hlong / char*)

Index of the metrology object.

Default value: 'all' "all" "all" "all" "all" "all"

Suggested values: 'all'"all""all""all""all""all", 0, 1, 2

ResolutionResolutionResolutionResolutionResolutionresolution (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Distance between neighboring contour points.

Default value: 1.5

Restriction: Resolution >= 1.192e-7

Result

If the parameters are valid, the operator get_metrology_object_model_contourget_metrology_object_model_contourGetMetrologyObjectModelContourget_metrology_object_model_contourGetMetrologyObjectModelContourGetMetrologyObjectModelContour returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGeneric, add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure, add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure, add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure, add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasure

Possible Successors

apply_metrology_modelapply_metrology_modelApplyMetrologyModelapply_metrology_modelApplyMetrologyModelApplyMetrologyModel

See also

set_metrology_model_paramset_metrology_model_paramSetMetrologyModelParamset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParam, get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures, align_metrology_modelalign_metrology_modelAlignMetrologyModelalign_metrology_modelAlignMetrologyModelAlignMetrologyModel

Module

2D Metrology


ClassesClassesClassesClasses | | | | Operators