ReflectionProbe

public ReflectionProbe();

Создаёт Entity пробы и принадлежащий ей ресурс RenderingServer. Начальные настройки: Size=(20,20,20), OriginOffset=0, MaxDistance=0, Intensity=1, BlendDistance=1, UpdateMode=Once; обе маски включают первые 20 слоёв. BoxProjection, Interior и EnableShadows выключены, AmbientMode=Environment. Конструктор не означает, что GPU-захват уже завершён: пробу необходимо добавить в активный 3D-мир. Освобождайте Entity обычным способом; её внутренний RID не принадлежит вызывающему коду.

public Color AmbientColor { get; set; }

Постоянный ambient-цвет для AmbientMode.Color, по умолчанию чёрный. В RD RGB переводится из sRGB в линейное пространство и умножается на AmbientColorEnergy и вклад пробы. Альфа не задаёт прозрачность получателя. В остальных ambient-режимах значение сохраняется, но этот цвет не используется.

public float AmbientColorEnergy { get; set; }

Множитель AmbientColor в режиме Color, по умолчанию 1. Не меняет энергию источников света или запечатлённую геометрию. Intensity дополнительно масштабирует вклад пробы. Используйте неотрицательные значения; setter не ограничивает их диапазоном подсказки инспектора. При 0 RGB вклада становится чёрным; режим Color остаётся активным.

public ReflectionProbe.AmbientModeEnum AmbientMode { get; set; }

Способ добавления диффузного ambient-вклада, по умолчанию Environment. Disabled не добавляет такой вклад; Environment использует наиболее размытый уровень захвата; Color использует AmbientColor и AmbientColorEnergy. Это приближение локального освещения, не расчёт многократных отражений. Сам режим Disabled не запрещает зеркальное отражение, но при нулевом общем ambient стандартное specular occlusion может его погасить.

public float BlendDistance { get; set; }

Ширина затухания вклада у внутренних границ области Size, по умолчанию 1. Значение 0 отключает плавный переход, сохраняя ограничение областью. В текущем RD переход вычисляется по осям и ограничивается полуразмерами коробки; это не линейная прозрачность по одному расстоянию и не дальность захвата.

public bool BoxProjection { get; set; }

Коррекция параллакса отражения по коробке Size, по умолчанию false. В RD направление пересчитывается с учётом положения отражаемой поверхности внутри коробки и OriginOffset. Полезно для прямоугольных помещений, но не восстанавливает точную геометрию комнаты. Не перемещает точку захвата и не задаёт разрешение атласа.

public uint CullMask { get; set; }

Маска слоёв VisualInstance3D, попадающих в захват; по умолчанию включены первые 20 слоёв. Сравнивается со слоями захватываемой геометрии, а не с номером слоя. Не выбирает получателей отражения: для них используется ReflectionMask. Ноль исключает геометрию, но не останавливает пробу и не обязательно исключает небо.

public bool EnableShadows { get; set; }

Разрешает вычисление теней источников света при захвате, по умолчанию false. В RD для этого передаётся атлас теней пробы; сами источники и их настройки также должны поддерживать тени. Увеличивает работу при обновлении, особенно с Always. Не выключает уже запечённое затемнение в материалах или картах освещения.

public float Intensity { get; set; }

Множитель зеркального и добавочного ambient-вклада пробы, по умолчанию 1. Значение 0 убирает её световой вклад, но не удаляет пробу и не останавливает захват. Это не мощность источников света внутри захвата. Используйте неотрицательное значение; setter не ограничивает его подсказкой инспектора 0…1.

public bool Interior { get; set; }

Интерьерный захват без фонового неба, по умолчанию false. В текущем RD окружение Environment исключается из рендера самой пробы. Это не создаёт свет внутри комнаты и не отключает всё освещение основной камеры; видимый ambient-вклад также зависит от AmbientMode и других источников.

public float MaxDistance { get; set; }

