Lighting and camera
Read blender-scene for the local session contract.
Tool names below use its capability mapping when the named interface is absent;
read only the relevant rows in blender-volatile.
Camera and broad lighting are solved before final detail. Cinematic light is a
hierarchy with controlled darkness: the craft is choosing what stays dark, not
adding lights. Typed tools first — bl_camera_frame_objects,
bl_create_three_point_rig, the narrow camera/light tools; bl_execute only
for what they cannot express (custom constraints, world nodes, light linking,
gobos, flags, reflection shaping).
Camera gate
Lighting an unresolved composition is wasted work, so the camera locks first:
- one explicit active camera, confirmed in scene state;
- subject target, lens, distance, height, and framing taken from the Scene
Passport;
- perspective chosen deliberately — wide lenses exaggerate depth, long ones
flatten it; extreme focal length is not a patch for wrong geometry;
- headroom, contact shadows, and silhouette separation preserved;
- camera motion built on semantic parent rigs (orbit, dolly, handheld), not an
opaque stack of keyed transforms;
- in dynamic-default scenes, camera movement only where it serves the brief,
with a stable rest and no move that hides form.
Record before lighting: focal subject, secondary focal point, the region
allowed to go darkest, foreground/background depth, and the visible or implied
light motivation. Then freeze the camera — a setup is camera-relative, and
moving the camera can turn a reverse key into flat frontal light.
One role at a time
Keep each lighting role in its own toggleable collection, and add nothing
without a named problem it solves:
- Baseline — render World-only and zero-World. Starting from black is a
diagnostic (it shows what each source contributes), not a look requirement.
- Structural key — one source sets exposure, form, shadow direction, and
the focal hierarchy. Side or reverse/upstage key is the safe cinematic
default because the camera sees both lit and shadow planes; a frontal key
is legitimate only when flat beauty/catalog/graphic light is the point.
- Fill — restore only the shadow information that must stay readable.
Fill that competes with the key for direction is a second key, which is a
failure, not a style.
- Separation and practicals — rim, background, and fixture-support
lights each answer a named problem. A visible emissive fixture may be
backed by a hidden helper light, but the helper must agree with it in
direction and color.
- Shaping — fix spill and composition with source angle, apparent size,
Area spread, Spot cone/blend, blockers, gobos, and negative fill before
raising power or adding sources.
- Atmosphere and grade — bounded fog/volume only when it reveals depth
or beam direction. Lock the view transform and exposure during A/B
comparisons. Glare and grading polish a hierarchy; they cannot create one
the lighting failed to build.
Names carry roles: LGT_key, LGT_fill, LGT_rim, LGT_practical_*,
LGT_background_*, FLAG_negative_*, GOBO_*. For every light record
purpose, motivation, target, camera_relation, expected_effect.
Direction, falloff, softness
- Aim the key by orbiting it around the subject while it stays pointed at the
focal target; judge the pool of light and the shadows the camera actually
sees.
- Shoot from the key side unless silhouette/rim is the point — a hero angle
taken from the shadow side is carried by fill alone and reads washed out.
- Softness is apparent angular size, roughly
source_size / source_distance:
big and close gives broad gradients, small and far reveals texture and
hardens shadows.
- Point and Spot follow inverse square: moving a source from
d1 to d2
needs about power × (d2/d1)² to hold the same direct illumination. Area
lights deviate in the near field; a Sun has no positional falloff at all —
only angle matters.
- A close source gives deliberate focal falloff; a distant one gives even
product illumination. Decide per shot — there is no universal three-point
recipe.
- Balance key against fill by looking at the rendered subject. Raw power
ratios do not transfer across light types, sizes, distances, exposures, or
scene scales; one to three stops under key is a starting point, not a rule.
- Keep cast shadows unless a shadowless technical/stylized look is explicitly
the brief.
World, HDRI, visible background
- Rotate an HDRI for useful shadow direction and reflections, not for the
prettiest background; keep it weak enough that it cannot erase the authored
key.
- Sunny and golden-hour exteriors want a lateral or low Sun/HDRI so terrain
and subjects show both lit and shadow planes.
- The visible sky and the scene key must tell the same story. Splitting the
background (card or emissive sky) from the lighting is allowed for control,
but its edges, reflections, and apparent sun direction get audited.
- Overcast is not an excuse for a flat frame: physically uniform ambience may
still need negative fill or a broad directional key to hold the focal
hierarchy.
- Park alternative setups in named collections —
LIGHTING_Day,
LIGHTING_GoldenHour, LIGHTING_Night — instead of destroying an accepted
option.
Shaping tools: gobos, flags, negative fill
- Shape coverage with Area spread or Spot size/blend. A nonzero Spot radius
avoids mathematically sharp shadows unless that look is requested.
- Flags and blockers cut spill or imply windows and openings; black cards
subtract world or reflection fill.
- A gobo is composition, not decoration: leaf breakup, window patterns,
caustic-like motion, and irregular pools must support the environment and
the focal path. Random noise is not automatically cinematic.
- Off-camera cards, blockers, and sky planes are cheats, and cheats leak:
audit every delivery camera, animated frame, glossy reflection, and shadow
for their exposure.
- In Cycles, a bright pool can become a motivated bounce source. Verify
colored indirect light and its noise in a production render; viewport
denoising is not proof.
Product and commercial lighting
For glass, metal, polished plastic, bottles, speakers, packaging: reflections
are lit as deliberately as the diffuse surface.
- Lock camera and product orientation.
- Establish silhouette and contact with broad light/dark value regions.
- Move large rectangular Area lights or bright cards while watching the
shape of the reflected highlight, not just diffuse brightness.
- Place black cards between highlight bands to describe curvature and edges.
- Grazing light for texture; long vertical highlights for cylinders; glass
stays readable through controlled bright and dark reflection bands.
- A restrained label/logo light comes only after material and silhouette
read.
- Keep hero illumination separate from background gradients and gobos.
- Audit branding, clipped highlights, card reflections, and highlight
continuity across every turntable/camera angle.
Night and atmosphere
- Start with subtle sky/world ambience plus one key — moon, window, or street
source. Ambience lifts shadows; it must not complete the exposure by itself.
- Reinforce an implied moon or practical with a local Area/Spot only while its
direction and hue stay coherent with that source.
- Warm practicals against a cool sky is a convention, not a law; saturated
color needs a plausible artificial source or an openly stylized brief.
- Fog is bounded and local, starting near zero density, raised only until
depth layers or beams become legible. Fog that uniformly milks the frame or
eats focal contrast gets rejected.
- Only lit surfaces read at night. Frame the practicals themselves — heads,
lamps, the pools under them — into the shot; a correct composition of unlit
material carries nothing.
Lighting audit
- Render World-only, zero-World, key-only, and each added role in isolation:
every source must solve the problem it was recorded for.
- Toggle fill — it may recover information, never redesign direction.
- Read a grayscale render for focal hierarchy, silhouette separation,
contact, and shadow-plane legibility.
- Check highlight clipping, black crush, spill, shadow direction, practical
motivation, and background consistency.
- Inspect glossy surfaces for leaked flags, cards, lights, and sky-plane
edges, and for broken product highlights.
- Compare atmosphere on/off; volume that weakens the focal subject loses.
- Judge from a production-camera render with fixed exposure and view
transform. For colored bounce, volumes, or reflection-critical work verify
in Cycles when practical, even if EEVEE ships.
- For motion, inspect opening, midpoint, peak, and rest frames for
camera/key continuity, moving gobo/blocker artifacts, and stable product
reflections.
- Keep the previously accepted preview for A/B.
Numeric state approves nothing. View the renders.
Proof
Iterate composition with low-resolution local bl_render output. For a
dynamic scene, view sampled camera renders covering at least the opening,
a motion midpoint, and the final/rest frame; assembling a contact sheet is
optional. Keep view transform and exposure fixed across light-isolation
comparisons and restore temporary render state. Use blender-volatile for
engine/schema differences; this background session has no viewport.
If the existing file's active camera, resolution, render engine, or exposure
looks intentional, changing it silently is forbidden — record the change in
the Scene Passport and the final report.
Technical caveats
- Real metre scale comes before tuning power or falloff; copied watt values
are not presets.
- On new Blender 5.x scenes AgX is a sensible default, but an intentional
existing color-management setup is preserved.
- Cycles MIS settings control sampling and noise; they do not hide a
light from reflections. Use ray visibility or light linking for that.
- A camera inside geometry can cost tens of times the render time from
near-field bounces. A suddenly slow frame means check the camera before
touching sample counts.
- Swapping a hero asset invalidates every camera set against its old shell. A
replacement sitting lower or narrower puts the lens inside geometry.
Re-verify placement and near clipping per camera after any swap.
- Large emissive backdrop geometry must be camera-visible only: an emissive
sky/atmosphere shell becomes an area light every shading point
importance-samples. Set
visible_diffuse/glossy/transmission/volume_scatter/shadow = False on
backdrop shells and skyboxes.
- When combining World contributions, prefer two
Background nodes into an
Add Shader over a Mix node — the Mix node's duplicate "Factor" sockets
can silently drop a branch.
- Reverse key, black-World starts, warm/cool contrast, sky cards, off-camera
blockers — workflows, not laws. The Scene Passport and viewed reference
decide when each applies.
1---2name: blender-lighting-camera3description: Camera gate first, then motivated one-role-at-a-time lighting — direction/falloff/softness, world/HDRI, product and night setups, shaping with gobos/flags/negative fill, and the lighting audit.4---56# Lighting and camera78Read [blender-scene](../blender-scene/SKILL.md) for the local session contract.9Tool names below use its capability mapping when the named interface is absent;10read only the relevant rows in [blender-volatile](../blender-volatile/SKILL.md).1112Camera and broad lighting are solved before final detail. Cinematic light is a13hierarchy with controlled darkness: the craft is choosing what stays dark, not14adding lights. Typed tools first — `bl_camera_frame_objects`,15`bl_create_three_point_rig`, the narrow camera/light tools; `bl_execute` only16for what they cannot express (custom constraints, world nodes, light linking,17gobos, flags, reflection shaping).1819## Camera gate2021Lighting an unresolved composition is wasted work, so the camera locks first:2223- one explicit active camera, confirmed in scene state;24- subject target, lens, distance, height, and framing taken from the Scene25 Passport;26- perspective chosen deliberately — wide lenses exaggerate depth, long ones27 flatten it; extreme focal length is not a patch for wrong geometry;28- headroom, contact shadows, and silhouette separation preserved;29- camera motion built on semantic parent rigs (orbit, dolly, handheld), not an30 opaque stack of keyed transforms;31- in dynamic-default scenes, camera movement only where it serves the brief,32 with a stable rest and no move that hides form.3334Record before lighting: focal subject, secondary focal point, the region35allowed to go darkest, foreground/background depth, and the visible or implied36light motivation. Then freeze the camera — a setup is camera-relative, and37moving the camera can turn a reverse key into flat frontal light.3839## One role at a time4041Keep each lighting role in its own toggleable collection, and add nothing42without a named problem it solves:43441. **Baseline** — render World-only and zero-World. Starting from black is a45 diagnostic (it shows what each source contributes), not a look requirement.462. **Structural key** — one source sets exposure, form, shadow direction, and47 the focal hierarchy. Side or reverse/upstage key is the safe cinematic48 default because the camera sees both lit and shadow planes; a frontal key49 is legitimate only when flat beauty/catalog/graphic light is the point.503. **Fill** — restore only the shadow information that must stay readable.51 Fill that competes with the key for direction is a second key, which is a52 failure, not a style.534. **Separation and practicals** — rim, background, and fixture-support54 lights each answer a named problem. A visible emissive fixture may be55 backed by a hidden helper light, but the helper must agree with it in56 direction and color.575. **Shaping** — fix spill and composition with source angle, apparent size,58 Area spread, Spot cone/blend, blockers, gobos, and negative fill before59 raising power or adding sources.606. **Atmosphere and grade** — bounded fog/volume only when it reveals depth61 or beam direction. Lock the view transform and exposure during A/B62 comparisons. Glare and grading polish a hierarchy; they cannot create one63 the lighting failed to build.6465Names carry roles: `LGT_key`, `LGT_fill`, `LGT_rim`, `LGT_practical_*`,66`LGT_background_*`, `FLAG_negative_*`, `GOBO_*`. For every light record67`purpose`, `motivation`, `target`, `camera_relation`, `expected_effect`.6869## Direction, falloff, softness7071- Aim the key by orbiting it around the subject while it stays pointed at the72 focal target; judge the pool of light and the shadows the camera actually73 sees.74- Shoot from the key side unless silhouette/rim is the point — a hero angle75 taken from the shadow side is carried by fill alone and reads washed out.76- Softness is apparent angular size, roughly `source_size / source_distance`:77 big and close gives broad gradients, small and far reveals texture and78 hardens shadows.79- Point and Spot follow inverse square: moving a source from `d1` to `d2`80 needs about `power × (d2/d1)²` to hold the same direct illumination. Area81 lights deviate in the near field; a Sun has no positional falloff at all —82 only `angle` matters.83- A close source gives deliberate focal falloff; a distant one gives even84 product illumination. Decide per shot — there is no universal three-point85 recipe.86- Balance key against fill by looking at the rendered subject. Raw power87 ratios do not transfer across light types, sizes, distances, exposures, or88 scene scales; one to three stops under key is a starting point, not a rule.89- Keep cast shadows unless a shadowless technical/stylized look is explicitly90 the brief.9192## World, HDRI, visible background9394- Rotate an HDRI for useful shadow direction and reflections, not for the95 prettiest background; keep it weak enough that it cannot erase the authored96 key.97- Sunny and golden-hour exteriors want a lateral or low Sun/HDRI so terrain98 and subjects show both lit and shadow planes.99- The visible sky and the scene key must tell the same story. Splitting the100 background (card or emissive sky) from the lighting is allowed for control,101 but its edges, reflections, and apparent sun direction get audited.102- Overcast is not an excuse for a flat frame: physically uniform ambience may103 still need negative fill or a broad directional key to hold the focal104 hierarchy.105- Park alternative setups in named collections — `LIGHTING_Day`,106 `LIGHTING_GoldenHour`, `LIGHTING_Night` — instead of destroying an accepted107 option.108109## Shaping tools: gobos, flags, negative fill110111- Shape coverage with Area spread or Spot size/blend. A nonzero Spot radius112 avoids mathematically sharp shadows unless that look is requested.113- Flags and blockers cut spill or imply windows and openings; black cards114 subtract world or reflection fill.115- A gobo is composition, not decoration: leaf breakup, window patterns,116 caustic-like motion, and irregular pools must support the environment and117 the focal path. Random noise is not automatically cinematic.118- Off-camera cards, blockers, and sky planes are cheats, and cheats leak:119 audit every delivery camera, animated frame, glossy reflection, and shadow120 for their exposure.121- In Cycles, a bright pool can become a motivated bounce source. Verify122 colored indirect light and its noise in a production render; viewport123 denoising is not proof.124125## Product and commercial lighting126127For glass, metal, polished plastic, bottles, speakers, packaging: reflections128are lit as deliberately as the diffuse surface.1291301. Lock camera and product orientation.1312. Establish silhouette and contact with broad light/dark value regions.1323. Move large rectangular Area lights or bright cards while watching the133 shape of the reflected highlight, not just diffuse brightness.1344. Place black cards between highlight bands to describe curvature and edges.1355. Grazing light for texture; long vertical highlights for cylinders; glass136 stays readable through controlled bright and dark reflection bands.1376. A restrained label/logo light comes only after material and silhouette138 read.1397. Keep hero illumination separate from background gradients and gobos.1408. Audit branding, clipped highlights, card reflections, and highlight141 continuity across every turntable/camera angle.142143## Night and atmosphere144145- Start with subtle sky/world ambience plus one key — moon, window, or street146 source. Ambience lifts shadows; it must not complete the exposure by itself.147- Reinforce an implied moon or practical with a local Area/Spot only while its148 direction and hue stay coherent with that source.149- Warm practicals against a cool sky is a convention, not a law; saturated150 color needs a plausible artificial source or an openly stylized brief.151- Fog is bounded and local, starting near zero density, raised only until152 depth layers or beams become legible. Fog that uniformly milks the frame or153 eats focal contrast gets rejected.154- Only lit surfaces read at night. Frame the practicals themselves — heads,155 lamps, the pools under them — into the shot; a correct composition of unlit156 material carries nothing.157158## Lighting audit1591601. Render World-only, zero-World, key-only, and each added role in isolation:161 every source must solve the problem it was recorded for.1622. Toggle fill — it may recover information, never redesign direction.1633. Read a grayscale render for focal hierarchy, silhouette separation,164 contact, and shadow-plane legibility.1654. Check highlight clipping, black crush, spill, shadow direction, practical166 motivation, and background consistency.1675. Inspect glossy surfaces for leaked flags, cards, lights, and sky-plane168 edges, and for broken product highlights.1696. Compare atmosphere on/off; volume that weakens the focal subject loses.1707. Judge from a production-camera render with fixed exposure and view171 transform. For colored bounce, volumes, or reflection-critical work verify172 in Cycles when practical, even if EEVEE ships.1738. For motion, inspect opening, midpoint, peak, and rest frames for174 camera/key continuity, moving gobo/blocker artifacts, and stable product175 reflections.1769. Keep the previously accepted preview for A/B.177178Numeric state approves nothing. View the renders.179180## Proof181182Iterate composition with low-resolution local bl_render output. For a183dynamic scene, view sampled camera renders covering at least the opening,184a motion midpoint, and the final/rest frame; assembling a contact sheet is185optional. Keep view transform and exposure fixed across light-isolation186comparisons and restore temporary render state. Use blender-volatile for187engine/schema differences; this background session has no viewport.188189If the existing file's active camera, resolution, render engine, or exposure190looks intentional, changing it silently is forbidden — record the change in191the Scene Passport and the final report.192193## Technical caveats194195- Real metre scale comes before tuning power or falloff; copied watt values196 are not presets.197- On new Blender 5.x scenes AgX is a sensible default, but an intentional198 existing color-management setup is preserved.199- Cycles MIS settings control sampling and noise; they do **not** hide a200 light from reflections. Use ray visibility or light linking for that.201- A camera inside geometry can cost tens of times the render time from202 near-field bounces. A suddenly slow frame means check the camera before203 touching sample counts.204- Swapping a hero asset invalidates every camera set against its old shell. A205 replacement sitting lower or narrower puts the lens inside geometry.206 Re-verify placement and near clipping per camera after any swap.207- Large emissive backdrop geometry must be camera-visible only: an emissive208 sky/atmosphere shell becomes an area light every shading point209 importance-samples. Set210 `visible_diffuse/glossy/transmission/volume_scatter/shadow = False` on211 backdrop shells and skyboxes.212- When combining World contributions, prefer two `Background` nodes into an213 `Add Shader` over a Mix node — the Mix node's duplicate "Factor" sockets214 can silently drop a branch.215- Reverse key, black-World starts, warm/cool contrast, sky cards, off-camera216 blockers — workflows, not laws. The Scene Passport and viewed reference217 decide when each applies.