Paint XLD objects into an image.

paint_xld paints the XLD objects XLD of type contour or polygon with the constant gray values Grayval into each channel of the background image given in Image and returns the result in ImageResult. Open contours of XLD objects are closed and their enclosed regions are filled up. The rim of the subpixel XLD objects is painted onto the background image using anti-aliasing. Note that only objects without crossings or touching segments are painted correctly.

Grayval contains the gray values for painting the XLD objects. These gray values can either be specified for each channel once, valid for all XLD objects, or for each XLD object separately. To define the latter, group the channel gray values g of each XLD object and concatenate them to a tuple according to the order of the XLD objects, e.g., for a three channel image:

  [g(channel1,xld1), g(channel2,xld1), g(channel3,xld1), g(channel1,xld2), ... ].  

/* Paint colored xld objects into a gray image */

/* read and copy image to generate a three channel image */
read_image(Image1,'green-dot')
copy_image(Image1,Image2)
copy_image(Image1,Image3)
compose3(Image1,Image2,Image3,Image)
/* extract subpixel border */
threshold_sub_pix(Image1,Border,128)
/* select the circle and the arrows */
select_obj(Border,circle,14)
select_obj(Border,arrows,16)
concat_obj(circle,arrows,green_dot)
/* paint a green circle and white arrows (to paint all 
 * objects e.g. blue, pass [0,0,255] tuple for GrayVal) */  
paint_xld(green_dot,Image,ImageResult,[0,255,0,255,255,255])

paint_xld 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_xld is reentrant and processed without parallelization.

read_image, gen_image_const, gen_image_proto, gen_contour_polygon_xld, threshold_sub_pix

set_grayval, paint_gray, paint_region

gen_image_const

Foundation