Запрошенная дальность внутренних камер захвата, по умолчанию 0. Обёртка ограничивает значение диапазоном 0…262144. Фактическая дальняя плоскость дополнительно расширяется до границ области относительно OriginOffset, поэтому 0 не отключает захват. Это не расстояние видимости пробы от основной камеры и не размер её области влияния.

public float MeshLodThreshold { get; set; }

Порог экранного размера для выбора существующих LOD геометрии при захвате, по умолчанию 1. В текущем RD нормируется на разрешение атласа. Большие значения могут выбирать менее подробные LOD. Не создаёт LOD и не меняет их выбор основной камерой. Используйте неотрицательные значения; setter не ограничивает диапазон.

public Vector3 OriginOffset { get; set; }

Локальное смещение точки захвата относительно центра пробы, по умолчанию (0,0,0). Для корректного положительного Size компоненты ограничиваются диапазоном ±(Size/2−0.01); уменьшение Size может изменить ранее заданное смещение. Смещение используется внутренними камерами захвата, а при BoxProjection — также коррекцией направления отражения. Оно не перемещает саму область влияния.

public uint ReflectionMask { get; set; }

Маска слоёв геометрии, получающих отражение и ambient-вклад этой пробы; по умолчанию включены первые 20 слоёв. В текущем RD сравнивается со слоями экземпляра при применении пробы. Не меняет набор захватываемой геометрии — это CullMask. Ноль убирает получателей, но не освобождает захват и не является выключением процесса обновления.

public Vector3 Size { get; set; }

Полные локальные размеры области влияния, а не половины размеров. По умолчанию (20,20,20). Используйте положительные компоненты; setter сохраняет переданный вектор без проверки положительности. Изменение размера также ограничивает сохранённый OriginOffset внутри области. Для размеров используйте это свойство, а не масштаб Entity: у ReflectionProbe отключено наследуемое масштабирование трансформации.

public ReflectionProbe.UpdateModeEnum UpdateMode { get; set; }

Политика обновления захвата, по умолчанию Once. Once сохраняет результат до инвалидации; изменения материала постороннего объекта сами по себе не гарантируют перезахват. Always повторяет захват при обработке активной пробы. Доступность результата зависит от видимости, планирования и обработки roughness, а не только от вызова setter. В текущем RD Always использует размер захвата 256 на грань куба; переход может пересоздать общий атлас и сопровождается известным ограничением освобождения текстур из руководства.

public bool AreShadowsEnabled();

Возвращает флаг EnableShadows. Он не сообщает, есть ли подходящие источники или готовые тени в текущем захвате.

public Color GetAmbientColor();

Возвращает сохранённый AmbientColor, включая компоненты Color, без замены на готовый линейный RGB освещения.

public float GetAmbientColorEnergy();

Возвращает сохранённый AmbientColorEnergy независимо от активного AmbientMode.

public ReflectionProbe.AmbientModeEnum GetAmbientMode();

Возвращает сохранённый режим ambient пробы. Это не запрос готовности захвата.

public float GetBlendDistance();

Возвращает сохранённую ширину перехода BlendDistance.

public uint GetCullMask();

Возвращает сохранённую маску захватываемых слоёв.

public float GetIntensity();

Возвращает сохранённый Intensity, а не измеренную яркость пикселей отражения.

public float GetMaxDistance();

Возвращает сохранённый MaxDistance после ограничения диапазона. Не возвращает фактическую дальнюю плоскость захвата: рендерер может увеличить её с учётом Size и OriginOffset.

public float GetMeshLodThreshold();

Возвращает сохранённый порог LOD для захвата.

public Vector3 GetOriginOffset();

Возвращает сохранённый OriginOffset после ограничения внутри размеров пробы. Результат может отличаться от переданного в SetOriginOffset или измениться после SetSize.

public uint GetReflectionMask();

Возвращает сохранённую маску получателей, а не маску камер захвата.

public Vector3 GetSize();

Возвращает сохранённые полные локальные размеры Size. Локальный GetAabb() пробы задаётся позицией -Size/2 и размером Size; это не дальность внутренней камеры.

public ReflectionProbe.UpdateModeEnum GetUpdateMode();

