Operator Reference

HALCON Operator Reference / Legacy / Morphology

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

ClassesClasses | | Operators

fittingfittingFittingFittingfitting (Operator)

fittingfittingFittingFittingfitting — Perform a closing after an opening with multiple structuring elements.

Warning

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

Signature

fitting(Region, StructElements : RegionFitted : : )

Herror fitting(const Hobject Region, const Hobject StructElements, Hobject* RegionFitted)

Herror T_fitting(const Hobject Region, const Hobject StructElements, Hobject* RegionFitted)

void Fitting(const HObject& Region, const HObject& StructElements, HObject* RegionFitted)

HRegion HRegion::Fitting(const HRegion& StructElements) const

static void HOperatorSet.Fitting(HObject region, HObject structElements, out HObject regionFitted)

HRegion HRegion.Fitting(HRegion structElements)

def fitting(region: HObject, struct_elements: HObject) -> HObject

Description

fittingfittingFittingFittingfitting performs an openingopeningOpeningOpeningopening and a closingclosingClosingClosingclosing successively on the input regions. The eight structuring elements normally used for this operation can be generated with the operator gen_struct_elementsgen_struct_elementsGenStructElementsGenStructElementsgen_struct_elements. However, other user-defined structuring elements can also be used. Let R be the input region(s) and let denote the structuring elements. Furthermore, let P be the result of the opening and Q be the final result. Then the operator can be formalized as follows: Regions larger than the structuring elements are preserved, while small gaps are closed.

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(-array) → objectHRegionHObjectHObjectHobject

Regions to be processed.

StructElementsStructElementsStructElementsstructElementsstruct_elements (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Structuring elements.

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

Fitted regions.

Result

fittingfittingFittingFittingfitting 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

gen_struct_elementsgen_struct_elementsGenStructElementsGenStructElementsgen_struct_elements, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsgen_region_points

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionconnection

Alternatives

openingopeningOpeningOpeningopening, closingclosingClosingClosingclosing, connectionconnectionConnectionConnectionconnection, select_shapeselect_shapeSelectShapeSelectShapeselect_shape

Module

Foundation

---

ClassesClasses | | Operators