distance_scDistanceScDistanceScdistance_scdistance_sc

HALCON ScriptCpp++.NETPythonC

Short description

distance_scDistanceScDistanceScdistance_scdistance_sc — Calculate the distance between a line segment and one contour.

Signature

distance_sc( xld_cont Contour, point.y Row1, point.x Column1, point.y Row2, point.x Column2, out real DistanceMin, out real DistanceMax )void DistanceSc( const HObject& Contour, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, HTuple* DistanceMin, HTuple* DistanceMax )static void HOperatorSet.DistanceSc( HObject contour, HTuple row1, HTuple column1, HTuple row2, HTuple column2, out HTuple distanceMin, out HTuple distanceMax )def distance_sc( contour: HObject, row_1: MaybeSequence[Union[float, int]], column_1: MaybeSequence[Union[float, int]], row_2: MaybeSequence[Union[float, int]], column_2: MaybeSequence[Union[float, int]] ) -> Tuple[Sequence[float], Sequence[float]]

def distance_sc_s( contour: HObject, row_1: MaybeSequence[Union[float, int]], column_1: MaybeSequence[Union[float, int]], row_2: MaybeSequence[Union[float, int]], column_2: MaybeSequence[Union[float, int]] ) -> Tuple[float, float]Herror distance_sc( const Hobject Contour, double Row1, double Column1, double Row2, double Column2, double* DistanceMin, double* DistanceMax )

Herror T_distance_sc( const Hobject Contour, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2, Htuple* DistanceMin, Htuple* DistanceMax )

void HXLDCont::DistanceSc( const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, HTuple* DistanceMin, HTuple* DistanceMax ) const

void HXLDCont::DistanceSc( double Row1, double Column1, double Row2, double Column2, double* DistanceMin, double* DistanceMax ) const

void HXLDCont.DistanceSc( HTuple row1, HTuple column1, HTuple row2, HTuple column2, out HTuple distanceMin, out HTuple distanceMax )

void HXLDCont.DistanceSc( double row1, double column1, double row2, double column2, out double distanceMin, out double distanceMax )

Description

The operator distance_scDistanceSc calculates the distance between a line segment and the line segments of a contour. Row1row1row_1, Column1column1column_1, Row2row2row_2, Column2column2column_2 are the start and end coordinates of a line segment, Contourcontourcontour represents the input contour. The parameters DistanceMindistanceMindistance_min and DistanceMaxdistanceMaxdistance_max contain the resulting distances.

Parameter Broadcasting

This operator supports parameter broadcasting. This means that each parameter can be given as a tuple of length 1 or N. Parameters with tuple length 1 will be repeated internally such that the number of distances is always N.

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

Contourcontourcontour (input_object) xld_cont(-array) → objectHObjectHXLDContHObjectHobject

Input contour.

Row1row1row_1 (input_control) point.y(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate of the first point of the line segment.

Column1column1column_1 (input_control) point.x(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate of the first point of the line segment.

Row2row2row_2 (input_control) point.y(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate of the second point of the line segment.

Column2column2column_2 (input_control) point.x(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate of the second point of the line segment.

DistanceMindistanceMindistance_min (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Minimum distance between the line segment and the contour.

DistanceMaxdistanceMaxdistance_max (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Maximum distance between the line segment and the contour.

Result

distance_srDistanceSr returns 2 (H_MSG_TRUE).

Combinations with other operators

Combinations

Alternatives

distance_lcDistanceLc, distance_pcDistancePc, distance_ccDistanceCc, distance_cc_minDistanceCcMin

See also

distance_srDistanceSr, distance_lrDistanceLr, distance_prDistancePr, select_xld_pointSelectXldPoint, test_xld_pointTestXldPoint

Module

Foundation