Operator Reference

HALCON Operator Reference / Legacy / Morphology

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

morph_skeletonmorph_skeletonMorphSkeletonMorphSkeletonmorph_skeleton (Operator)

morph_skeletonmorph_skeletonMorphSkeletonMorphSkeletonmorph_skeleton — Compute the morphological skeleton of a region.

Warning

morph_skeletonmorph_skeletonMorphSkeletonMorphSkeletonmorph_skeleton is obsolete and is only provided for reasons of backward compatibility.

Signature

morph_skeleton(Region : RegionSkeleton : : )

Herror morph_skeleton(const Hobject Region, Hobject* RegionSkeleton)

Herror T_morph_skeleton(const Hobject Region, Hobject* RegionSkeleton)

void MorphSkeleton(const HObject& Region, HObject* RegionSkeleton)

HRegion HRegion::MorphSkeleton() const

static void HOperatorSet.MorphSkeleton(HObject region, out HObject regionSkeleton)

HRegion HRegion.MorphSkeleton()

def morph_skeleton(region: HObject) -> HObject

Description

morph_skeletonmorph_skeletonMorphSkeletonMorphSkeletonmorph_skeleton computes the skeleton of the input regions (RegionRegionRegionregionregion) using morphological transformations. The computation yields a disconnected skeleton (gaps in the diagonals) having a width of one or two pixels. The calculation uses the Golay element 'h', i.e., an 8-neighborhood. This is equivalent to the maximum-norm.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

RegionRegionRegionregionregion (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Regions to be processed.

RegionSkeletonRegionSkeletonRegionSkeletonregionSkeletonregion_skeleton (output_object)  region(-array) → objectHRegionHObjectHObjectHobject *

Resulting morphological skeleton.

Result

morph_skeletonmorph_skeletonMorphSkeletonMorphSkeletonmorph_skeleton returns 2 ( H_MSG_TRUE) if all parameters are correct. The behavior in case of empty or no input region can be set via:

• no region: set_system('no_object_result',<RegionResult>)set_system("no_object_result",<RegionResult>)SetSystem("no_object_result",<RegionResult>)SetSystem("no_object_result",<RegionResult>)set_system("no_object_result",<RegionResult>)

• empty region: set_system('empty_region_result',<RegionResult>)set_system("empty_region_result",<RegionResult>)SetSystem("empty_region_result",<RegionResult>)SetSystem("empty_region_result",<RegionResult>)set_system("empty_region_result",<RegionResult>)

Otherwise, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionconnection, union1union1Union1Union1union1, watershedswatershedsWatershedsWatershedswatersheds, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormclass_ndim_norm

Possible Successors

skeletonskeletonSkeletonSkeletonskeleton, reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionconnection

Alternatives

skeletonskeletonSkeletonSkeletonskeleton

Module

Foundation

---

ClassesClasses | | Operators