$canvasSetPixel

The $canvasSetPixel[x;y;color] function sets the color of a single pixel on the canvas at the specified coordinates.

Syntax

$canvasSetPixel[x;y;color]

Parameters

Parameter	Description
x	X coordinate of the pixel. 0 = the left edge of the canvas.
y	Y coordinate of the pixel. 0 = the top edge of the canvas.
color	Color to apply, in hexadecimal format (#RRGGBB) or color name (red, blue, etc.).

Return value

None. The pixel is modified directly on the canvas.

Behavior

• Coordinates outside the canvas boundaries are ignored (no error).
• The alpha channel of the pixel is kept as is.
• Works on any canvas previously created or loaded.

Examples

Single pixel

$canvasCreate[100;100]
$canvasSetPixel[50;50;#FF0000]
$attachCanvas[]
$sendMessage[🔴 Red pixel placed at the center!]

Draw a horizontal line

$canvasCreate[200;100]
$for[x;0;199;1]
  $canvasSetPixel[$for[x];50;#5865F2]
$endfor
$attachCanvas[]
$sendMessage[📏 Blue line drawn!]

Cross at the center

$canvasCreate[100;100]
$for[i;30;70;1]
  $canvasSetPixel[$for[i];50;#FF0000]
  $canvasSetPixel[50;$for[i];#FF0000]
$endfor
$attachCanvas[]
$sendMessage[➕ Red cross drawn!]

Draw where the user clicks (interaction)

$canvasSetPixel[$mouseX;$mouseY;$message[1]]
$attachCanvas[]

Notes

• Coordinates start at 0 (not 1).
• To fill an entire area, use $canvasFill[] or $canvasDrawRect[].
• To read a pixel, use $canvasGetPixel[].
• Modifying many pixels one by one can be slow; prefer vector drawing functions.