Colors and surfaces

Color

ARGB layout matches Wayland argb8888.

const render = @import("otter_render");

const c = try render.parseColor("#FF5500");
const faded = render.Color.white.withAlpha(128);

Color.parseHex accepts #RGB, #RGBA, #RRGGBB, #RRGGBBAA, and named colors.

Surface

Pixel buffer with drawing primitives:

var surface = render.Surface.fromPixels(&pixels, width, height);
surface.clear(render.Color.black);
surface.fillRect(.{ .x = 2, .y = 2, .width = 10, .height = 10 }, render.Color.red);
surface.drawRectOutline(rect, render.Color.white, 1);

subSurface returns a clipped view into a parent buffer. blitRowsVertical(dst_y, src_y, height) moves full-width physical pixel rows inside a surface. It handles overlapping ranges, stride, and clipping. otter-term uses it to scroll existing pixels before redrawing exposed rows.

HiDPI

var surface = render.Surface.fromPixelsScaled(&pixels, phys_w, phys_h, scale);
surface.fillRectLogical(logical_rect, color);
const phys = surface.toPhysicalRect(logical_rect);

Set scale on CommandList when recording logical coordinates for rasterization.

When to draw directly

Prefer CommandList and quad_renderer for app UI. Direct Surface calls still make sense in tests, one-off buffers, and legacy widget draw methods.

Getting Started

Libraries

Color

Surface

HiDPI

When to draw directly

​Color

​Surface

​HiDPI

​When to draw directly

Color

Surface

HiDPI

When to draw directly