名称

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