paint_regionpaint_regionPaintRegionPaintRegionpaint_region (算子)

名称

paint_regionpaint_regionPaintRegionPaintRegionpaint_region — 将区域绘制到图像中。

签名

paint_region(Region, Image : ImageResult : Grayval, Type : )

描述

paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region paints the regions given in RegionRegionRegionRegionregionregion with a constant gray value into the image given in ImageImageImageImageimageimage and returns the result in ImageResultImageResultImageResultImageResultimageResultimage_result. These gray values can either be specified for each channel once, valid for all regions, or for each region separately. To define the latter, group the channel gray values g of each region and concatenate them to a tuple according to the regions' order, e.g., for a three channel image:

[g(channel1,region1), g(channel2,region1), g(channel3,region1), g(channel1,region2), ... ]. If the input image is of type direction, gray values that are not in the value range that is valid for direction images are set to the value 255 to mark them as invalid. The parameter TypeTypeTypeTypetypetype determines whether the region should be painted filled ('fill'"fill""fill""fill""fill""fill") or whether only its boundary should be painted ('margin'"margin""margin""margin""margin""margin").

As an alternative to paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region, you can use the operator overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region, which directly paints the regions into ImageImageImageImageimageimage。

执行信息

多线程类型：可重入（与非独占算子并行运行）。
多线程作用域：全局（可从任何线程调用）。
未采用并行化处理。

参数

RegionRegionRegionRegionregionregion (输入对象) region(-array) → object

Regions to be painted into the input image.

ImageImageImageImageimageimage (输入对象) (multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex)

Image in which the regions are to be painted.

ImageResultImageResultImageResultImageResultimageResultimage_result (输出对象) image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex)

Image containing the result.

GrayvalGrayvalGrayvalGrayvalgrayvalgrayval (输入控制) number(-array) → (real / integer)

Desired gray values of the regions.

默认值： 255.0

建议值： 0.0, 1.0, 2.0, 5.0, 10.0, 16.0, 32.0, 64.0, 128.0, 253.0, 254.0, 255.0

TypeTypeTypeTypetypetype (输入控制) string → (string)

Paint regions filled or as boundaries.

默认值： 'fill' "fill" "fill" "fill" "fill" "fill"

值列表： 'fill'"fill""fill""fill""fill""fill", 'margin'"margin""margin""margin""margin""margin"

示例（HDevelop）

* Paint a rectangle into the image 'monkey'

read_image(Image,'monkey')
gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* paint a white rectangle
paint_region(Rectangle,Image,ImageResult,255.0,'fill')

示例（C）

/* Paint a rectangle into the image 'monkey'  */

read_image(&Image,"monkey");
gen_rectangle1(&Rectangle,100.0,100.0,300.0,300.0);
/* paint a white rectangle */
paint_region(Rectangle,Image,&ImageResult,255.0,"fill");

示例（HDevelop）

* Paint a rectangle into the image 'monkey'

read_image(Image,'monkey')
gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* paint a white rectangle
paint_region(Rectangle,Image,ImageResult,255.0,'fill')

示例（HDevelop）

* Paint a rectangle into the image 'monkey'

read_image(Image,'monkey')
gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* paint a white rectangle
paint_region(Rectangle,Image,ImageResult,255.0,'fill')

示例（HDevelop）

* Paint a rectangle into the image 'monkey'

read_image(Image,'monkey')
gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* paint a white rectangle
paint_region(Rectangle,Image,ImageResult,255.0,'fill')

结果

paint_regionpaint_regionPaintRegionPaintRegionPaintRegionpaint_region 在所有参数正确时返回 2 ( H_MSG_TRUE )。如果输入为空则可设置行为通过 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>)。如有必要，则抛出异常。

可能的前趋

read_imageread_imageReadImageReadImageReadImageread_image, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const, gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProtogen_image_proto, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain

替代

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayvalset_grayval, overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegionoverpaint_region, paint_xldpaint_xldPaintXldPaintXldPaintXldpaint_xld

另见

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, paint_graypaint_grayPaintGrayPaintGrayPaintGraypaint_gray, overpaint_grayoverpaint_grayOverpaintGrayOverpaintGrayOverpaintGrayoverpaint_gray, set_drawset_drawSetDrawSetDrawSetDrawset_draw, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConstgen_image_const

模块

基础

算子