sanspie
5eb1832907
ci-platforms / darwin amd64 smoke (push) Skipped
ci / build (amd64, linux, ubuntu-24.04) (push) Failing after 15m28s
ci / release (push) Skipped
ci-platforms / windows amd64 smoke (push) Skipped
ci-platforms / darwin arm64 smoke (push) Skipped
ci / checks (push) Successful in 7m47s
35 lines
3.6 KiB
Markdown
35 lines
3.6 KiB
Markdown
---
|
||
id: render2d.PostProcess
|
||
icon: comp.camera2d
|
||
group: rendering
|
||
order: 6
|
||
title: Camera post-processing
|
||
try: try/postfx/CameraOutput.aescene
|
||
try_select: render2d.PostProcess
|
||
---
|
||
# Camera post-processing
|
||
|
||
Run the example, focus Game View and press Space to cycle through Bloom, Color Grading, Vignette, Chromatic Aberration, Pixelate, CRT, a custom colour filter and the original image. The example includes a prepared linear identity LUT and its own material. Saturation makes grading visible even with the identity LUT.
|
||
|
||
## Add a glow to the platformer
|
||
|
||
Open the main scene of examples/platformer. Select Camera and expand Post Process. Its Bloom instance uses Threshold 0.75, Intensity 0.22 and Radius 6. Lower Threshold to pick up more bright surfaces. Increase Radius to spread the light over more pixels. Compare the lamp and its sparks with the stack disabled. Open Settings in the game to check that its text remains sharp. The lamp uses its Light2D for neighbouring surfaces and Bloom for the halo on screen.
|
||
|
||
The stack runs once after the cameras sharing a logical output finish drawing the world. Enable the component on one contributing camera. Scene-linear effects run before exposure and tone mapping. Display-linear effects run after that conversion and before final encoding. Reorder effects within the compatible phase. A linear offscreen output keeps its scene-linear values. Bloom and colour separation require opaque coverage in this renderer.
|
||
|
||
## Reuse a colour filter
|
||
|
||
Add Custom Material and choose a material backed by a shader with `#pragma postfx`. The editable example is `examples/platformer/assets/postfx/cold.aemat`. Enable the effect after assigning the material. It reads the previous effect through `aego_sample(aego_uv)`. Save the material, shader and scene and open a standalone export to verify the result. The camera also carries a disabled Color Grading entry with a LUT. LUTs are standalone linear data strips, 256×16 or 1024×32.
|
||
|
||
Animation and Tween address a numeric field by instance ID, for example `render2d.PostProcess.ef120d00000000000000000000000002:Intensity` on the platformer's camera. Reordering an effect preserves that target. Duplicating creates an independent target. Undo restores a removed instance and its ID.
|
||
|
||
## Materials in the demo games
|
||
|
||
Open `examples/platformer/assets/materials/character_flash_lit.aeshader` to see how a surface combines forward lighting, the current sprite normal and a per-instance Flash parameter. The Hurt clip animates the Flash parameter of the player’s material override. Other sprites sharing the material retain their own overrides. For an outline on selection, assign the built-in Outline material to the selected sprite, retain its previous material and restore that material on deselection. In examples/topdown the player's Torch is a Spot light whose orientation follows the same aim as the sword. The floor and walls receive its light.
|
||
|
||
## Inspect a pass or edit a camera from a tool
|
||
|
||
In the Lighting profiler, open **Inspect output passes** and select the output. With Bloom enabled, locate bright extraction, both blur directions and composite. Disable the stack and inspect the next frame. A timing entry appears when the driver returns a valid sample. A window target reports its drawing size, while a texture target also exposes its storage format.
|
||
|
||
Use `aego postfx get scenes/main.aescene Camera` to inspect the instance IDs. In the platformer, `aego postfx set scenes/main.aescene Camera ef120d00000000000000000000000002 Intensity 0.35` changes the existing Bloom. The same commands are available as MCP tools. In a bound editor session a write uses the active document and its Undo history.
|