bevy_post_process

Post-process effects: depth of field, chromatic aberration, motion blur (some), bloom (when not in bevy_core_pipeline), and other screen-space effects that run after the main pass.

Purpose

The crate hosts effects that:

• Run as render-graph nodes after the main 3D opaque/transparent passes.
• Need access to the depth or motion-vector prepass.
• Are not anti-aliasing (those are in bevy_anti_alias).

Some effects live in bevy_core_pipeline for historical reasons (bloom, tonemapping, MSAA writeback, motion blur, DOF). Newer / more peripheral effects accumulate here.

Directory layout

crates/bevy_post_process/src/
├── lib.rs                       # PostProcessPlugin
├── chromatic_aberration/        # Per-channel offset
├── post_process_pass.rs         # Shared full-screen pass utilities
└── (other effect-specific subdirs)

The exact set of effects varies by version; check crates/bevy_post_process/src/ for the current list.

Key abstractions

Type	File	Description
PostProcessPlugin	crates/bevy_post_process/src/lib.rs	Adds the post-process render-graph nodes.
ChromaticAberration	crates/bevy_post_process/src/chromatic_aberration/mod.rs	Per-camera CA component.

How it works

Each effect is one render-graph node + one fragment shader (the vertex stage is the standard full-screen triangle). The node samples the main color attachment, applies the effect, and writes to a destination texture. Blend / replace semantics follow the standard post-process pattern.

Cameras opt into an effect by adding the corresponding component.

Integration points

• Depends on: bevy_render, bevy_core_pipeline, bevy_camera.
• Depended on by: DefaultPlugins.

Entry points for modification

• New effect: new module + plugin + shader. Use chromatic_aberration/ as the template.
• Effect ordering: edit the render-graph edges in the plugin.

See also

• bevy_core_pipeline — bloom, tonemapping, motion blur, DOF.
• bevy_anti_alias — AA effects.