get_metrology_object_result_contourT_get_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContour (Operator)
Name
get_metrology_object_result_contourT_get_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContour — Query the result contour of a metrology object.
Signature
void GetMetrologyObjectResultContour(HObject* Contour, const HTuple& MetrologyHandle, const HTuple& Index, const HTuple& Instance, const HTuple& Resolution)
HXLDCont HMetrologyModel::GetMetrologyObjectResultContour(const HTuple& Index, const HTuple& Instance, double Resolution) const
HXLDCont HMetrologyModel::GetMetrologyObjectResultContour(Hlong Index, const HString& Instance, double Resolution) const
HXLDCont HMetrologyModel::GetMetrologyObjectResultContour(Hlong Index, const char* Instance, double Resolution) const
HXLDCont HMetrologyModel::GetMetrologyObjectResultContour(Hlong Index, const wchar_t* Instance, double Resolution) const
(Windows only)
Description
get_metrology_object_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContourGetMetrologyObjectResultContour returns for the chosen
metrology objects and object instances, the result contours of a measurement
performed by apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel 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 MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle.
The parameter IndexIndexIndexIndexindex specifies for which metrology objects the
result contours are queried. For IndexIndexIndexIndexindex set to 'all'"all""all""all""all", the
result contours of all metrology objects are returned. If
for a metrology object several results (instances) were computed,
then the parameter InstanceInstanceInstanceInstanceinstance specifies, for which instances
the result contours are returned in ContourContourContourContourcontour.
The result contours for all instances are obtained by setting
InstanceInstanceInstanceInstanceinstance to 'all'"all""all""all""all".
The resolution of the resulting contour ContourContourContourContourcontour is
controlled via ResolutionResolutionResolutionResolutionresolution containing the Euclidean
distance between neighboring contour points in pixel.
If the input value falls below
the minimal possible value (1.192e-7), then the resolution is set internally
to the smallest valid value.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
ContourContourContourContourcontour (output_object) xld_cont(-array) → objectHXLDContHXLDContHobject *
Result contour for the given metrology object.
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control) metrology_model → HMetrologyModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the metrology model.
IndexIndexIndexIndexindex (input_control) integer(-array) → HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
Index of the metrology object.
Default value: 0
Suggested values: 'all'"all""all""all""all", 0, 1, 2
InstanceInstanceInstanceInstanceinstance (input_control) integer(-array) → HTupleHTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Instance of the metrology object.
Default value:
'all'
"all"
"all"
"all"
"all"
Suggested values: 'all'"all""all""all""all", 0, 1, 2
ResolutionResolutionResolutionResolutionresolution (input_control) real → HTupleHTupleHtuple (real) (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_result_contourget_metrology_object_result_contourGetMetrologyObjectResultContourGetMetrologyObjectResultContourGetMetrologyObjectResultContour returns the value 2 (H_MSG_TRUE).
If necessary, an exception is raised.
Possible Predecessors
apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel
See also
get_metrology_object_resultget_metrology_object_resultGetMetrologyObjectResultGetMetrologyObjectResultGetMetrologyObjectResult,
get_metrology_object_measuresget_metrology_object_measuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasuresGetMetrologyObjectMeasures
Module
2D Metrology