AmbientLight

Fills the whole scene with flat, directionless light — the fill that lifts every surface out of pure black so shadowed areas stay readable.

Declarative element: <sk-ambient-light>

Global: available as sk.AmbientLight inside a scene <script>.

Remarks

Ambient light is the second kind of light in the scene: where the directional light is a sun with a direction, ambient light has none — it brightens every surface equally, whatever way it faces, standing in for the indirect bounce and skylight that would otherwise fill the shadows.

Key attributes. intensity sets how much fill is added (both intensity and color are animatable, so the fill can breathe through a day/night cycle), and color tints it. It has no direction, casts no shadows, and combines additively with the directional key light — so a little ambient on its own reads as flat and unshaded; its job is to complement a directional light, not replace it.

Related. Pair it with a sk-directional-light for the classic key + fill setup: the directional light gives shape and shadow, the ambient light keeps the shadow side from going fully dark.

Constructor

constructor(config?: { id?: string; intensity?: number; color?: ColorInput; x?: number; y?: number; z?: number; h?: number; p?: number; b?: number; quaternion?: Quaternion; sx?: number; sy?: number; sz?: number; s?: number; class?: string; style?: string })

Inherited from: SceneNode, SkenraAnimatable — see those pages for inherited members.

Properties

Config Properties

Other Properties

Methods

Example

// Create a typical lighting setup
const ambient = new AmbientLight({
  id: 'ambient',
  intensity: 0.3,
  color: 'white'
});

const sun = new DirectionalLight({
  id: 'sun',
  intensity: 0.7
});

const scene = new Scene();
scene.appendChild(ambient);
scene.appendChild(sun);

// Animate ambient intensity for day/night cycle
ambient.animate('daylight', [
  { offset: 0, intensity: 0.3 }, // Day
  { offset: 0.5, intensity: 0.05 }, // Night
  { offset: 1, intensity: 0.3 } // Day again
], { duration: 60000 });

↑ Documentation home · ← All classes