Skip to content
Image & Canvas canvasCompositeImage

$canvasCompositeImage[]

Unlike $canvasLoadImage, this function requires an existing canvas and always composites on top. Shape masks (circle, rounded, triangle, etc.) apply anti-aliased clipping — pixels outside the mask are fully transparent. The rounded:N and roundrect:N variants let you specify a corner radius in pixels (e.g., rounded:20). Blend modes use standard canvas compositing per the CSS spec.

Syntax

bdfd
$canvasCompositeImage[url;x;y;width;height;shape?;blend?;container?]

Examples

Composite Avatar on Background Canvas

$canvasCreate[banner;700;250;#181818]
$canvasCompositeImage[$authorAvatar;30;30;120;120;circle;source-over;banner]
$canvasDrawText[banner;Welcome $username!;180;90;26;#FFFFFF]
$attachImage[banner]
$sendMessage[Generated welcome card with your Discord avatar!]