Object3D → Light →

SpotLight

Этот свет излучается из одной точки в одном направлении, вдоль конуса, размер которого увеличивается тем больше, чем дальше от света он находится.

Этот свет может отбрасывать тени - подробности смотрите на странице SpotLightShadow.

Пример кода


    // white spotlight shining from the side, casting a shadow

    const spotLight = new v3d.SpotLight(0xffffff);
    spotLight.position.set(100, 1000, 100);

    spotLight.castShadow = true;

    spotLight.shadow.mapSize.width = 1024;
    spotLight.shadow.mapSize.height = 1024;

    spotLight.shadow.camera.near = 500;
    spotLight.shadow.camera.far = 4000;
    spotLight.shadow.camera.fov = 30;

    scene.add(spotLight);

Примеры

lights / spotlight
lights / spotlights

Конструктор

SpotLight(color : Integer, intensity : Float, distance : Float, angle : Radians, penumbra : Float, decay : Float)

color — (необязательно) шестнадцатеричный цвет света. По умолчанию 0xffffffff (белый).
intensity — (необязательно) числовое значение силы/интенсивности света. По умолчанию - 1.

distance — Максимальная дальность действия света. По умолчанию 0 (без ограничения).
angle — Максимальный угол рассеивания света от его направления, верхняя граница которого равна Math.PI/2.
penumbra — Процент конуса прожектора, который ослаблен из-за полутени. Принимает значения от нуля до 1. По умолчанию - ноль.
decay — Величина ослабления света в зависимости от расстояния до него.

Создает новый SpotLight.

Свойства

Общие свойства смотрите в базовом классе Light.

# .angle : Float

Максимальный размах прожектора, в радианах, от его направления. Должно быть не более Math.PI/2. По умолчанию Math.PI/3.

# .castShadow : Boolean

Если установить значение true, свет будет отбрасывать динамические тени. Предупреждение: Это дорого и требует настройки, чтобы тени выглядели правильно. Подробности смотрите в SpotLightShadow. По умолчанию используется значение false.

# .decay : Float

Величина ослабления света в зависимости от расстояния до него.
В режиме physically correct затухание = 2 приводит к физически реалистичному падению света. По умолчанию используется значение 1.

# .distance : Float

Default mode — Когда расстояние равно нулю, свет не ослабевает. Когда расстояние ненулевое, свет ослабевает линейно от максимальной интенсивности в положении света до нуля на данном расстоянии от света.

Physically correct режим — Когда расстояние равно нулю, свет будет ослабевать по закону обратного квадрата до бесконечного расстояния. Когда расстояние ненулевое, свет будет ослабевать по закону обратных квадратов до тех пор, пока не приблизится к отсечке расстояния, где он будет быстро и плавно ослабевать до 0. По своей сути, отсечки не являются физически корректными.

По умолчанию 0.0.

# .penumbra : Float

Процент конуса прожектора, который ослаблен из-за полутени. Принимает значения от нуля до 1. По умолчанию 0.0.

# .position : Vector3

Он устанавливается равным Object3D.DefaultUp (0, 1, 0), чтобы свет светил сверху вниз.

# .power : Float

Сила света.
В режиме physically correct световая мощность света, измеряемая в люменах. По умолчанию 4Math.PI.

Это напрямую связано с intensity в соотношении power = intensity * π и изменение этого параметра также изменит интенсивность.

# .shadow : SpotLightShadow

SpotLightShadow используется для расчета теней для этого света.

# .target : Object3D

Прожектор указывает из своего положения position на target.position. Позиция цели по умолчанию (0, 0, 0)..
Примечание: Чтобы изменить положение цели на любое, отличное от значения по умолчанию, необходимо добавить t в scene, используя scene.add(light.target); Это делается для того, чтобы matrixWorld цели автоматически обновлялся каждый кадр.

Также можно установить цель на другой объект в сцене (все, что имеет свойство position), например: const targetObject = new v3d.Object3D(); scene.add(targetObject); light.target = targetObject; Теперь прожектор будет отслеживать целевой объект.

Методы

Общие методы смотрите в базовом классе Light.

# .copy(source : SpotLight) → SpotLight

Копирует значения всех свойств из source в данный SpotLight.