Класс LightBase

public abstract sealed class LightBase extends Node permits AmbientLight, DirectionalLight, PointLight

Класс LightBase является базовым классом для всех объектов, представляющих источник света. Все типы света имеют общие свойства, определённые в этом классе:

• color — цвет источника света
• scope — список узлов, на которые влияет источник света
• exlusionScope — список узлов, на которые источник света не влияет

В дополнение к этим свойствам, каждый тип света поддерживает свой собственный набор свойств, обобщённый в следующей таблице:

Сводка типов света по атрибутам

Тип света	Вращение и направление	Расположение и затухание
AmbientLight	✗	✗
DirectionalLight	✓	✗
PointLight	✗	✓
SpotLight*	✓	✓

* Поддерживает коэффициенты затухания прожекторов, как описано в документации к классу.

Все типы света не подвержены воздействию преобразований масштабирования и сдвига.

Цвет

Источник света испускает свет одного цвета. Внешний вид объекта, освещённого светом, является результатом цвета света и материала, из которого сделан объект. Например, для синего света белый объект будет казаться синим, чёрный — чёрным, а объект цвета (255, 0, 255) — синим, так как свет «выбирает» только синий компонент цвета материала. Математическое определение взаимодействия материала и света доступно в PhongMaterial.

См. также раздел заметки по реализации.

Области действия

Свет имеет список scope и список exclusionScope, определяющие, какие узлы освещаются им, а какие нет. Узел может находиться только в одном из списков: если он добавлен в один, он молча удаляется из другого. Если узел не находится ни в одном списке, он наследует свойство освещения от своего родителя, рекурсивно. Исключением из этого правила является свет с пустым списком scope, который неявно освещает все узлы в своей сцене/подсцене (кроме тех, которые находятся в его списке exlusionScope), как если бы корень сцены находился в списке scope.

Список exlusionScope полезен только для узлов, которые в противном случае находились бы в области действия света. Исключение узла — удобная альтернатива обходу иерархии дерева сцен и добавлению всех других узлов в область действия света. Вместо этого область действия может оставаться широкой, а отдельные узлы могут быть исключены с помощью списка исключения.

Направление

Направление света определяется свойством вектора direction света. Направление света можно повернуть, установив преобразование поворота на свете. Например, если вектор направления равен (1, 1, 1), а свет не повернут, он будет направлен в направлении (1, 1, 1), а если свет повернут на 90 градусов по оси y, он будет направлен в направлении (1, 1, -1).

Типы света, у которых нет направления, не подвергаются влиянию преобразований поворота.

Затухание по расстоянию

Любой пиксель в пределах действия света будет освещаться им (если он не принадлежит узлу Shape3D вне его области действия). Расстояние измеряется от позиции света до позиции пикселя и проверяется, находится ли оно в пределах максимальной дальности света, как определено его свойством maxRange. Позицию света можно изменить, установив преобразование трансляции на свете.

Интенсивность света можно настроить, изменяя её с расстоянием, используя затухание.

Формула затухания

attn = 1 / (ca + la * dist + qa * dist^2)

определяет 3 коэффициента: ca, la и qa, которые управляют постоянным, линейным и квадратичным поведением снижения интенсивности с увеличением расстояния, соответственно. Эффективный цвет света в данной точке пространства равен color * attn. Возможна, хотя и нереалистична, установка отрицательных значений для коэффициентов затухания. Это позволяет сделать коэффициент затухания отрицательным, что приводит к вычитанию цвета света из цвета материала вместо добавления, создавая «источник тени».

Для реалистичного эффекта, maxRange следует установить на расстояние, при котором затухание близко к 0, так как это обеспечит плавное обрезание.

Типы света, не подверженные затуханию по расстоянию, не подвержены воздействию преобразований трансляции. Для таких типов уменьшение интенсивности можно достичь, используя более тёмный цвет.

Примечание: это условная функция. См. ConditionalFeature.SCENE3D для получения дополнительной информации.