get_region_convexT_get_region_convexGetRegionConvexGetRegionConvex (Operator)

Name

get_region_convexT_get_region_convexGetRegionConvexGetRegionConvex — Access convex hull as contour.

Signature

get_region_convex(Region : : : Rows, Columns)

Description

The operator get_region_convexget_region_convexGetRegionConvexGetRegionConvexGetRegionConvex returns the convex hull of a region as polygon. The polygon is the minimum result of line (RowsRowsRowsRowsrows) and column coordinates (ColumnsColumnsColumnsColumnscolumns) 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_convexget_region_convexGetRegionConvexGetRegionConvexGetRegionConvex returns the coordinates in the form of tuples. An empty region is passed as empty tuple.

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

RegionRegionRegionRegionregion (input_object) region → object

Output region.

RowsRowsRowsRowsrows (output_control) contour.y-array → (integer)

Line numbers of contour pixels.

ColumnsColumnsColumnsColumnscolumns (output_control) contour.x-array → (integer)

Column numbers of the contour pixels.

Number of elements: Columns == Rows

Result

The operator get_region_convexget_region_convexGetRegionConvexGetRegionConvexGetRegionConvex returns the value 2 (H_MSG_TRUE).

Possible Predecessors

thresholdthresholdThresholdThresholdThreshold, skeletonskeletonSkeletonSkeletonSkeleton, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThreshold

Possible Successors

disp_polygondisp_polygonDispPolygonDispPolygonDispPolygon

Alternatives

shape_transshape_transShapeTransShapeTransShapeTrans

Module

Foundation

Operators