Name
overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray — Overpaint the gray values of an image.
overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray copies the gray values of the image given
in ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource into the image in
ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination. Only the gray values of the domain of
ImageSourceImageSourceImageSourceImageSourceImageSourceimageSource are copied (see reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain).
If you do not want to modify ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination itself, you can use
the operator paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray, which returns the result in a newly created
image.
overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray modifies the content of an already existing image
(ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination). Besides, even other image objects may be
affected: For example, if you created ImageDestinationImageDestinationImageDestinationImageDestinationImageDestinationimageDestination via
copy_objcopy_objCopyObjcopy_objCopyObjCopyObj from another image object (or vice versa),
overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray will also modify the image matrix of this other image
object. Therefore, overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray should only be used to overpaint
newly created image objects. Typical operators for this task are, e.g.,
gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst (creates a new image with a specified size),
gen_image_protogen_image_protoGenImageProtogen_image_protoGenImageProtoGenImageProto (creates an image with the size of a specified
prototype image) or copy_imagecopy_imageCopyImagecopy_imageCopyImageCopyImage (creates an image as the copy of
a specified image).
- 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:
The value of this parameter may not be shared across multiple threads without external synchronization.
Input image to be painted over.
Input image containing the desired gray values.
* Copy a circular part of the image 'monkey' into a new image (New1):
read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)
/* Copy a circular part of the image 'monkey' into a new image (New1): */
read_image(&Image,"monkey");
gen_circle(&Circle,200.0,200.0,150.0);
reduce_domain(Image,Circle,&Mask);
/* New image with black (0) background */
gen_image_proto(Image,&New1,0.0);
/* Copy a part of the image 'monkey' into New1 */
overpaint_gray(New1,Mask);
* Copy a circular part of the image 'monkey' into a new image (New1):
read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)
* Copy a circular part of the image 'monkey' into a new image (New1):
read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)
* Copy a circular part of the image 'monkey' into a new image (New1):
read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)
* Copy a circular part of the image 'monkey' into a new image (New1):
read_image(Image,'monkey')
gen_circle(Circle,200,200,150)
reduce_domain(Image,Circle,Mask)
* New image with black (0) background
gen_image_proto(Image,New1,0.0)
* Copy a part of the image 'monkey' into New1
overpaint_gray(New1,Mask)
overpaint_grayoverpaint_grayOverpaintGrayoverpaint_grayOverpaintGrayOverpaintGray returns 2 (H_MSG_TRUE) if all parameters are
correct. If necessary, an exception is raised.
read_imageread_imageReadImageread_imageReadImageReadImage,
gen_image_constgen_image_constGenImageConstgen_image_constGenImageConstGenImageConst,
gen_image_protogen_image_protoGenImageProtogen_image_protoGenImageProtoGenImageProto
get_image_pointer1get_image_pointer1GetImagePointer1get_image_pointer1GetImagePointer1GetImagePointer1,
paint_graypaint_grayPaintGraypaint_grayPaintGrayPaintGray,
set_grayvalset_grayvalSetGrayvalset_grayvalSetGrayvalSetGrayval,
copy_imagecopy_imageCopyImagecopy_imageCopyImageCopyImage
paint_regionpaint_regionPaintRegionpaint_regionPaintRegionPaintRegion,
overpaint_regionoverpaint_regionOverpaintRegionoverpaint_regionOverpaintRegionOverpaintRegion
Foundation