write_measureT_write_measureWriteMeasureWriteMeasure (Operator)
Name
write_measureT_write_measureWriteMeasureWriteMeasure — Write a measure object to a file.
Signature
Description
write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasure writes a measure object that has been
created by, e.g., gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2
to the file FileNameFileNameFileNameFileNamefileName. The measure object
is defined by the handle MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle. The measure
object can be read with read_measureread_measureReadMeasureReadMeasureReadMeasure. The default
HALCON file extension for a measure object is 'msr'.
For an explanation of the concept of 1D measuring see the introduction of
chapter 1D Measuring.
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
MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle (input_control) measure → HMeasure, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Measure object handle.
FileNameFileNameFileNameFileNamefileName (input_control) filename.write → HTupleHTupleHtuple (string) (string) (HString) (char*)
File name.
File extension: .msr
Result
If the parameters are valid, the operator
write_measurewrite_measureWriteMeasureWriteMeasureWriteMeasure returns the value 2 (H_MSG_TRUE). If
necessary, an exception is raised.
Possible Predecessors
gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2,
gen_measure_arcgen_measure_arcGenMeasureArcGenMeasureArcGenMeasureArc
See also
read_measureread_measureReadMeasureReadMeasureReadMeasure
Module
1D Metrology