HALCON Reference Manual 10.0.2
Table of Contents / Regions / Access ClassesClassesClasses | | | Operators

get_region_convexT_get_region_convexget_region_convexGetRegionConvexGetRegionConvex (Operator)

Name

get_region_convexT_get_region_convexget_region_convexGetRegionConvexGetRegionConvex — Access convex hull as contour.

Signature

get_region_convex(Region : : : Rows, Columns)

Herror T_get_region_convex(const Hobject Region, Htuple* Rows, Htuple* Columns)

Herror get_region_convex(Hobject Region, HTuple* Rows, HTuple* Columns)

HTuple HRegion::GetRegionConvex(HTuple* Columns) const

void HOperatorSetX.GetRegionConvex(
[in] IHUntypedObjectX* Region, [out] VARIANT* Rows, [out] VARIANT* Columns)

VARIANT HRegionX.GetRegionConvex([out] VARIANT* Columns)

static void HOperatorSet.GetRegionConvex(HObject region, out HTuple rows, out HTuple columns)

void HRegion.GetRegionConvex(out HTuple rows, out HTuple columns)

Description

The operator get_region_convexget_region_convexget_region_convexGetRegionConvexGetRegionConvex 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_convexget_region_convexGetRegionConvexGetRegionConvex returns the coordinates in the form of tuples. An empty region is passed as empty tuple.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region → objectHRegionHRegionHRegionXHobject

Output region.

RowsRowsRowsRowsrows (output_control)  contour.y-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Line numbers of contour pixels.

ColumnsColumnsColumnsColumnscolumns (output_control)  contour.x-array → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column numbers of the contour pixels.

Number of elements: Columns == Rows

Result

The operator get_region_convexget_region_convexget_region_convexGetRegionConvexGetRegionConvex returns the value 2 (H_MSG_TRUE).

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, skeletonskeletonskeletonSkeletonSkeleton, dyn_thresholddyn_thresholddyn_thresholdDynThresholdDynThreshold

Possible Successors

disp_polygondisp_polygondisp_polygonDispPolygonDispPolygon

Alternatives

shape_transshape_transshape_transShapeTransShapeTrans

See also

select_objselect_objselect_objSelectObjSelectObj, get_region_contourget_region_contourget_region_contourGetRegionContourGetRegionContour

Module

Foundation

Table of Contents / Regions / Access ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH