set_metrology_model_image_sizeT_set_metrology_model_image_sizeSetMetrologyModelImageSizeSetMetrologyModelImageSize (Operator)
Name
set_metrology_model_image_sizeT_set_metrology_model_image_sizeSetMetrologyModelImageSizeSetMetrologyModelImageSize — Set the size of the image of metrology objects.
Signature
Description
set_metrology_model_image_sizeset_metrology_model_image_sizeSetMetrologyModelImageSizeSetMetrologyModelImageSizeSetMetrologyModelImageSize is used to set or change the
size of the image in which the edge detection that is related to a
metrology model will be performed.
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
image width must be specified by the parameter WidthWidthWidthWidthwidth. The image
height must specified by the parameter HeightHeightHeightHeightheight.
Attention
Note that the operator set_metrology_model_image_sizeset_metrology_model_image_sizeSetMetrologyModelImageSizeSetMetrologyModelImageSizeSetMetrologyModelImageSize should
be called before adding metrology objects to the metrology model
using the operators add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGenericAddMetrologyObjectGeneric,
add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure,
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure,
add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasure,
or add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure. Otherwise, all
measure regions of existing metrology objects will be
recomputed automatically upon calling set_metrology_model_image_sizeset_metrology_model_image_sizeSetMetrologyModelImageSizeSetMetrologyModelImageSizeSetMetrologyModelImageSize
or apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModel.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Parameters
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandle (input_control, state is modified) metrology_model → HMetrologyModel, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle of the metrology model.
WidthWidthWidthWidthwidth (input_control) extent.x → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Width of the image to be processed.
Default value: 640
Suggested values: 128, 192, 256, 512, 640, 768, 1024, 1280, 2048
Typical range of values: 0
≤
Width
Width
Width
Width
width
(lin)
Minimum increment: 1
Recommended increment: 16
HeightHeightHeightHeightheight (input_control) extent.y → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Height of the image to be processed.
Default value: 480
Suggested values: 128, 192, 256, 512, 640, 768, 1024, 1280, 2048
Typical range of values: 0
≤
Height
Height
Height
Height
height
(lin)
Minimum increment: 1
Recommended increment: 16
Result
If the parameters are valid, the operator
set_metrology_model_image_sizeset_metrology_model_image_sizeSetMetrologyModelImageSizeSetMetrologyModelImageSizeSetMetrologyModelImageSize returns the value 2 (H_MSG_TRUE).
If necessary, an exception is raised.
Possible Predecessors
create_metrology_modelcreate_metrology_modelCreateMetrologyModelCreateMetrologyModelCreateMetrologyModel
Possible Successors
set_metrology_model_paramset_metrology_model_paramSetMetrologyModelParamSetMetrologyModelParamSetMetrologyModelParam,
add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasure,
add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasure,
add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasure,
add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measure,
add_metrology_object_genericadd_metrology_object_genericAddMetrologyObjectGenericAddMetrologyObjectGenericAddMetrologyObjectGeneric
Module
2D Metrology