Light Passes

A render is a single flattened image: once it is written you cannot change the lighting without rendering again. The light passes split that image into the parts it is made of, one per kind of light interaction, so a scene can be relit, recolored or re-composited after the fact from the same set of rendered frames. Cycles calls the specular passes “Glossy” throughout its interface.


Enabling them

Pass --config.include-diffuse-pass and/or --config.include-specular-pass to render them alongside the combined frame:

visionsim blender.render-animation scene.blend output/ \
    --config.include-diffuse-pass \
    --config.include-specular-pass

Every flag and render option works the same with blender.render-frame, which renders a single frame instead.

The passes land beside frames/ in one directory per pass, each with its own transforms.db describing that pass’s camera:

  • diffuse/direct, diffuse/indirect, diffuse/color

  • specular/direct, specular/indirect, specular/color

They are written as 32-bit EXR, because the values are linear light rather than display-ready color. Cycles and EEVEE name these differently; see the note under the diagram below.

By default the direct and indirect passes are denoised individually as they are saved, since they can be very noisy in dark regions, particularly at low sample counts. The color passes are never denoised, being noise-free by nature. Pass --config.diffuse-pass.no-denoise or --config.specular-pass.no-denoise to save them raw instead, and note that this only applies to Cycles.


The passes

Here, each pass is tone-mapped independently, so these show the structure each one carries rather than how bright it is relative to the others:

../_images/diffuse-direct.webp

Diffuse Direct

../_images/diffuse-indirect.webp

Diffuse Indirect

../_images/diffuse-color.webp

Diffuse Color

../_images/specular-direct.webp

Glossy Direct

../_images/specular-indirect.webp

Glossy Indirect

../_images/specular-color.webp

Glossy Color


Diffuse Direct is the light reaching surfaces straight from a source, and Diffuse Indirect is what has bounced off something else first. Their sum has no surface color in it at all: Diffuse Color supplies that, which is why it reads as a flat, unlit albedo map. The glossy passes follow the same split for reflections, and specular highlights are what the direct and indirect glossy passes isolate. Together these are combined to give you the final render:

../_images/combined.webp

Combined


How the passes combine

The individual passes add and multiply back into the combined image. The lighting passes are simply summed, since they are each a separate contribution to the same pixel. The color passes are not light at all but base color, so they are multiplied in: (diffuse direct + diffuse indirect) × diffuse color gives back the diffuse lighting of the final render, and the same holds for the glossy passes before the two are added together.

../_images/combine-cycles.svg

Cycles pass combination.

../_images/combine-eevee.svg

EEVEE pass combination.

Diagram from the Blender manual.

EEVEE does not separate direct from indirect light, nor support transmission passes, so it writes diffuse/light and specular/light alongside the two color passes instead of the three-way split shown for Cycles.


Caveats

Only the diffuse and glossy passes described above are available. Blender can also expose transmission, volume, emission and environment passes, but render-animation does not render those yet, so a scene that leans on glass or volumetrics needs them composited by hand in Blender.

Each pass is stored as a linear EXR at the render’s full resolution, so enabling them can take significant disk space, several times that of the frames themselves. Saving them as half-float or with a lighter codec brings that back down at some precision cost.

They are also unavailable from blender.render-playblast. The viewport renderer has no equivalent of Cycles’ light passes, so include_* flags are ignored and only the color preview is written.


See also