名称
region_to_label - 将区域转换为标签图像。
用法
region_to_label(Region : ImageLabel : Type, Width, Height : )
描述
region_to_label根据它们的索引(1..n)将输入区域转换成标签图像,即,第一区域被绘成灰度值1,第二区域被绘成灰度值2等。仅使用正灰度值。 对于‘byte‘图像,索引以取256的模输入。
超出生成图像的区域被适当地剪切。 如果区域重叠,则输入索引较高图像的区域(即,它们按照它们被包含在输入区域中的顺序被绘制)。 如果需要,可以通过调用expand_region使区域不重叠。
将背景(即未被任何区域覆盖的区域)设置为0.这可以用于测试哪个图像范围不存在区域。
并行
● 多线程类型:可重入(与非独占算子并行运行)。
● 多线程范围:全局(可以从任何线程调用)。
● 不并行化处理。
参数
Region (input_object) region(-array) → object
要转换的区域。
ImageLabel (output_object) image → object (byte / int2 / int4)
包含转换区域的尺寸Width*Height的结果图像。
Type (input_control) string → (string)
图像像素类型。
Default value: ‘int2‘
List of values: ‘byte‘, ‘int2‘, ‘int4‘, ‘int8‘
Width (input_control) extent.y → (integer)
要生成的图像的宽度。
Default value: 512
Suggested values: 64, 128, 256, 512, 1024
Typical range of values: 1 ≤ Width ≤ 1024 (lin)
Minimum increment: 1
Recommended increment: 16
Restriction: Width >= 1
Height (input_control) extent.x → (integer)
要生成的图像的高度。
Default value: 512
Suggested values: 64, 128, 256, 512, 1024
Typical range of values: 1 ≤ Height ≤ 1024 (lin)
Minimum increment: 1
Recommended increment: 16
Restriction: Height >= 1
复杂度
O(2*Height*Width).
结果
region_to_label总是返回2(H_MSG_TRUE)。 空输入(没有给定区域)的行为可以通过set_system(‘no_object_result‘,<Result>)设置,以及通过set_system(‘empty_region_result‘,<Result>)输入空白区域时的行为。 如有必要,会引发异常。
Possible Predecessors
threshold, regiongrowing, connection, expand_region
Possible Predecessors
get_grayval, get_image_pointer1
Alternatives
region_to_bin, paint_region
See also
label_to_region
模块
Foundation