clear_metrology_objectT_clear_metrology_objectClearMetrologyObjectClearMetrologyObjectclear_metrology_object清除计量对象(算子)
名称
clear_metrology_objectT_clear_metrology_objectClearMetrologyObjectClearMetrologyObjectclear_metrology_object — 删除计量对象并释放分配的内存。
签名
描述
clear_metrology_objectclear_metrology_objectClearMetrologyObjectClearMetrologyObjectClearMetrologyObjectclear_metrology_object 用于删除计量模型中创建的计量对象,例如通过
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 或
add_metrology_object_rectangle2_measureadd_metrology_object_rectangle2_measureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2MeasureAddMetrologyObjectRectangle2Measureadd_metrology_object_rectangle2_measure 创建的对象。
有关二维计量概念的说明,请参阅 二维计量 一章的引言。
计量对象使用的所有内存均被释放。计量模型的句柄通过 MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle 传递。计量对象的索引通过 IndexIndexIndexIndexindexindex 传递。若 IndexIndexIndexIndexindexindex 设置为 'all'"all""all""all""all""all",则删除所有计量对象。算子调用后,计量对象将失效。
执行信息
- 多线程类型:可重入(与非独占算子并行运行)。
- 多线程作用域:全局(可从任何线程调用)。
- 未采用并行化处理。
此算子修改后续输入参数的状态:
在执行此算子时,若该参数值需在多个线程间使用,则必须对其访问进行同步。
参数
MetrologyHandleMetrologyHandleMetrologyHandleMetrologyHandlemetrologyHandlemetrology_handle (输入控制,状态被修改) metrology_model → HMetrologyModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
计量模型的句柄。
IndexIndexIndexIndexindexindex (输入控制) integer(-array) → HTupleMaybeSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
计量对象的索引。
默认值:
'all'
"all"
"all"
"all"
"all"
"all"
建议值:
'all'"all""all""all""all""all", 0, 1, 2
结果
如果参数有效,算子 clear_metrology_objectclear_metrology_objectClearMetrologyObjectClearMetrologyObjectClearMetrologyObjectclear_metrology_object 返回值 2 (H_MSG_TRUE)。如有必要,则抛出异常。
模块
二维计量