region_to_binregion_to_binRegionToBinRegionToBinregion_to_bin (算子名称)

名称

region_to_binregion_to_binRegionToBinRegionToBinregion_to_bin — Convert a region into a binary byte-image.

参数签名

region_to_bin(区域 : BinImage : ForegroundGray, BackgroundGray, Width, Height : )

描述

region_to_binregion_to_binRegionToBinRegionToBinRegionToBinregion_to_bin converts the input region given in 区域区域区域区域区域区域 into a 'byte'"byte""byte""byte""byte""byte"-image and assigns a gray value of ForegroundGrayForegroundGrayForegroundGrayForegroundGrayforegroundGrayforeground_gray 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 BackgroundGrayBackgroundGrayBackgroundGrayBackgroundGraybackgroundGraybackground_gray.

运行信息

多线程类型:可重入(与非独占操作符并行运行)。
多线程作用域:全局(可以从任何线程调用)。
未经并行化处理。

参数表

区域区域区域区域区域区域 (input_object) region(-array) → object

Regions to be converted.

BinImageBinImageBinImageBinImagebinImagebin_image (output_object) image → object (byte)

Result image of dimension Width * Height containing the converted regions.

ForegroundGrayForegroundGrayForegroundGrayForegroundGrayforegroundGrayforeground_gray (input_control) integer → (integer)

Gray value in which the regions are displayed.

Default: 255

Suggested values: 0, 1, 50, 100, 128, 150, 200, 254, 255

Value range: 0 ≤ ForegroundGray ForegroundGray ForegroundGray ForegroundGray foregroundGray foreground_gray ≤ 255 (lin)

Recommended increment: 1

BackgroundGrayBackgroundGrayBackgroundGrayBackgroundGraybackgroundGraybackground_gray (input_control) integer → (integer)

Gray value in which the background is displayed.

Default: 0

Suggested values: 0, 1, 50, 100, 128, 150, 200, 254, 255

Value range: 0 ≤ BackgroundGray BackgroundGray BackgroundGray BackgroundGray backgroundGray background_gray ≤ 255 (lin)

Recommended increment: 1

WidthWidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Width of the image to be generated.

Default: 512

Suggested values: 256, 512, 1024

Value range: 1 ≤ Width Width Width Width width width ≤ 1024 (lin)

Minimum increment: 1

Recommended increment: 16

Restriction: Width >= 1

HeightHeightHeightHeightheightheight (input_control) extent.y → (integer)

Height of the image to be generated.

Default: 512

Suggested values: 256, 512, 1024

Value range: 1 ≤ Height Height Height Height height height ≤ 1024 (lin)

Minimum increment: 1

Recommended increment: 16

Restriction: Height >= 1

Complexity

O(2*HeightHeightHeightHeightheightheight*WidthWidthWidthWidthwidthwidth).

结果

region_to_binregion_to_binRegionToBinRegionToBinRegionToBinregion_to_bin 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>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("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>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>). 如有必要，将引发异常。

可能的前置算子

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

可能的后置算子

get_grayvalget_grayvalGetGrayvalGetGrayvalGetGrayvalget_grayval

可替代算子

region_to_labelregion_to_labelRegionToLabelRegionToLabelRegionToLabelregion_to_label, paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region, set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval

参考其它

gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray

模块

Foundation

算子列表