Pixel data

painter.pixels (PainterPixels, pixels/pixel-data-creator.ts) exposes ImageData-style Uint8ClampedArray buffers (RGBA, SRGB tagged).

Accepts CanvasResults | Buffer (**PNG / raster bytes / embedded canvas surface).

#getData(canvasBuffer, options?)

Returns Promise<PixelData>:

1interface PixelData {2  data: Uint8ClampedArray;3  width: number;4  height: number;5  colorSpace?: 'srgb' | 'display-p3' | 'rec2020';6}

Optional { x, y, width, height } selects a sub-rectangle (bounds-checked vs decoded bitmap).

#setData(canvasBuffer, pixelData, options?)

Writes pixelData via putImageData.

Optional placement x, y, dirtyX, dirtyY, dirtyWidth, dirtyHeight for partial blit.

Returns new PNG Buffer.

#manipulate(canvasBuffer, options)

PixelManipulationOptions (types/pixels.ts):

Optional region limits read / write window when present.

#getColor / setColor

• getColor(buf, x, y) — single pixel via getData 1×1.
• setColor(buf, x, y, { r, g, b, a? }) — a defaults 255.

Both return Promise.

#Example

1const canvas = await painter.createCanvas({ width: 10, height: 10, color: '#fff' });2const region = await painter.pixels.getData(canvas, { x: 0, y: 0, width: 5, height: 5 });3const tinted = await painter.pixels.manipulate(canvas, {4  filter: 'brightness',5  intensity: 1.2,6});