Herror ::gen_region_histo (
    Hobject *Region,
    const HTuple &Histogramm,
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Scale
)
HRegion HRegion::GenRegionHisto (
    const HTuple &Histogramm,
    const HTuple &Row,
    const HTuple &Column,
    const HTuple &Scale
)

Convert a histogram into a region.

::gen_region_histo converts a histogram created with ::gray_histo into a region. The effect of the three control parameters is the same as in ::disp_image and ::set_paint.


Parameters

Region (output_object)
region -> Hobject * : HRegion
Region containing the histogram.

Histogramm (input_control)
histogram-array -> HTuple.long
Input histogram.

Row (input_control)
point.y -> HTuple.long
Row coordinate of the center of the histogram.
Default value: 255
Suggested values: 100, 200, 255, 300, 400
Typical range of values: 0 <= Row <= 511

Column (input_control)
point.x -> HTuple.long
Column coordinate of the center of the histogram.
Default value: 255
Suggested values: 100, 200, 255, 300, 400
Typical range of values: 0 <= Column <= 511

Scale (input_control)
integer -> HTuple.long
Scale factor for the histogram.
Default value: 1
List of values: 1, 2, 3, 4, 5, 6, 7
Typical range of values: 1 <= Scale <= 10 (lin)
Minimum increment: 1
Recommended increment: 1


Result

::gen_region_histo returns H_MSG_TRUE if all parameters are correct. If necessary, an exception handling is raised.


Possible Predecessors

::gray_histo


See also

::disp_channel, ::set_paint


Module

Region processing



Copyright © 1996-2002 MVTec Software GmbH