smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld (Operator)
smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld — Enclosing rectangle parallel to the coordinate axes of contours or polygons.
Signature
void SmallestRectangle1Xld(const HObject& XLD, HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2)
void HXLD::SmallestRectangle1Xld(HTuple* Row1, HTuple* Column1, HTuple* Row2, HTuple* Column2) const
void HXLD::SmallestRectangle1Xld(double* Row1, double* Column1, double* Row2, double* Column2) const
static void HOperatorSet.SmallestRectangle1Xld(HObject XLD, out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)
void HXLD.SmallestRectangle1Xld(out HTuple row1, out HTuple column1, out HTuple row2, out HTuple column2)
void HXLD.SmallestRectangle1Xld(out double row1, out double column1, out double row2, out double column2)
def smallest_rectangle1_xld(xld: HObject) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
def smallest_rectangle1_xld_s(xld: HObject) -> Tuple[float, float, float, float]
Description
The operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld calculates the enclosing
rectangle (parallel to the coordinate axes) for each input contour or
polygon.
The enclosing rectangle is described by the coordinates of the corner
pixels (Row1Row1Row1row1row_1,Column1Column1Column1column1column_1,Row2Row2Row2row2row_2,Column2Column2Column2column2column_2)
If more than one contour or polygon is passed, the results are stored in
tuples in the same order as the respective contours or polygons in
XLDXLDXLDXLDxld. In case of an empty contour all parameters have the value 0
if no other behavior was set (see set_systemset_systemSetSystemSetSystemset_system).
Attention
In case of empty contours the result of Row1Row1Row1row1row_1,Column1Column1Column1column1column_1,
Row2Row2Row2row2row_2 and Column2Column2Column2column2column_2 (all are 0) can lead to confusion.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Parameters
XLDXLDXLDXLDxld (input_object) xld(-array) → objectHXLDHObjectHObjectHobject
Contours or polygons to be examined.
Row1Row1Row1row1row_1 (output_control) rectangle.origin.y(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinate of upper left corner point of the
enclosing rectangle.
Column1Column1Column1column1column_1 (output_control) rectangle.origin.x(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinate of upper left corner point of the
enclosing rectangle.
Row2Row2Row2row2row_2 (output_control) rectangle.corner.y(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Row coordinate of lower right corner point of the
enclosing rectangle.
Column2Column2Column2column2column_2 (output_control) rectangle.corner.x(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Column coordinate of lower right corner point of the
enclosing rectangle.
Complexity
If N is the number of contour points, the runtime complexity is
O(N).
Result
smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld returns 2 (
H_MSG_TRUE)
if the input is not empty.
If the input is empty the behavior can be set via
set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If
necessary, an exception is raised.
Possible Predecessors
gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld,
edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixedges_sub_pix,
threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixthreshold_sub_pix,
gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld
Possible Successors
gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld
Alternatives
height_width_ratio_xldheight_width_ratio_xldHeightWidthRatioXldHeightWidthRatioXldheight_width_ratio_xld,
smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xldsmallest_rectangle2_xld,
shape_trans_xldshape_trans_xldShapeTransXldShapeTransXldshape_trans_xld
See also
shape_trans_xldshape_trans_xldShapeTransXldShapeTransXldshape_trans_xld,
smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xldsmallest_rectangle2_xld,
smallest_circle_xldsmallest_circle_xldSmallestCircleXldSmallestCircleXldsmallest_circle_xld,
elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldelliptic_axis_xld,
area_center_xldarea_center_xldAreaCenterXldAreaCenterXldarea_center_xld
Module
Foundation