read_measureT_read_measureReadMeasureReadMeasureread_measure (算子)
名称
read_measureT_read_measureReadMeasureReadMeasureread_measure — 从文件中读取测量对象。
签名
描述
read_measureread_measureReadMeasureReadMeasureReadMeasureread_measure reads a measure object, which has
been written with write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasurewrite_measure from
the file FileNameFileNameFileNameFileNamefileNamefile_name. The default HALCON file
extension for a measure object is 'msr'. The values
contained in the read measure object are stored in a measure object
with the handle MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle。
For an explanation of the concept of 1D measuring see the introduction of
chapter 一维测量。
执行信息
- 多线程类型：可重入（与非独占算子并行运行）。
- 多线程作用域：全局（可从任何线程调用）。
- 未采用并行化处理。
此算子返回一个句柄。请注意，即使该句柄被用作特定算子的输入参数，这些算子仍可能改变此句柄类型的实例状态。
参数
FileNameFileNameFileNameFileNamefileNamefile_name (输入控制) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
File name.
File extension:
.msr
MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle (输出控制) measure → HMeasure, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Measure object handle.
结果
如果参数有效，算子
read_measureread_measureReadMeasureReadMeasureReadMeasureread_measure 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。
可能的后继
measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos,
measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs
另见
write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasurewrite_measure
模块
一维计量