shape_histo_pointT_shape_histo_pointShapeHistoPointShapeHistoPoint (Operator)

Name

shape_histo_pointT_shape_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)

void ShapeHistoPoint(const HObject& Region, const HObject& Image, const HTuple& Feature, const HTuple& Row, const HTuple& Column, HTuple* AbsoluteHisto, HTuple* RelativeHisto)

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

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

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

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_allShapeHistoAllShapeHistoAllShapeHistoAll the operator shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPointShapeHistoPoint carries out 255 threshold value operations within RegionRegionRegionRegionregion with the gray values of ImageImageImageImageimage. Contrary to shape_histo_allshape_histo_allShapeHistoAllShapeHistoAllShapeHistoAll 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")SetPaint(WindowHandle,"component_histogram")SetPaint(WindowHandle,"component_histogram")SetPaint(WindowHandle,"component_histogram") and disp_imagedisp_imageDispImageDispImageDispImage.

Attention

Note that the operator shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPointShapeHistoPoint only considers the given RegionRegionRegionRegionregion and ignores any previously set domain of the input image ImageImageImageImageimage.

Execution Information

Parameters

RegionRegionRegionRegionregion (input_object)  region objectHRegionHRegionHobject

Region in which the features are to be examined.

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte)

Gray value image.

FeatureFeatureFeatureFeaturefeature (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Feature to be examined.

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

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

RowRowRowRowrow (input_control)  point.y HTupleHTupleHtuple (integer) (int / long) (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 HTupleHTupleHtuple (integer) (int / long) (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 HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Absolute distribution of the feature.

RelativeHistoRelativeHistoRelativeHistoRelativeHistorelativeHisto (output_control)  histogram-array HTupleHTupleHtuple (real) (double) (double) (double)

Relative distribution of the feature.

Result

The operator shape_histo_pointshape_histo_pointShapeHistoPointShapeHistoPointShapeHistoPoint 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>)SetSystem("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>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbutton, area_centerarea_centerAreaCenterAreaCenterAreaCenter

Possible Successors

histo_to_threshhisto_to_threshHistoToThreshHistoToThreshHistoToThresh, thresholdthresholdThresholdThresholdThreshold, gen_region_histogen_region_histoGenRegionHistoGenRegionHistoGenRegionHisto

Alternatives

shape_histo_allshape_histo_allShapeHistoAllShapeHistoAllShapeHistoAll

See also

connectionconnectionConnectionConnectionConnection, connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHoles, convexityconvexityConvexityConvexityConvexity, compactnesscompactnessCompactnessCompactnessCompactness, set_paintset_paintSetPaintSetPaintSetPaint

Module

Foundation