A shader so far worked only on its own wearer. Effects over the whole
game picture, such as a vignette, grey, scanlines or a red flash on a
hit, had no place to live. A camera now wears one, drawn the way a
field shader of a particle source is (#170).
- The camera gets a Shader row and, while one is picked, a Shader
resolution row. The shader's properties follow as camera rows. They
load, animate and appear in a Properties node under Type Camera.
- Every view keeps masks and objects in one container. CameraShade
renders it into the camera's picture, cleared to the background,
and draws the shader over the frame. Game tab and play.html take
the container off the stage while the picture stands in for it.
- Screen pixels gives the picture as many pixels as it covers on
screen. Camera pixels uses View width x View height and scales up
without smoothing.
- A pixel counts as a camera pixel in both (the user's choice). The
uniform uPixelScale makes Texture size read View width x View
height, so a Blur keeps its reach at any game scale.
- Each camera wears its own shader, overlay cameras included. A red
flash on the game camera leaves the HUD of an overlay camera alone.
- The scene view's eye has a Shader switch on the Camera row, off by
default. With it on, the main camera's shader lies over its frame,
below symbols and gizmos, and the world around it stays drawn.
- New tool tools/perf-camera-shader.mjs measures the cost.
Measured on stein2 (HD 630, Game tab at Fit 1310x679): a camera
shader that hands the picture through stays inside the scene's own
spread of 3 to 5 fps between runs. A Blur of 4 cost 4 to 8 fps.
Tests:
- Gate on melektaus-atx: 227 files, 3497 tests (3487 + 10).
- e2e 63 alone: 11 checks (6 + 5), e2e sum 1725 counted.
- 63e-63i: pass-through is byte-equal and upright at 100%, flat red
reaches the corners while the overlay keeps its green, Texture
size reads 640 x 360 in both resolutions at Fit, no shader draws
as before, and the scene view shows it only with the switch on.
- Counter-checks: a camera left out of the shader wearers fails 1
unit test. Counting screen pixels fails 63g with #ab6000.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
