ImagePaste
Syntax
ImagePaste( image1, image2 [, x] [, y] )
ImageDrawImage( image1, image2 [, x] [, y] )
Or as a member:
someImage.paste( imageToDraw [, x] [, y] )
someImage.drawImage( imageToDraw [, x] [, y] )
Arguments
image1
any
Yes
The base image to paste onto. Can be a BoxImage
object or image name.
image2
any
Yes
The image to paste. Can be a BoxImage
object or image name.
x
numeric
No
0
The x-coordinate where the image will be pasted.
y
numeric
No
0
The y-coordinate where the image will be pasted.
Returns
BoxImage
— The base image with the pasted image applied.
Description
Pastes one image (image2
) onto another (image1
) at the specified coordinates. Useful for combining images, adding watermarks, or overlaying graphics at precise locations.
Example
// Paste image2 onto image1 at (100, 50)
result = ImagePaste( image1, image2, 100, 50 );
// Using the alias
result = ImageDrawImage( image1, image2, 200, 75 );
// As a member function
image1.paste( image2, 10, 10 );
image1.drawImage( image2, 0, 0 );
Related BIFs
ImageOverlay
ImageCopy
ImageNew
Notes
Both
image1
andimage2
can beBoxImage
objects or the names of images in the current context.The default coordinates are (0, 0) if not specified.
The operation modifies the base image in place when used as a member function.
Returns the modified image object for chaining or further processing.
This BIF is also available as
ImageDrawImage
and as member functionspaste
anddrawImage
.
Was this helpful?