dymokomi/luce-canvas
The canvas engine for Luce image editors: documents as immutable, shared 256-pixel GPU tiles, built to keep very large canvases fast.
A library written in luce-base. Latest release 0.5.1.
Install#
luc add dymokomi/luce-canvasDocumentation#
luce-canvas
The canvas engine for Luce image editors. A document's pixels live here as 256 × 256 tiles that never change once made: copies share them, a change makes a new tile, and undo is keeping the old ones.
luce-canvas is being built to keep very large canvases (15000 × 24000 and beyond) fast on ordinary machines. The design is in luced-2d's docs/design/CANVAS-ENGINE.md.
Modules
-
tiles:Tiles, a layer's grid of shared tiles over its extent, with the cells kept past the canvas. Each tile lives on the GPU, in RAM, or both, and a governor keeps both within budgets:residency_configure(device, usage)budgets a share of the device's and the machine's memory;residency_advance()starts a frame (tiles handed out since are pinned);residency_begin_marking()andresidency_mark_live(tiles)say what documents show;residency_settle(device)moves the least wanted tiles to RAM;tile_texture(device)makes a tile, making room when the device is full;residency_report()tells what each tier holds.
wake:set_wake(callback)registers what wakes the app's frame loop (its window's wake) andwake_frames()calls it from any thread, so work finished on a worker is taken in at once; the engine never talks to a window.pool: the engine's one set of worker threads, started on first use and kept for the process.run(count, entry, context, limit)runsentry(context, i)for everyiwith the caller working too, so batches started inside batches finish;start(job, ...),finished(job)andwait(job)put a batch out in the background (tile prefetch) and collect it.half: IEEE 754 binary16 conversion forrgba16_floattexels.pyramid: a store's coarser levels, averaged in premultiplied space, keyed by content and made on demand.cache: derived tiles by content key within a byte budget.keymap: the hash table behind the cache.
Testing
./test.sh
This runs every module's tests on the native and C backends. GPU tests skip themselves where no device opens.
Dependencies#
| Package | Version |
|---|---|
| dymokomi/luce-gpu | newest |
| dymokomi/luce-raster | newest |
| dymokomi/luce-std | newest |
Versions#
0.5.1
Browse source · pack · commit 5be3e8270260
SHA-256 88995e49d68f388e2ebba30d9befc43a6860f934dcc0bfc1eba83ea01461c81a
dependencies name no version