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

Name	Type	Required	Default	Description
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 and image2 can be BoxImage 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 functions paste and drawImage.
• Current implementation note: the BIF currently applies the x value to both axes, so y is effectively ignored.