Класс LightBase

public abstract class LightBase extends Node

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

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

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

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

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

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

Приложение не может добавлять собственные типы света. Прямое расширение класса LightBase может привести к возникновению исключения UnsupportedOperationException.

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

Цвет

Источник света испускает свет определенного цвета. Внешний вид объекта, освещённого этим светом, определяется цветом света и материалом объекта. Например, при синем свете белый объект будет казаться синим, чёрный — чёрным, а объект цвета (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 для получения дополнительной информации.