get_region_contourT_get_region_contourGetRegionContourGetRegionContourget_region_contour (Operator)
Name
get_region_contourT_get_region_contourGetRegionContourGetRegionContourget_region_contour — Access the contour of an object.
Signature
def get_region_contour(region: HObject) -> Tuple[Sequence[int], Sequence[int]]
Description
The operator get_region_contourget_region_contourGetRegionContourGetRegionContourget_region_contour returns the contour of a region.
A contour is a result
of line (RowsRowsRowsrowsrows) and column coordinates (ColumnsColumnsColumnscolumnscolumns),
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_contourGetRegionContourGetRegionContourget_region_contour 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.
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 → objectHRegionHObjectHObjectHobject
Output region.
RowsRowsRowsrowsrows (output_control) contour.y-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Line numbers of the contour pixels.
ColumnsColumnsColumnscolumnscolumns (output_control) contour.x-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column numbers of the contour pixels.
Number of elements:
Columns == Rows
Result
The operator get_region_contourget_region_contourGetRegionContourGetRegionContourget_region_contour 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>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>).
Possible Predecessors
sobel_ampsobel_ampSobelAmpSobelAmpsobel_amp,
thresholdthresholdThresholdThresholdthreshold,
skeletonskeletonSkeletonSkeletonskeleton,
edges_imageedges_imageEdgesImageEdgesImageedges_image,
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1,
gen_circlegen_circleGenCircleGenCirclegen_circle
See also
copy_objcopy_objCopyObjCopyObjcopy_obj,
get_region_polygonget_region_polygonGetRegionPolygonGetRegionPolygonget_region_polygon
Module
Foundation