Name
region_to_binregion_to_binRegionToBinregion_to_binRegionToBinRegionToBin — Convert a region into a binary byte-image.
Herror region_to_bin(const Hobject Region, Hobject* BinImage, const Hlong ForegroundGray, const Hlong BackgroundGray, const Hlong Width, const Hlong Height)
Herror T_region_to_bin(const Hobject Region, Hobject* BinImage, const Htuple ForegroundGray, const Htuple BackgroundGray, const Htuple Width, const Htuple Height)
Herror region_to_bin(Hobject Region, Hobject* BinImage, const HTuple& ForegroundGray, const HTuple& BackgroundGray, const HTuple& Width, const HTuple& Height)
HImage HRegion::RegionToBin(const HTuple& ForegroundGray, const HTuple& BackgroundGray, const HTuple& Width, const HTuple& Height) const
HImage HRegionArray::RegionToBin(const HTuple& ForegroundGray, const HTuple& BackgroundGray, const HTuple& Width, const HTuple& Height) const
region_to_binregion_to_binRegionToBinregion_to_binRegionToBinRegionToBin converts the input region given in
RegionRegionRegionRegionRegionregion into a 'byte'"byte""byte""byte""byte""byte"-image and assigns a gray
value of ForegroundGrayForegroundGrayForegroundGrayForegroundGrayForegroundGrayforegroundGray to all pixels in the region. If
the input region is larger than the generated image, it is clipped
at the image borders. The background is set to
BackgroundGrayBackgroundGrayBackgroundGrayBackgroundGrayBackgroundGraybackgroundGray.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Result image of dimension Width * Height
containing the converted regions.
Gray value in which the regions are displayed.
Default value: 255
Suggested values: 0, 1, 50, 100, 128, 150, 200, 254, 255
Typical range of values: 0
≤
ForegroundGray
ForegroundGray
ForegroundGray
ForegroundGray
ForegroundGray
foregroundGray
≤
255 (lin)
Recommended increment: 1
Gray value in which the background is displayed.
Default value: 0
Suggested values: 0, 1, 50, 100, 128, 150, 200, 254, 255
Typical range of values: 0
≤
BackgroundGray
BackgroundGray
BackgroundGray
BackgroundGray
BackgroundGray
backgroundGray
≤
255 (lin)
Recommended increment: 1
Width of the image to be generated.
Default value: 512
Suggested values: 256, 512, 1024
Typical range of values: 1
≤
Width
Width
Width
Width
Width
width
≤
1024 (lin)
Minimum increment: 1
Recommended increment: 16
Restriction: Width >= 1
Height of the image to be generated.
Default value: 512
Suggested values: 256, 512, 1024
Typical range of values: 1
≤
Height
Height
Height
Height
Height
height
≤
1024 (lin)
Minimum increment: 1
Recommended increment: 16
Restriction: Height >= 1
O(2*HeightHeightHeightHeightHeightheight*WidthWidthWidthWidthWidthwidth).
region_to_binregion_to_binRegionToBinregion_to_binRegionToBinRegionToBin always returns 2 (H_MSG_TRUE). The behavior in case
of empty input (no regions given) can be set via
set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)
and the behavior in case of an empty input region via
set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("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.
thresholdthresholdThresholdthresholdThresholdThreshold,
connectionconnectionConnectionconnectionConnectionConnection,
regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing,
pouringpouringPouringpouringPouringPouring
get_grayvalget_grayvalGetGrayvalget_grayvalGetGrayvalGetGrayval
region_to_labelregion_to_labelRegionToLabelregion_to_labelRegionToLabelRegionToLabel,
paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion,
set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval
gen_image_protogen_image_protoGenImageProtogen_image_protoGenImageProtoGenImageProto,
paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray
Foundation