Возвращает настроенную политику обновления. Метод не сообщает о завершении захвата или фильтрации.

public bool IsBoxProjectionEnabled();

Возвращает настройку BoxProjection. Значение true не подтверждает точность параллакса конкретной комнаты.

public bool IsSetAsInterior();

Возвращает сохранённый флаг Interior, а не результат проверки помещения на замкнутость.

public void SetAmbientColor(Color ambient);

Сохраняет постоянный цвет ambient. Для его применения выберите AmbientMode.Color; для силы вклада используйте AmbientColorEnergy и Intensity.

public void SetAmbientColorEnergy(float ambientEnergy);

Задаёт множитель постоянного ambient-цвета. Для видимого действия нужен AmbientMode.Color; увеличение не добавляет светильники или тени.

public void SetAmbientMode(ReflectionProbe.AmbientModeEnum ambient);

Выбирает источник диффузного ambient-вклада. Настройки AmbientColor и AmbientColorEnergy хранятся независимо, но используются в режиме Color.

public void SetAsInterior(bool enable);

Переключает интерьерный режим и помечает данные пробы для обновления. Разместите точку захвата вне сплошной геометрии и обеспечьте освещение помещения.

public void SetBlendDistance(float blendDistance);

Задаёт ширину перехода у границ области. Используйте неотрицательное значение: setter не проверяет диапазон. Не увеличивает область Size и не создаёт дополнительные пробы.

public void SetCullMask(uint layers);

Назначает слои геометрии для внутренних камер и инвалидирует захват. Маска основной Camera3D остаётся отдельной настройкой.

public void SetEnableBoxProjection(bool enable);

Включает или выключает коррекцию направления отражения по коробке. Сначала подгоните Size и OriginOffset под помещение.

public void SetEnableShadows(bool enable);

Переключает вычисление теней при захвате и инвалидирует данные пробы. Проверяйте качество и стоимость на целевой платформе.

public void SetIntensity(float intensity);

Назначает множитель вклада пробы. Изменение не является запросом нового захвата сцены; проверьте итог вместе с экспозицией, материалом и BlendDistance.

public void SetMaxDistance(float maxDistance);

Запрошенная дальность внутренних камер захвата, по умолчанию 0. Обёртка ограничивает значение диапазоном 0…262144. Фактическая дальняя плоскость дополнительно расширяется до границ области относительно OriginOffset, поэтому 0 не отключает захват. Это не расстояние видимости пробы от основной камеры и не размер её области влияния.

public void SetMeshLodThreshold(float ratio);

Задаёт порог выбора LOD для следующих захватов. Сам setter не инвалидирует уже сохранённое изображение Once; изменение настройки не доказывает, что новая геометрия уже захвачена.

public void SetOriginOffset(Vector3 originOffset);

Локальное смещение точки захвата относительно центра пробы, по умолчанию (0,0,0). Для корректного положительного Size компоненты ограничиваются диапазоном ±(Size/2−0.01); уменьшение Size может изменить ранее заданное смещение. Смещение используется внутренними камерами захвата, а при BoxProjection — также коррекцией направления отражения. Оно не перемещает саму область влияния.

public void SetReflectionMask(uint layers);

Задаёт слои объектов, на которые действует проба, и обновляет её зависимости. Для исключения самого объекта из изображения захвата меняйте CullMask, а не эту маску.

public void SetSize(Vector3 size);

Полные локальные размеры области влияния, а не половины размеров. По умолчанию (20,20,20). Используйте положительные компоненты; setter сохраняет переданный вектор без проверки положительности. Изменение размера также ограничивает сохранённый OriginOffset внутри области. Для размеров используйте это свойство, а не масштаб Entity: у ReflectionProbe отключено наследуемое масштабирование трансформации.

public void SetUpdateMode(ReflectionProbe.UpdateModeEnum mode);

Меняет политику обновления и инвалидирует данные пробы. Это не синхронная команда получения готового изображения. Учитывайте стоимость Always и известное предупреждение освобождения ресурсов при переходе между режимами.