ClassesClassesClassesClasses | | | | Operators

get_region_contourT_get_region_contourGetRegionContourget_region_contourGetRegionContourGetRegionContour (Operator)

Name

get_region_contourT_get_region_contourGetRegionContourget_region_contourGetRegionContourGetRegionContour — Access the contour of an object.

Signature

get_region_contour(Region : : : Rows, Columns)

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

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

HTuple HRegion::GetRegionContour(HTuple* Columns) const

void GetRegionContour(const HObject& Region, HTuple* Rows, HTuple* Columns)

void HRegion::GetRegionContour(HTuple* Rows, HTuple* Columns) const

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

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

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

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

Description

The operator get_region_contourget_region_contourGetRegionContourget_region_contourGetRegionContourGetRegionContour returns the contour of a region. A contour is a result of line (RowsRowsRowsRowsRowsrows) and column coordinates (ColumnsColumnsColumnsColumnsColumnscolumns), describing the boundary of the region. The contour lies on the region. It starts at the smallest line number. In that line at the pixel with the largest column index. The rotation direction is clockwise. The first pixel of the contour is identical with the last. Holes of the region are ignored. The operator get_region_contourget_region_contourGetRegionContourget_region_contourGetRegionContourGetRegionContour returns the coordinates in the form of tuples. An empty region is passed as empty tuple.

Attention

Holes of the region are ignored. Only one region may be passed, and this region must have exactly one connection component.

Parallelization

Parameters

RegionRegionRegionRegionRegionregion (input_object)  region objectHRegionHRegionHRegionHRegionXHobject

Output region.

RowsRowsRowsRowsRowsrows (output_control)  contour.y-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Line numbers of the contour pixels.

ColumnsColumnsColumnsColumnsColumnscolumns (output_control)  contour.x-array HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Column numbers of the contour pixels.

Number of elements: Columns == Rows

Result

The operator get_region_contourget_region_contourGetRegionContourget_region_contourGetRegionContourGetRegionContour normally returns the value 2 (H_MSG_TRUE). If more than one connection component is passed an exception is raised. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>).

Possible Predecessors

sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp, thresholdthresholdThresholdthresholdThresholdThreshold, skeletonskeletonSkeletonskeletonSkeletonSkeleton, edges_imageedges_imageEdgesImageedges_imageEdgesImageEdgesImage, gen_rectangle1gen_rectangle1GenRectangle1gen_rectangle1GenRectangle1GenRectangle1, gen_circlegen_circleGenCirclegen_circleGenCircleGenCircle

See also

copy_objcopy_objCopyObjcopy_objCopyObjCopyObj, get_region_chainget_region_chainGetRegionChainget_region_chainGetRegionChainGetRegionChain, get_region_polygonget_region_polygonGetRegionPolygonget_region_polygonGetRegionPolygonGetRegionPolygon

Module

Foundation


ClassesClassesClassesClasses | | | | Operators