Skip to content

dist_rectangle2_contour_points_xlddist_rectangle2_contour_points_xldDistRectangle2ContourPointsXldDistRectangle2ContourPointsXlddist_rectangle2_contour_points_xldT_dist_rectangle2_contour_points_xld🔗

Short description🔗

dist_rectangle2_contour_points_xlddist_rectangle2_contour_points_xldDistRectangle2ContourPointsXldDistRectangle2ContourPointsXlddist_rectangle2_contour_points_xldT_dist_rectangle2_contour_points_xld — Compute the distances of all contour points to a rectangle.

Signature🔗

dist_rectangle2_contour_points_xld( xld_cont Contour, integer ClippingEndPoints, rectangle2.center.y Row, rectangle2.center.x Column, rectangle2.angle.rad Phi, rectangle2.hwidth Length1, rectangle2.hheight Length2, out real Distances )dist_rectangle2_contour_points_xld( Contour : : ClippingEndPoints, Row, Column, Phi, Length1, Length2 : Distances )void DistRectangle2ContourPointsXld( const HObject& Contour, const HTuple& ClippingEndPoints, const HTuple& Row, const HTuple& Column, const HTuple& Phi, const HTuple& Length1, const HTuple& Length2, HTuple* Distances )static void HOperatorSet.DistRectangle2ContourPointsXld( HObject contour, HTuple clippingEndPoints, HTuple row, HTuple column, HTuple phi, HTuple length1, HTuple length2, out HTuple distances )def dist_rectangle2_contour_points_xld( contour: HObject, clipping_end_points: int, row: float, column: float, phi: float, length_1: float, length_2: float ) -> Sequence[float]

Herror T_dist_rectangle2_contour_points_xld( const Hobject Contour, const Htuple ClippingEndPoints, const Htuple Row, const Htuple Column, const Htuple Phi, const Htuple Length1, const Htuple Length2, Htuple* Distances )

HTuple HXLDCont::DistRectangle2ContourPointsXld( Hlong ClippingEndPoints, double Row, double Column, double Phi, double Length1, double Length2 ) const

HTuple HXLDCont.DistRectangle2ContourPointsXld( int clippingEndPoints, double row, double column, double phi, double length1, double length2 )

Description🔗

dist_rectangle2_contour_points_xldDistRectangle2ContourPointsXld determines the Euclidean distances between the points of a contour Contourcontourcontour and a rectangle of arbitrary orientation specified by the center (Rowrowrow, Columncolumncolumn), the orientation Phiphiphi, and the half edge lengths Length1length1length_1 and Length2length2length_2. The angle Phiphiphi must be given in radians and specifies the angle between the horizontal axis and the edge with the half length Length1length1length_1 in the mathematically positive direction (counterclockwise).

Depending on the processing used to create Contourcontourcontour, the start and end points of a contour may contain positional errors. In this case, the operator fit_rectangle2_contour_xldFitRectangle2ContourXld is typically called with the parameter ClippingEndPointsclippingEndPointsclipping_end_points set to a value greater than zero to exclude points at the beginning and the end of the contour from the computation. To compute the distances of the same set of points as used in the fitting process, ClippingEndPointsclippingEndPointsclipping_end_points should be set to the same value as in fit_rectangle2_contour_xldFitRectangle2ContourXld.

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 → objectobjectHObjectHXLDContHObjectHobject

Input contour.

ClippingEndPointsclippingEndPointsclipping_end_points (input_control) integer → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Number of points at the beginning and the end of the contours to be ignored for the computation of distances.

Default: 00
Suggested values: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 100, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
Restriction: ClippingEndPoints >= 0

Rowrowrow (input_control) rectangle2.center.y → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Row coordinate of the center of the rectangle.

Columncolumncolumn (input_control) rectangle2.center.x → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Column coordinate of the center of the rectangle.

Phiphiphi (input_control) rectangle2.angle.rad → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Orientation of the main axis of the rectangle [rad].

Length1length1length_1 (input_control) rectangle2.hwidth → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

First radius (half length) of the rectangle.

Restriction: Length1 > 0

Length2length2length_2 (input_control) rectangle2.hheight → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Second radius (half width) of the rectangle.

Restriction: Length2 >= 0

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

Distances of the contour points to the rectangle.

Result🔗

dist_rectangle2_contour_points_xldDistRectangle2ContourPointsXld returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

fit_rectangle2_contour_xldFitRectangle2ContourXld

Module🔗

Foundation