HALCON Reference Manual 10.0.2
Table of Contents / Image / Features ClassesClassesClasses | | | Operators

shape_histo_pointT_shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPoint (Operator)

Name

shape_histo_pointT_shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPoint — Determine a histogram of features along all threshold values.

Signature

shape_histo_point(Region, Image : : Feature, Row, Column : AbsoluteHisto, RelativeHisto)

Herror T_shape_histo_point(const Hobject Region, const Hobject Image, const Htuple Feature, const Htuple Row, const Htuple Column, Htuple* AbsoluteHisto, Htuple* RelativeHisto)

Herror shape_histo_point(Hobject Region, Hobject Image, const HTuple& Feature, const HTuple& Row, const HTuple& Column, HTuple* AbsoluteHisto, HTuple* RelativeHisto)

HTuple HRegion::ShapeHistoPoint(const HImage& Image, const HTuple& Feature, const HTuple& Row, const HTuple& Column, HTuple* RelativeHisto) const

void HOperatorSetX.ShapeHistoPoint(
[in] IHUntypedObjectX* Region, [in] IHUntypedObjectX* Image, [in] VARIANT Feature, [in] VARIANT Row, [in] VARIANT Column, [out] VARIANT* AbsoluteHisto, [out] VARIANT* RelativeHisto)

VARIANT HRegionX.ShapeHistoPoint(
[in] IHImageX* Image, [in] BSTR Feature, [in] Hlong Row, [in] Hlong Column, [out] VARIANT* RelativeHisto)

static void HOperatorSet.ShapeHistoPoint(HObject region, HObject image, HTuple feature, HTuple row, HTuple column, out HTuple absoluteHisto, out HTuple relativeHisto)

HTuple HRegion.ShapeHistoPoint(HImage image, string feature, int row, int column, out HTuple relativeHisto)

Description

Like shape_histo_allshape_histo_allshape_histo_allShapeHistoAllShapeHistoAll the operator shape_histo_pointshape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPoint carries out 255 threshold value operations within RegionRegionRegionRegionregion with the gray values of ImageImageImageImageimage. Contrary to shape_histo_allshape_histo_allshape_histo_allShapeHistoAllShapeHistoAll only the segmented region containing the pixel (RowRowRowRowrow, ColumnColumnColumnColumncolumn) is taken into account here. The entry i in the histogram then corresponds to the number of holes of this region segmented with the threshold i (FeatureFeatureFeatureFeaturefeature = 'holes'"holes""holes""holes""holes") or the feature value of the region (FeatureFeatureFeatureFeaturefeature = 'convexity'"convexity""convexity""convexity""convexity", 'compactness'"compactness""compactness""compactness""compactness", 'ansisometry'"ansisometry""ansisometry""ansisometry""ansisometry"), respectively.

The histogram can also be displayed directly as a graphic via the operators set_paint(::WindowHandle,'component_histogram':)set_paint(WindowHandle,"component_histogram")set_paint(WindowHandle,"component_histogram")SetPaint(WindowHandle,"component_histogram")SetPaint(WindowHandle,"component_histogram") and disp_imagedisp_imagedisp_imageDispImageDispImage.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region → objectHRegionHRegionHRegionXHobject

Region in which the features are to be examined.

ImageImageImageImageimage (input_object)  image → objectHImageHImageHImageXHobject (byte)

Gray value image.

FeatureFeatureFeatureFeaturefeature (input_control)  string → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Feature to be examined.

Default value: 'convexity' "convexity" "convexity" "convexity" "convexity"

List of values: 'convexity'"convexity""convexity""convexity""convexity", 'compactness'"compactness""compactness""compactness""compactness", 'anisometry'"anisometry""anisometry""anisometry""anisometry", 'holes'"holes""holes""holes""holes"

RowRowRowRowrow (input_control)  point.y → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Row of the pixel which the region must contain.

Default value: 256

Suggested values: 10, 50, 100, 200, 300, 400

ColumnColumnColumnColumncolumn (input_control)  point.x → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Column of the pixel which the region must contain.

Default value: 256

Suggested values: 10, 50, 100, 200, 300, 400

AbsoluteHistoAbsoluteHistoAbsoluteHistoAbsoluteHistoabsoluteHisto (output_control)  histogram-array → HTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong)

Absolute distribution of the feature.

RelativeHistoRelativeHistoRelativeHistoRelativeHistorelativeHisto (output_control)  histogram-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Relative distribution of the feature.

Result

The operator shape_histo_pointshape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPoint returns the value 2 (H_MSG_TRUE) if an image with defined gray values is entered. The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>), the behavior in case of empty region is set via set_system(::'empty_region_result',<Result>:)set_system("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

get_mbuttonget_mbuttonget_mbuttonGetMbuttonGetMbutton, area_centerarea_centerarea_centerAreaCenterAreaCenter

Possible Successors

histo_to_threshhisto_to_threshhisto_to_threshHistoToThreshHistoToThresh, thresholdthresholdthresholdThresholdThreshold, gen_region_histogen_region_histogen_region_histoGenRegionHistoGenRegionHisto

Alternatives

shape_histo_allshape_histo_allshape_histo_allShapeHistoAllShapeHistoAll

See also

connectionconnectionconnectionConnectionConnection, connect_and_holesconnect_and_holesconnect_and_holesConnectAndHolesConnectAndHoles, convexityconvexityconvexityConvexityConvexity, compactnesscompactnesscompactnessCompactnessCompactness, set_paintset_paintset_paintSetPaintSetPaint

Module

Foundation

Table of Contents / Image / Features ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH