paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray (Operator)

Name

paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray — Paint the gray values of an image into another image.

Signature

paint_gray(ImageSource, ImageDestination : MixedImage : : )

Description

paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray paints the gray values of the image given in ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource into the image in ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination and returns the resulting image in MixedImageMixedImageMixedImageMixedImageMixedImagemixedImage. Only the gray values of the domain of ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource are copied (see reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain).

As an alternative to paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, you can use the operator overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray, which directly paints the gray values into ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination.

Parallelization

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

ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource (input_object) (multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / vector_field)

Input image containing the desired gray values.

ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination (input_object) (multichannel-)image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / vector_field)

Input image to be painted over.

MixedImageMixedImageMixedImageMixedImageMixedImagemixedImage (output_object) image → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real / complex / vector_field)

Result image.

Example (HDevelop)

* Copy a circular part of the image 'monkey' into the image 'fabrik':

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
read_image(Image2,'fabrik')
* Copy a part of the image 'monkey' into 'fabrik'
paint_gray(Mask,Image2,MixedImage)

Example (C)

/* Copy a circular part of the image 'monkey' into the image 'fabrik': */

read_image(&Image,"monkey");
gen_circle(&Circle,200.0,200.0,150.0);
reduce_domain(Image,Circle,&Mask);
read_image(&Image,"fabrik");
/* Copy a part of the image 'monkey' into 'fabrik' */
paint_gray(Mask,Image2,&MixedImage);

Example (HDevelop)

* Copy a circular part of the image 'monkey' into the image 'fabrik':

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
read_image(Image2,'fabrik')
* Copy a part of the image 'monkey' into 'fabrik'
paint_gray(Mask,Image2,MixedImage)

Example (HDevelop)

* Copy a circular part of the image 'monkey' into the image 'fabrik':

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
read_image(Image2,'fabrik')
* Copy a part of the image 'monkey' into 'fabrik'
paint_gray(Mask,Image2,MixedImage)

Example (HDevelop)

* Copy a circular part of the image 'monkey' into the image 'fabrik':

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
read_image(Image2,'fabrik')
* Copy a part of the image 'monkey' into 'fabrik'
paint_gray(Mask,Image2,MixedImage)

Example (HDevelop)

* Copy a circular part of the image 'monkey' into the image 'fabrik':

read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
read_image(Image2,'fabrik')
* Copy a part of the image 'monkey' into 'fabrik'
paint_gray(Mask,Image2,MixedImage)

Result

paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.