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

Determine a histogram of features along all threshold values.

Like ::shape_histo_all the operator ::shape_histo_point carries out 255 threshold value operations within Region with the gray values of Image. Contrary to ::shape_histo_all only the segmented region containing the pixel (Row, Column) 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 (Feature = 'holes') or the feature value of the region (Feature = 'convexity', 'compactness', 'ansisometry'), respectively.

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


Parameters

Region (input_object)
region -> Hobject: HRegion
Region in which the features are to be examined.

Image (input_object)
image -> Hobject: HImage ( byte )
Gray value image.

Feature (input_control)
string -> HTuple.char *
Feature to be examined.
Default value: 'convexity'
List of values: 'convexity', 'compactness', 'anisometry', 'holes'

Row (input_control)
point.y -> HTuple.long
Row of the pixel which the region must contain.
Default value: 256
Suggested values: 10, 50, 100, 200, 300, 400

Column (input_control)
point.x -> HTuple.long
Column of the pixel which the region must contain.
Default value: 256
Suggested values: 10, 50, 100, 200, 300, 400

AbsoluteHisto (output_control)
histogram-array -> HTuple.double * / long *
Absolute distribution of the feature.

RelativeHisto (output_control)
histogram-array -> HTuple.double *
Relative distribution of the feature.


Result

The operator ::shape_histo_point returns the value 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>), the behavior in case of empty region is set via ::set_system('empty_region_result',<Result>). If necessary an exception handling is raised.


Possible Predecessors

::get_mbutton, ::area_center


Possible Successors

::histo_to_thresh, ::threshold, ::gen_region_histo


Alternatives

::shape_histo_all


See also

::connection, ::connect_and_holes, ::convexity, ::compactness, ::set_paint


Module

Image filters



Copyright © 1996-2002 MVTec Software GmbH