HALCON Website / HALCON Operator Reference / 1D Measuring
ClassesClassesClassesClasses | | | | Operators

read_measureread_measureReadMeasureread_measureReadMeasureReadMeasure (Operator)

Name

read_measureread_measureReadMeasureread_measureReadMeasureReadMeasure — Read a measure object from a file.

Signature

read_measure( : : FileName : MeasureHandle)

Herror read_measure(const char* FileName, Hlong* MeasureHandle)

Herror T_read_measure(const Htuple FileName, Htuple* MeasureHandle)

Herror read_measure(const HTuple& FileName, Hlong* MeasureHandle)

void HMeasure::ReadMeasure(const HTuple& FileName)

void ReadMeasure(const HTuple& FileName, HTuple* MeasureHandle)

void HMeasure::ReadMeasure(const HString& FileName)

void HMeasure::ReadMeasure(const char* FileName)

void HOperatorSetX.ReadMeasure(
[in] VARIANT FileName, [out] VARIANT* MeasureHandle)

void HMeasureX.ReadMeasure([in] BSTR FileName)

static void HOperatorSet.ReadMeasure(HTuple fileName, out HTuple measureHandle)

void HMeasure.ReadMeasure(string fileName)

Description

read_measureread_measureReadMeasureread_measureReadMeasureReadMeasure reads a measure object, which has been written with write_measurewrite_measureWriteMeasurewrite_measureWriteMeasureWriteMeasure from the file FileNameFileNameFileNameFileNameFileNamefileName. 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 MeasureHandleMeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle.

Parallelization

Parameters

FileNameFileNameFileNameFileNameFileNamefileName (input_control)  filename.read → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

File name.

File extension: .msr

MeasureHandleMeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandle (output_control)  measure_id → HMeasure, HTupleHTupleHMeasure, HTupleHMeasureX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Measure object handle.

Result

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

Possible Successors

measure_posmeasure_posMeasurePosmeasure_posMeasurePosMeasurePos, measure_pairsmeasure_pairsMeasurePairsmeasure_pairsMeasurePairsMeasurePairs

See also

write_measurewrite_measureWriteMeasurewrite_measureWriteMeasureWriteMeasure

Module

1D Metrology

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH