AmbientLight

An ambient light source of fixed color and intensity that illuminates all Meshes equally.

• AmbientLight#color multiplies by PhongMaterial#ambient at each position of each ReadableGeometry surface.
• AmbientLight#color multiplies by LambertMaterial#color uniformly across each triangle of each ReadableGeometry (ie. flat shaded).
• AmbientLights, DirLights and PointLights are registered by their Component#id on Scene#lights.

Usage

In the example below we'll destroy the Scene's default light sources then create an AmbientLight and a couple of {@link @DirLight}s:

[Run this example]

import {Viewer, Mesh, buildTorusGeometry,
ReadableGeometry, PhongMaterial, Texture, AmbientLight} from "xeokit-sdk.es.js";

// Create a Viewer and arrange the camera

const viewer = new Viewer({
    canvasId: "myCanvas"
});

viewer.scene.camera.eye = [0, 0, 5];
viewer.scene.camera.look = [0, 0, 0];
viewer.scene.camera.up = [0, 1, 0];

// Replace the Scene's default lights with a single custom AmbientLight

viewer.scene.clearLights();

new AmbientLight(viewer.scene, {
     color: [0.0, 0.3, 0.7],
     intensity: 1.0
});

new DirLight(viewer.scene, {
     id: "keyLight",
     dir: [0.8, -0.6, -0.8],
     color: [1.0, 0.3, 0.3],
     intensity: 1.0,
     space: "view"
});

new DirLight(viewer.scene, {
     id: "fillLight",
     dir: [-0.8, -0.4, -0.4],
     color: [0.3, 1.0, 0.3],
     intensity: 1.0,
     space: "view"
});

new DirLight(viewer.scene, {
     id: "rimLight",
     dir: [0.2, -0.8, 0.8],
     color: [0.6, 0.6, 0.6],
     intensity: 1.0,
     space: "view"
});

// Create a mesh with torus shape and PhongMaterial

new Mesh(viewer.scene, {
     geometry: new ReadableGeometry(viewer.scene, buildSphereGeometry({
         center: [0, 0, 0],
         radius: 1.5,
         tube: 0.5,
         radialSegments: 32,
         tubeSegments: 24,
         arc: Math.PI * 2.0
     }),
     material: new PhongMaterial(viewer.scene, {
         ambient: [1.0, 1.0, 1.0],
         shininess: 30,
         diffuseMap: new Texture(viewer.scene, {
             src: "textures/diffuse/uvGrid2.jpg"
         })
     })
});

// Adjust the color of our AmbientLight

var ambientLight = viewer.scene.lights["myAmbientLight"];
ambientLight.color = [1.0, 0.8, 0.8];