shape_histo_pointT_shape_histo_pointShapeHistoPointShapeHistoPoint (Operator)
Name
shape_histo_pointT_shape_histo_pointShapeHistoPointShapeHistoPoint — Determine a histogram of features along all threshold values.
Signature
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
- 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 → 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