get_region_convex

Herror ::get_region_convex ( Hobject Region, HTuple *Rows, HTuple *Columns ) HTuple HRegion::GetRegionConvex ( HTuple *Columns ) const

Access convex hull as contour.

The operator ::get_region_convex returns the convex hull of a region as polygon. The polygon is the minimum result of line (Rows) and column coordinates (Columns) describing the hull of the region. The polygon pixels lie on the region. The polygon starts at the smallest line number; in this line at the pixel with the largest column index. The rotation direction is clockwise. The first pixel of the polygon is identical with the last. The operator ::get_region_convex returns the coordinates in the form of tuples. An empty region is passed as empty tuple.

Parameters

`Region` (input_object)	region `->` Hobject: HRegion
Output region.

`Rows` (output_control)	contour.y-array `->` HTuple.long *
Line numbers of contour pixels.

`Columns` (output_control)	contour.x-array `->` HTuple.long *
Column numbers of the contour pixels.
Number of elements: Columns == Rows

Result

The operator ::get_region_convex returns the value H_MSG_TRUE.

Possible Predecessors

::threshold, ::skeleton, ::dyn_threshold

Possible Successors

::disp_polygon

Alternatives

::shape_trans

See also

::select_obj, ::get_region_contour

Module

Region processing