Skip to content

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xldgen_contours_skeleton_xld🔗

Short description🔗

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xldgen_contours_skeleton_xld — Convert a skeleton into XLD contours.

Signature🔗

gen_contours_skeleton_xld( region Skeleton, out xld_cont Contours, integer Length, string Mode )gen_contours_skeleton_xld( Skeleton : Contours : Length, Mode : )void GenContoursSkeletonXld( const HObject& Skeleton, HObject* Contours, const HTuple& Length, const HTuple& Mode )static void HOperatorSet.GenContoursSkeletonXld( HObject skeleton, out HObject contours, HTuple length, HTuple mode )def gen_contours_skeleton_xld( skeleton: HObject, length: int, mode: str ) -> HObject

Herror gen_contours_skeleton_xld( const Hobject Skeleton, Hobject* Contours, const Hlong Length, const char* Mode )

Herror T_gen_contours_skeleton_xld( const Hobject Skeleton, Hobject* Contours, const Htuple Length, const Htuple Mode )

HXLDCont HRegion::GenContoursSkeletonXld( Hlong Length, const HString& Mode ) const

HXLDCont HRegion::GenContoursSkeletonXld( Hlong Length, const char* Mode ) const

HXLDCont HRegion::GenContoursSkeletonXld( Hlong Length, const wchar_t* Mode ) const (Windows only)

HXLDCont HRegion.GenContoursSkeletonXld( int length, string mode )

Description🔗

gen_contours_skeleton_xldGenContoursSkeletonXld converts the input skeleton (e.g., edges) Skeletonskeletonskeleton, which is assumed to contain mostly one pixel wide regions (see skeletonSkeleton), into XLD contours.

The algorithm first attempts to transform the regions to contain only line segments in 8-neighborhood. In a second step, the junction points are labeled. After this, gen_contours_skeleton_xldGenContoursSkeletonXld tries to generate contours which end in junction or end points, in particular for junction points of the following configurations (in all four possible rotations):

    1  0  1     1  0  1     1  0  0     1  0  0     0  1  0     0  1  0
    0  2  0     0  2  0     0  2  1     0  2  1     0  2  1     1  2  1
    0  0  1     1  0  1     0  1  0     1  0  0     0  1  0     0  1  0

where 0 = background, 1 = foreground, and 2 = junction point.

After this, all contours having at least Lengthlengthlength points are returned. Since contours are split at junction points, possibly long contours may be split into several short segments because of short adjacent lines, even if they are longer than Lengthlengthlength points, if Modemodemode = 'filter'"filter" was selected. This can be avoided by setting Modemodemode = 'generalize1'"generalize1". In this case, the contours are generated as if the segments shorter than Lengthlengthlength were not contained in the input region. In order to preserve line segments, which are split into very short segments by the crossing of short lines, Modemodemode = 'generalize2'"generalize2" can be selected. In this case, line segments are preserved if they end in two junction points, even if they are shorter than Lengthlengthlength.

Execution information🔗

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🔗

Skeletonskeletonskeleton (input_object) region → objectobjectHObjectHRegionHObjectHobject

Skeleton of which the contours are to be determined.

Contourscontourscontours (output_object) xld_cont-array → objectobjectHObjectHXLDContHObjectHobject *

Resulting contours.

Lengthlengthlength (input_control) integer → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Minimum number of points a contour has to have.

Default: 11
Suggested values: 1, 2, 3, 5, 10, 201, 2, 3, 5, 10, 20

Modemodemode (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Contour filter mode.

Default: 'filter'"filter"
List of values: 'filter', 'generalize1', 'generalize2'"filter", "generalize1", "generalize2"

Combinations with other operators🔗

Combinations

Possible predecessors

skeletonSkeleton

Possible successors

smooth_contours_xldSmoothContoursXld, get_contour_xldGetContourXld, gen_polygons_xldGenPolygonsXld

See also

edges_imageEdgesImage, thresholdThreshold, get_region_contourGetRegionContour

Module🔗

Foundation