Log inGet started
Package

hairLine.styleBlock

README.md

Fine hairline (styleBlock, Line)

A fine, even hairline in a soft sumi grey, cut by a master carver: delicate outlines for faces, hair and quiet landscapes, and the few remaining lines of a shin-hanga 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", "hairLine"). 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.

Light enough to sit under the colour rather than over it; the line shin-hanga looks use.

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_finish keeps black black.
  • Dim rooms: lines only darken, so a dim room stays dim.