raygeo.image

Image processing functions for CNC engraving applications.

Provides sRGB/linear color space conversions, RGBA-to-grayscale/binary conversions with alpha unpremultiplication, grayscale normalization with auto-levels, dithering algorithms (error diffusion with serpentine scan, Bayer, newsprint and halftone screens, minimum run length) for converting grayscale images to binary output, and scanline rasterization for converting Ops scanlines into pixel buffers.

Functions

rasterize_scanlines()

rasterize_scanlines(
    ops: ops.Ops,
    width_px: int,
    height_px: int,
    px_per_mm: tuple[float, float],
    origin_mm: tuple[float, float] = (0, 0),
    radius_px: int = 0,
) -> compressed_array.CompressedArray

Rasterize ScanLine commands from ops into a 2D power-map buffer.

Iterates all scanline commands in ops, converts their mm coordinates to pixel space using px_per_mm, and returns a uint8 array where each pixel holds the maximum power value written to it.

When radius_px is greater than zero, each rasterized sample is expanded to a square brush of side 2*radius_px + 1 (max-merged), equivalent to a square morphological dilation of the thin raster. Coverage is bounds-clamped at the texture edges (no wraparound).

Parameter	Type	Description
ops	ops.Ops	Command sequence to rasterize.
width_px	int	Width of the output texture in pixels.
height_px	int	Height of the output texture in pixels.
px_per_mm	tuple[float, float]	(x, y) resolution in pixels per millimeter.
origin_mm	tuple[float, float] = (0, 0)	(x, y) origin offset in mm (default (0.0, 0.0)).
radius_px	int = 0	Half-size of the dilation brush in pixels (default 0 -- no dilation).
Returns	compressed_array.CompressedArray	CompressedArray of shape (height_px, width_px), uint8.
Complexity		O(scanline_pixels * (2*radius_px + 1))

Scanline ops rasterized into a 2D power-map buffer