translate_measure ( : : MeasureHandle, Row, Column : )

Translate a measure object.

translate_measure translates the reference point of the measure object given by MeasureHandle to the point (Row,Column). If the measure object and the translated measure object lie completely within the image, the measure object is shifted to the new reference point in an efficient manner. Otherwise, the measure object is generated anew with gen_measure_rectangle2 or gen_measure_arc using the parameters that were specified when the measure object was created and the new reference point.


Parameters

MeasureHandle (input_control)
measure_id -> integer
Measure object handle.

Row (input_control)
point.y -> real / integer
Row coordinate of the new reference point.
Default value: 50.0
Suggested values: 10.0, 20.0, 50.0, 100.0, 200.0, 300.0, 400.0, 500.0
Typical range of values: 0.0 <= Row <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0

Column (input_control)
point.x -> real / integer
Column coordinate of the new reference point.
Default value: 100.0
Suggested values: 10.0, 20.0, 50.0, 100.0, 200.0, 300.0, 400.0, 500.0
Typical range of values: 0.0 <= Column <= 511.0 (lin)
Minimum increment: 1.0
Recommended increment: 10.0


Result

If the parameter values are correct the operator translate_measure returns the value 2 (H_MSG_TRUE). Otherwise an exception handling is raised.


Parallelization Information

translate_measure is reentrant and processed without parallelization.


Possible Predecessors

gen_measure_rectangle2, gen_measure_arc


Possible Successors

measure_pos, measure_pairs, fuzzy_measure_pos, fuzzy_measure_pairs, fuzzy_measure_pairing, measure_thresh


Alternatives

gen_measure_rectangle2, gen_measure_arc


See also

close_measure


Module

1D Metrology



Copyright © 1996-2008 MVTec Software GmbH