smallest_rectangle1_xld (Operator)

Name

smallest_rectangle1_xld — Enclosing rectangle parallel to the coordinate axes of contours or polygons.

Synopsis

smallest_rectangle1_xld(XLD : : : Row1, Column1, Row2, Column2)

Description

The operator smallest_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 (Row1,Column1,Row2,Column2)

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 XLD. In case of an empty contour all parameters have the value 0 if no other behavior was set (see set_system).

Attention

In case of empty contours the result of Row1,Column1, Row2 and Column2 (all are 0) can lead to confusion.

Parameters

XLD (input_object)	xld(-array) → object
Contours or polygons to be examined.

Row1 (output_control)	rectangle.origin.y(-array) → (real)
Row coordinate of upper left corner point of the enclosing rectangle.

Column1 (output_control)	rectangle.origin.x(-array) → (real)
Column coordinate of upper left corner point of the enclosing rectangle.

Row2 (output_control)	rectangle.corner.y(-array) → (real)
Row coordinate of lower right corner point of the enclosing rectangle.

Column2 (output_control)	rectangle.corner.x(-array) → (real)
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_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>:). If necessary, an exception is raised.

Parallelization Information

smallest_rectangle1_xld is reentrant and automatically parallelized (on tuple level).

Possible Predecessors

gen_contours_skeleton_xld, edges_sub_pix, threshold_sub_pix, gen_contour_polygon_xld

Possible Successors

gen_polygons_xld

Alternatives

smallest_rectangle2_xld, shape_trans_xld

See also

shape_trans_xld, smallest_rectangle2_xld, smallest_circle_xld, elliptic_axis_xld, area_center_xld

Module

Foundation