overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegion (Operator)

Name

overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegion — Overpaint regions in an image.

Signature

Description

overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegion paints the regions given in RegionRegionRegionRegionregion with a constant gray value into the image given in ImageImageImageImageimage. 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 TypeTypeTypeTypetype determines whether the region should be painted filled ('fill'"fill""fill""fill""fill") or whether only its boundary should be painted ('margin'"margin""margin""margin""margin").

If you do not want to modify ImageImageImageImageimage itself, you can use the operator paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, which returns the result in a newly created image.

Attention

overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegion modifies the content of an already existing image (ImageImageImageImageimage). Besides, even other image objects may be affected: For example, if you created ImageImageImageImageimage via copy_objcopy_objCopyObjCopyObjCopyObj from another image object (or vice versa), overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegion will also modify the image matrix of this other image object. Therefore, overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegion should only be used to overpaint newly created image objects. Typical operators for this task are, e.g., gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst (creates a new image with a specified size), gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProto (creates an image with the size of a specified prototype image) or copy_imagecopy_imageCopyImageCopyImageCopyImage (creates an image as the copy of a specified image).

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

This operator modifies the state of the following input parameter:

• ImageImageImageImageimage

The value of this parameter may not be shared across multiple threads without external synchronization.

Parameters

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

/* Paint a rectangle into a new image (New1) */

gen_rectangle1(&Rectangle,100.0,100.0,300.0,300.0);
/* generate a black image */
gen_image_const(&New1,"byte", 768, 576)
/* paint a white rectangle */
overpaint_region(New1,Rectangle,255.0,"fill");

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

* Paint a rectangle into a new image (New1)

gen_rectangle1(Rectangle,100.0,100.0,300.0,300.0)
* generate a black image
gen_image_const(New1,'byte', 768, 576)
* paint a white rectangle
overpaint_region(New1,Rectangle,255.0,'fill')

Result

overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegion returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behavior 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>). If necessary, an exception is raised.

Possible Predecessors

read_imageread_imageReadImageReadImageReadImage, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst, gen_image_protogen_image_protoGenImageProtoGenImageProtoGenImageProto, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain

Alternatives

set_grayvalset_grayvalSetGrayvalSetGrayvalSetGrayval, paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, paint_xldpaint_xldPaintXldPaintXldPaintXld

See also

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, set_drawset_drawSetDrawSetDrawSetDraw, paint_graypaint_grayPaintGrayPaintGrayPaintGray, overpaint_grayoverpaint_grayOverpaintGrayOverpaintGrayOverpaintGray, gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst

Module

Foundation