write_measurewrite_measureWriteMeasureWriteMeasure (Operator)

Name

write_measurewrite_measureWriteMeasureWriteMeasure — Write a measure object to a file.

Signature

write_measure( : : MeasureHandle, FileName : )

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_id → (integer)

Measure object handle.

FileNameFileNameFileNameFileNamefileName (input_control) filename.write → (string)

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

Module

1D Metrology

Operators