Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-painting

The brush engine behind luced-2d: Photoshop-style brushes with dynamics, sampled tips and textures, strokes stamped on the GPU a tile at a time, smudge on a worker, healing, and brush masks.

A library written in luce-base. Latest release 0.5.1.

Install#

luc add dymokomi/luce-painting

Documentation#

luce-painting

The brush engine behind luced-2d, in Luce Base on the GPU: Photoshop-style brushes with dynamics, sampled tips and textures, strokes stamped a tile at a time into luce-canvas tiles, smudge walked on a worker thread, spot healing's patch search, and the brush masks a tip or texture is made from.

It paints tiles, not documents: a PaintTarget names the tiles a stroke paints (a layer's pixels or its mask), the selection it stays inside and how its document mixes colors. luce-image finds those for a layer of its document and keeps the history.

Use

def dependency "luce-painting" {
    str owner = "dymokomi"
    str version = "^0.1.0"
}
ExportWhat it holds
paintBrush (Photoshop's brush settings), Painter (the dab, paint and gradient pipelines), gradient_tile
strokeStroke, PaintTarget, EffectSource (a retouching stroke's effect, made a cell at a time)
dynamicsDynamic, Control, Pen: what drives size, flow, angle and the rest per dab
brush_imagesBrushImages: a sampled tip and texture, mip-mapped for the dab's size
brush_maskBrushMask: a tip or texture being drawn, as coverage
mixingMixing: colors mixed as sRGB-encoded values, as Photoshop's are, or in linear light
smudgeWarpStroke: smudge on a CPU working copy, uploaded as it goes
healheal: the spot healing fill of a painted hole
from luce_painting.paint import Brush, Painter
from luce_painting.stroke import Stroke, PaintTarget

var painter = try Painter.create(device)
var stroke = try Stroke.begin(&painter, PaintTarget(tiles = &tiles), Brush(diameter = 40.0), 10.0, 10.0)
try stroke.extend(&painter, PaintTarget(tiles = &tiles), 200.0, 80.0)
try stroke.flush(&painter, PaintTarget(tiles = &tiles))
stroke.finish()

See docs/DESIGN.md for how a stroke becomes tiles.

Test

./test.sh runs every module's tests natively and through the C backend with the sibling luce-base checkout's compiler (--base picks another). GPU tests skip where no device opens.

The shaders are generated: after changing one, run

python3 ../luce-gpu/tools/embed_shaders.py --public -I ../luce-color/shaders src/shaders.lucb src/shaders/dab.frag src/shaders/paint.frag src/shaders/gradient.frag

srgb.glsl, the sRGB curve the paint and gradient passes mix through, is luce-color's, shared with luce-image's shaders.

License

MIT; see LICENSE.

Dependencies#

Versions#

0.5.1

Browse source · pack · commit db0e493b00f5

SHA-256 8876bb029d409100841b272560708d328381192b7901b44ae2f5168b39f45d80

dependencies name no version