translate_measureT_translate_measureTranslateMeasureTranslateMeasuretranslate_measure (Operator)

Name

translate_measureT_translate_measureTranslateMeasureTranslateMeasuretranslate_measure — Translate a measure object.

Signature

translate_measure( : : MeasureHandle, Row, Column : )

Herror T_translate_measure(const Htuple MeasureHandle, const Htuple Row, const Htuple Column)

void TranslateMeasure(const HTuple& MeasureHandle, const HTuple& Row, const HTuple& Column)

void HMeasure::TranslateMeasure(const HTuple& Row, const HTuple& Column) const

void HMeasure::TranslateMeasure(double Row, double Column) const

static void HOperatorSet.TranslateMeasure(HTuple measureHandle, HTuple row, HTuple column)

void HMeasure.TranslateMeasure(HTuple row, HTuple column)

void HMeasure.TranslateMeasure(double row, double column)

def translate_measure(measure_handle: HHandle, row: Union[int, float], column: Union[int, float]) -> None

Description

translate_measuretranslate_measureTranslateMeasureTranslateMeasureTranslateMeasuretranslate_measure translates the reference point of the measure object given by MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle to the point (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn). 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_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2gen_measure_rectangle2 or gen_measure_arcgen_measure_arcGenMeasureArcGenMeasureArcGenMeasureArcgen_measure_arc using the parameters that were specified when the measure object was created and the new reference point.

For an explanation of the concept of 1D measuring see the introduction of chapter 1D Measuring.

Execution Information

This operator modifies the state of the following input parameter:

During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.

Parameters

MeasureHandleMeasureHandleMeasureHandleMeasureHandlemeasureHandlemeasure_handle (input_control, state is modified)  measure HMeasure, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Measure object handle.

RowRowRowRowrowrow (input_control)  point.y HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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 Row Row Row row row ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

ColumnColumnColumnColumncolumncolumn (input_control)  point.x HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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 Column Column Column column column ≤ 511.0 (lin)

Minimum increment: 1.0

Recommended increment: 10.0

Result

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

Possible Predecessors

gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2gen_measure_rectangle2, gen_measure_arcgen_measure_arcGenMeasureArcGenMeasureArcGenMeasureArcgen_measure_arc

Possible Successors

measure_posmeasure_posMeasurePosMeasurePosMeasurePosmeasure_pos, measure_pairsmeasure_pairsMeasurePairsMeasurePairsMeasurePairsmeasure_pairs, fuzzy_measure_posfuzzy_measure_posFuzzyMeasurePosFuzzyMeasurePosFuzzyMeasurePosfuzzy_measure_pos, fuzzy_measure_pairsfuzzy_measure_pairsFuzzyMeasurePairsFuzzyMeasurePairsFuzzyMeasurePairsfuzzy_measure_pairs, fuzzy_measure_pairingfuzzy_measure_pairingFuzzyMeasurePairingFuzzyMeasurePairingFuzzyMeasurePairingfuzzy_measure_pairing, measure_threshmeasure_threshMeasureThreshMeasureThreshMeasureThreshmeasure_thresh

Alternatives

gen_measure_rectangle2gen_measure_rectangle2GenMeasureRectangle2GenMeasureRectangle2GenMeasureRectangle2gen_measure_rectangle2, gen_measure_arcgen_measure_arcGenMeasureArcGenMeasureArcGenMeasureArcgen_measure_arc

See also

close_measureclose_measureCloseMeasureCloseMeasureCloseMeasureclose_measure

Module

1D Metrology