Skip to content

write_measureWriteMeasureWriteMeasurewrite_measureT_write_measure🔗

Short description🔗

write_measureWriteMeasureWriteMeasurewrite_measureT_write_measure — Write a measure object to a file.

Signature🔗

write_measure( measure MeasureHandle, filename.write FileName )void WriteMeasure( const HTuple& MeasureHandle, const HTuple& FileName )static void HOperatorSet.WriteMeasure( HTuple measureHandle, HTuple fileName )def write_measure( measure_handle: HHandle, file_name: str ) -> None

Herror T_write_measure( const Htuple MeasureHandle, const Htuple FileName )

void HMeasure::WriteMeasure( const HString& FileName ) const

void HMeasure::WriteMeasure( const char* FileName ) const

void HMeasure::WriteMeasure( const wchar_t* FileName ) const (Windows only)

void HMeasure.WriteMeasure( string fileName )

Description🔗

write_measureWriteMeasure writes a measure object that has been created by, e.g., gen_measure_rectangle2GenMeasureRectangle2 to the file FileNamefileNamefile_name. The measure object is defined by the handle MeasureHandlemeasureHandlemeasure_handle. The measure object can be read with read_measureReadMeasure. 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🔗

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🔗

MeasureHandlemeasureHandlemeasure_handle (input_control) measure → (handle)HTuple (HHandle)HMeasure, HTuple (IntPtr)HHandleHtuple (handle)

Measure object handle.

FileNamefileNamefile_name (input_control) filename.write → (string)HTuple (HString)HTuple (string)strHtuple (char*)

File name.

File extension: .msr

Result🔗

If the parameters are valid, the operator write_measureWriteMeasure returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

gen_measure_rectangle2GenMeasureRectangle2, gen_measure_arcGenMeasureArc

See also

read_measureReadMeasure

Module🔗

1D Metrology