panelPage.styleBlock
- .metadata145 B
- README.md2.6 KB
- block.yaml3.5 KB
README.md
Panel page (styleBlock, Medium)
Lays the game's view into comic panels with gutters and inked borders: splash pages, insets, tiers, slanted action panels and borderless bleeds, from one camera or with extra per-player views in their own panels. Set it up with the ComicPanels module (ComicPanels.setLayout("threeTier")), which writes every setting below for you; the block can also be tuned directly.
Settings: count, the panel corners p1a .. p6b, sources and sourcesB (which panel shows which view), gutter (warm white), border (near black), borderPx (3), borderStyle (0 clean), gutterPx (16), marginPx (22), and the extra views' print treatment viewInk (0.8), viewLevels (4), viewDots (0.6), viewMono (0), viewScreenPx (7).
The look stack runs only on the frame the player sees, never on a camera that renders into a texture (an engine limit, #17427), so an extra view cannot be drawn by the look's own blocks. This block gives extra views a print treatment of their own (flat tints, a dot screen in the shadows or black and white, and an ink edge), and ComicPanels picks the treatment to match the look in the stack.
What it gives up in motion
Panels, gutters and borders are fixed on the screen like the page itself, so nothing slides or flickers; the picture moves inside each panel. Brush and rough borders are drawn from a fixed pattern along each edge and never boil. The extra views are live cameras at the panel's own resolution (scaled by ComicPanels' viewScale), so they move with the player like the main view; their dot screen holds still on the screen.
How it treats content
- Opaque things: shown inside the panels; the gutters cover what lies under them.
- Transparent things (glass, water): shown as rendered inside the panels.
- Particles and smoke: shown as rendered; in extra views they get the view's print treatment.
- Sky: shown inside panels like everything else.
- Fog: shown as rendered.
- Skinned characters: shown inside panels; extra views frame the local player's own character.
- Foliage: shown as rendered; busy leaves in extra views get a busier ink edge.
- World text: world labels stay readable in the main view; in extra views small text gets the ink edge and may be hard to read.
- Black stays black: gutters are paper coloured by design (a page), but an unlit picture stays black inside its panel.
- Dim rooms: the panel page adds paper-coloured gutters around the picture, which is a frame and not light on the scene, so it does not ask for the dim guard.
- Screen UI: drawn after the stack, on top of the page, unchanged.