Custom Command

$imageDraw

Draws a loaded image onto the current image. This allows you to composite images together.

Usage

$imageDraw[image name;x;y;width;height;opacity]

Parameters:

  • image name: The name of the image you loaded using $imageLoad or $imageLoadFromURL. This name acts as a reference to the image you want to draw.
  • x: The x-coordinate of the top-left corner where the image will be drawn.
  • y: The y-coordinate of the top-left corner where the image will be drawn.
  • width: The width of the image to be drawn. If different from the original image width, the image will be scaled.
  • height: The height of the image to be drawn. If different from the original image height, the image will be scaled.
  • opacity: (Optional) The opacity of the image, ranging from 0 (fully transparent) to 1 (fully opaque). If not specified, the image will be drawn with full opacity (1).

Position: X & Y

For more detailed information on how X and Y coordinates work within image manipulation, please see: Position (X & Y)

Size: Width & Height

For more detailed information on how Width and Height work within image manipulation (including scaling), please see: Size (Width & Height)

Example:

This example creates a 300x300 image, loads the author's avatar, draws it onto the created image, and then outputs the result.

Member04/23/2025
!!exec $imageCreate[300;300] // Create Image Frame
$imageLoadFromURL[avatar;$replaceText[$authorAvatar;webp;png]] // Load Avatar as "avatar"
$imageDraw[avatar;0;0;300;300] // Draw "avatar" at (0,0) with width 300 and height 300
$image[$imageOutput]

Custom Command Bot 04/23/2025