ukiyoeBlocks.package
- ..
- .metadata171 B
- README.md2.6 KB
- block.yaml4.8 KB
This package holds more than this page lists. See all of its files in its world.
README.md
Tapering brush-cut line (styleBlock, Line)
A tapering line that swells and narrows along every edge like a knife following a brushed drawing: lively contours for robes, waves and running figures in a woodblock print.
Runs the shared carved key line pass (hangiLine.shader) with its own defaults, so it swaps with every other woodblock line with one change and settings keep their meaning: StyleKit.swap("line", "brushCutLine"). Settings: width, inner, ink, setInk, opacity, silhouette, crease, creaseAngle, contact, threshold, thinNear, thinFar, farWidth, fadeEnd, taper, cutPx, wear, wearPx, surfaceColour, colourDepth, steady, paperBreak, wobble. Low quality draws no colour contacts.
The carver follows the painter's brush: each stroke swells in its middle and narrows to a point at its ends.
Weight is varied the way a key block is cut: the outer contour (where depth jumps) is drawn at width, inner lines on folds, faces and hands at width x inner, and every line thins with distance. A style role multiplies the weight per object (the hero heavier, the crowd finer).
What it gives up in motion
Lines are found again every frame from depth and normals, so they stay on the edges they belong to under any pan, dolly or orbit, and a walking character's outline moves with it without crawling. Widths below about one drawn pixel fade instead of breaking into dashes, so far lines never shimmer. Taper and wear are laid on surface positions: on still things they hold exactly; on moving things they would slide, so on any object with a style role (give characters a role) they are calmed by steady. Nothing changes on its own over time.
How it treats content
- Opaque things: outlined, heavy outside and fine inside.
- Transparent things (glass, water): not in the depth, so they draw no line of their own; what is behind them is outlined.
- Particles and smoke: no line.
- Sky: no line; the horizon is outlined where land meets sky.
- Fog: lines thin and fade out with distance by
fadeEnd. - Skinned characters: outlined from depth every frame, steady while they walk; give them a role for an unbroken, heavier or lighter line.
- Foliage: leaves are outlined where they stand against something farther; dense foliage reads as a mass of fine lines far away and is faded by distance.
- World text: lines are drawn on its edges; exclude labels a player must read with
StyleKit.options({ exclude = { ... } }). - Black stays black: the line only darkens, and
sk_finishkeeps black black. - Dim rooms: lines only darken, so a dim room stays dim.