transform_metrology_objectT_transform_metrology_objectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object (算子)

名称

transform_metrology_objectT_transform_metrology_objectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object — 变换计量模型的计量对象，例如用于对齐。

警告

transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object 已过时，仅出于向后兼容性考虑而保留。 New applications should use the operator align_metrology_modelalign_metrology_modelAlignMetrologyModelAlignMetrologyModelAlignMetrologyModelalign_metrology_model instead.

签名

描述

transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object translates and rotates the metrology objects contained in MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle specified by the index IndexIndexIndexIndexindexindex according to the parameters RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn, and PhiPhiPhiPhiphiphi。

有关二维计量概念的说明，请参阅 二维计量 一章的引言。

The index IndexIndexIndexIndexindexindex refer to the index returned by the operators add_metrology_object_circle_measureadd_metrology_object_circle_measureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureAddMetrologyObjectCircleMeasureadd_metrology_object_circle_measure, add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measure, add_metrology_object_line_measureadd_metrology_object_line_measureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureAddMetrologyObjectLineMeasureadd_metrology_object_line_measure, or add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure。IndexIndexIndexIndexindexindex may contain a single value or a tuple of values. If all metrology objects shall be transformed, IndexIndexIndexIndexindexindex can be set to 'all'"all""all""all""all""all".

The parameter ModeModeModeModemodemode can be set to 'absolute'"absolute""absolute""absolute""absolute""absolute" or 'relative'"relative""relative""relative""relative""relative" and specifies the effect of the transformation:

ModeModeModeModemodemode = 'absolute'"absolute""absolute""absolute""absolute""absolute"：

The metrology objects are translated to the image coordinates RowRowRowRowrowrow and ColumnColumnColumnColumncolumncolumn and rotated by PhiPhiPhiPhiphiphi with respect to the image coordinate system.

For metrology objects of the type ellipse, or rectangle, the origin of the rotation is defined in the center of the metrology object as specified in the operators add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measure or add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure。For lines and circles, PhiPhiPhiPhiphiphi is ignored.

ModeModeModeModemodemode = 'relative'"relative""relative""relative""relative""relative"：

The values of the transformation are considered as relative values, i.e., they are specified relative to the previous position and rotation of the metrology object.

For metrology objects of the type ellipse, or rectangle, the origin of the rotation is defined in the center of the metrology object as specified in the operators add_metrology_object_ellipse_measureadd_metrology_object_ellipse_measureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureAddMetrologyObjectEllipseMeasureadd_metrology_object_ellipse_measure, or add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure。For lines, the starting point of the line is used as origin of the rotation. For circles, PhiPhiPhiPhiphiphi is ignored.

transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object is fastest if no rotation is defined, the original and translated measure regions both lie completely within the image. In all other cases, the measure regions have to be newly generated, which is slower.

注意

Note that any results (fitted geometric shapes) that have been generated by the operator apply_metrology_modelapply_metrology_modelApplyMetrologyModelApplyMetrologyModelApplyMetrologyModelapply_metrology_model before calling transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object are discarded during the transformation.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

此算子修改后续输入参数的状态：

• MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle

在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。

参数

结果

如果参数有效，算子 transform_metrology_objecttransform_metrology_objectTransformMetrologyObjectTransformMetrologyObjectTransformMetrologyObjecttransform_metrology_object 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。

模块

二维计量