Operator Reference

HALCON Operator Reference / Regions / Features
ClassesClasses | | Operators

get_region_thicknessT_get_region_thicknessGetRegionThicknessGetRegionThicknessget_region_thickness (Operator)

get_region_thicknessT_get_region_thicknessGetRegionThicknessGetRegionThicknessget_region_thickness — Access the thickness of a region along the main axis.

Signature

get_region_thickness(Region : : : Thickness, Histogramm)

Herror T_get_region_thickness(const Hobject Region, Htuple* Thickness, Htuple* Histogramm)

void GetRegionThickness(const HObject& Region, HTuple* Thickness, HTuple* Histogramm)

HTuple HRegion::GetRegionThickness(HTuple* Histogramm) const

static void HOperatorSet.GetRegionThickness(HObject region, out HTuple thickness, out HTuple histogramm)

HTuple HRegion.GetRegionThickness(out HTuple histogramm)

def get_region_thickness(region: HObject) -> Tuple[Sequence[int], Sequence[int]]

Description

The operator get_region_thicknessget_region_thicknessGetRegionThicknessGetRegionThicknessget_region_thickness calculates the thickness of the regions along the main axis (see elliptic_axiselliptic_axisEllipticAxisEllipticAxiselliptic_axis) for each pixel of the section. The thickness at one point on the main axis is defined as the distance between the intersections of the contour with the plumb on the main axis in the respective point which are the furthest apart. Additionally the operator get_region_thicknessget_region_thicknessGetRegionThicknessGetRegionThicknessget_region_thickness returns the HistogrammHistogrammHistogrammhistogrammhistogramm of the thicknesses of the region. The length of the histogram corresponds to the largest occurring thickness in the observed region.

Attention

Only one region may be passed. If the region has several connection components, only the first one is investigated. All other components are ignored.

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

Region to be analyzed.

ThicknessThicknessThicknessthicknessthickness (output_control)  integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Thickness of the region along its main axis.

HistogrammHistogrammHistogrammhistogrammhistogramm (output_control)  integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Histogram of the thickness of the region along its main axis.

Result

The operator get_region_thicknessget_region_thicknessGetRegionThicknessGetRegionThicknessget_region_thickness returns the value 2 ( H_MSG_TRUE) if exactly one region is passed. 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, connectionconnectionConnectionConnectionconnection, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, select_objselect_objSelectObjSelectObjselect_obj

See also

copy_objcopy_objCopyObjCopyObjcopy_obj, elliptic_axiselliptic_axisEllipticAxisEllipticAxiselliptic_axis

Module

Foundation

ClassesClasses | | Operators