paint_regionpaint_regionPaintRegionPaintRegion (Operator)
Name
paint_regionpaint_regionPaintRegionPaintRegion — Paint regions into an image.
Signature
void PaintRegion(const HObject& Region, const HObject& Image, HObject* ImageResult, const HTuple& Grayval, const HTuple& Type)
HImage HImage::PaintRegion(const HRegion& Region, const HTuple& Grayval, const HString& Type) const
HImage HImage::PaintRegion(const HRegion& Region, double Grayval, const HString& Type) const
HImage HImage::PaintRegion(const HRegion& Region, double Grayval, const char* Type) const
HImage HImage::PaintRegion(const HRegion& Region, double Grayval, const wchar_t* Type) const
(Windows only)
HImage HRegion::PaintRegion(const HImage& Image, const HTuple& Grayval, const HString& Type) const
HImage HRegion::PaintRegion(const HImage& Image, double Grayval, const HString& Type) const
HImage HRegion::PaintRegion(const HImage& Image, double Grayval, const char* Type) const
HImage HRegion::PaintRegion(const HImage& Image, double Grayval, const wchar_t* Type) const
(Windows only)
static void HOperatorSet.PaintRegion(HObject region, HObject image, out HObject imageResult, HTuple grayval, HTuple type)
HImage HImage.PaintRegion(HRegion region, HTuple grayval, string type)
HImage HImage.PaintRegion(HRegion region, double grayval, string type)
HImage HRegion.PaintRegion(HImage image, HTuple grayval, string type)
HImage HRegion.PaintRegion(HImage image, double grayval, string type)
Description
paint_regionpaint_regionPaintRegionPaintRegionPaintRegion paints the regions given in RegionRegionRegionRegionregion with a
constant gray value into the image given in ImageImageImageImageimage and returns the
result in ImageResultImageResultImageResultImageResultimageResult. 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").
As an alternative to paint_regionpaint_regionPaintRegionPaintRegionPaintRegion, you can use the operator
overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegion, which directly paints the regions into
ImageImageImageImageimage.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
RegionRegionRegionRegionregion (input_object) region(-array) → objectHRegionHRegionHobject
Regions to be painted into the input image.
ImageImageImageImageimage (input_object) (multichannel-)image → objectHImageHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex)
Image in which the regions are to be painted.
ImageResultImageResultImageResultImageResultimageResult (output_object) image → objectHImageHImageHobject * (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex)
Image containing the result.
GrayvalGrayvalGrayvalGrayvalgrayval (input_control) number(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Desired gray values of the regions.
Default value: 255.0
Suggested values: 0.0, 1.0, 2.0, 5.0, 10.0, 16.0, 32.0, 64.0, 128.0, 253.0, 254.0, 255.0
TypeTypeTypeTypetype (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Paint regions filled or as boundaries.
Default value:
'fill'
"fill"
"fill"
"fill"
"fill"
List of values: 'fill'"fill""fill""fill""fill", 'margin'"margin""margin""margin""margin"
Example (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')
Example (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");
Example (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')
Example (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')
Example (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')
Result
paint_regionpaint_regionPaintRegionPaintRegionPaintRegion 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,
overpaint_regionoverpaint_regionOverpaintRegionOverpaintRegionOverpaintRegion,
paint_xldpaint_xldPaintXldPaintXldPaintXld
See also
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain,
paint_graypaint_grayPaintGrayPaintGrayPaintGray,
overpaint_grayoverpaint_grayOverpaintGrayOverpaintGrayOverpaintGray,
set_drawset_drawSetDrawSetDrawSetDraw,
gen_image_constgen_image_constGenImageConstGenImageConstGenImageConst
Module
Foundation