Paint regions into an image.

paint_region paints the regions given in Region with a constant gray value into the image given in Image and returns the result in ImageResult. 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), ... ]. 

The parameter Type determines whether the region should be painted filled ('fill') or whether only its boundary should be painted ('margin').

As an alternative to paint_region, you can use the operator overpaint_region, which directly paints the regions into Image.

/* 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_region 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>:). If necessary, an exception is raised.

paint_region is reentrant and processed without parallelization.

read_image, gen_image_const, gen_image_proto, reduce_domain

set_grayval, overpaint_region, paint_xld

reduce_domain, paint_gray, overpaint_gray, set_draw, gen_image_const

Foundation