Decal

public float AlbedoMix { get; set; }

Вес изменения базового цвета. Ноль сохраняет исходный albedo поверхности, но не отключает Normal/ORM при наличии TextureAlbedo с alpha-маской. Для отключения всего экземпляра используйте Visible=false.

public uint CullMask { get; set; }

Битовая маска слоёв рендеринга получателей. Декаль применяется при ненулевом пересечении с VisualInstance3D.Layers меша. Это не PhysicsBody3D.CollisionLayer и не номер единственного слоя. В примере CullMask=2 выбирает пол с Layers=2.

public float DistanceFadeBegin { get; set; }

Расстояние от камеры до позиции декали, после которого начинается затухание при DistanceFadeEnabled=true. До него вклад сохраняется. Для предсказуемой настройки используйте неотрицательное расстояние.

public bool DistanceFadeEnabled { get; set; }

Включает затухание по расстоянию между камерой и позицией декали. Использует DistanceFadeBegin и DistanceFadeLength. Это визуальная оптимизация декали, не остановка скриптов и не удаление Entity.

public float DistanceFadeLength { get; set; }

Длина перехода после DistanceFadeBegin. При включённом distance fade декаль исключается за Begin+Length. Используйте положительное значение: нулевая длина не задаёт плавного перехода.

public float EmissionEnergy { get; set; }

Множитель TextureEmission. Ноль убирает этот вклад, но не albedo/Normal/ORM. Свечение декали не создаёт Light3D и не гарантирует освещение соседних мешей.

public float LowerFade { get; set; }

Неотрицательная степень затухания к отрицательной границе локальной Y объёма проекции. Ноль отключает этот градиент; отрицательное присвоение становится нулём. Уменьшение Size.Y меняет область пересечения, а не этот показатель.

public Color Modulate { get; set; }

RGB умножает цвет albedo и emission. Alpha ослабляет albedo и связанное с его маской смешивание Normal/ORM; emission не умножается на Modulate.A. Поэтому alpha=0 не является надёжным выключателем всей декали.

public float NormalFade { get; set; }

Ослабление проекции на поверхностях с неподходящим направлением геометрической нормали. Положительное значение задействует угловой градиент; это не сила TextureNormal. В примере используется 0.5; угловые граничные случаи отдельно не проверены.

public Vector3 Size { get; set; }

Полный размер объёма проекции по локальным осям. X/Z задают область текстуры, Y — глубину. Объём должен пересекать поверхность. Каждая компонента при присваивании ограничивается снизу значением 0.001; это не половина размера.

public Texture2D TextureAlbedo { get; set; }

Цвет и alpha-маска декали. Alpha участвует также в смешивании Normal и ORM; для изменения только этих каналов сохраните Albedo-текстуру и установите AlbedoMix=0. Отсутствие этой текстуры не равнозначно нулевому AlbedoMix.

public Texture2D TextureEmission { get; set; }

Аддитивное свечение по RGB текстуры, независимое от наличия TextureAlbedo и её alpha-маски. Области без свечения должны быть чёрными по RGB; одна прозрачность не гарантирует отсутствие emission. Яркость умножается на EmissionEnergy и Modulate.RGB.

public Texture2D TextureNormal { get; set; }

Карта нормалей меняет освещение поверхности внутри alpha-маски TextureAlbedo, а не её геометрию или коллизию. Для normal-only декали задайте обе текстуры и AlbedoMix=0. Пример не проверяет импорт и ориентацию карт из сторонних редакторов.

public Texture2D TextureOrm { get; set; }

Упакованные каналы: R — ambient occlusion, G — roughness, B — metallic. Их смешивание использует alpha TextureAlbedo. Пример подтверждает изменение материала с AlbedoMix=0 и исчезновение этого влияния без Albedo-текстуры.

public float UpperFade { get; set; }

Неотрицательная степень затухания к положительной границе локальной Y объёма проекции. Ноль отключает этот градиент; отрицательное присвоение становится нулём. Это не distance fade от камеры.

public float GetAlbedoMix();

Читает AlbedoMix у этого экземпляра. Не определяет по одному значению, видна ли проекция на поверхности.

public uint GetCullMask();

Читает CullMask у этого экземпляра. Не определяет по одному значению, видна ли проекция на поверхности.

public Color GetModulate();

Читает Modulate у этого экземпляра. Не определяет по одному значению, видна ли проекция на поверхности.

public Vector3 GetSize();

Читает Size у этого экземпляра. Не определяет по одному значению, видна ли проекция на поверхности.

public Texture2D GetTexture(Decal.DecalTexture type);

Читает назначенный ресурс выбранного канала. Не захватывает результат проекции и не возвращает изображение поверхности.

public void SetAlbedoMix(float energy);

Задаёт AlbedoMix. Вес изменения базового цвета. Ноль сохраняет исходный albedo поверхности, но не отключает Normal/ORM при наличии TextureAlbedo с alpha-маской. Для отключения всего экземпляра используйте Visible=false.

public void SetCullMask(uint mask);

Задаёт CullMask. Битовая маска слоёв рендеринга получателей. Декаль применяется при ненулевом пересечении с VisualInstance3D.Layers меша. Это не PhysicsBody3D.CollisionLayer и не номер единственного слоя. В примере CullMask=2 выбирает пол с Layers=2.

public void SetModulate(Color color);

Задаёт Modulate. RGB умножает цвет albedo и emission. Alpha ослабляет albedo и связанное с его маской смешивание Normal/ORM; emission не умножается на Modulate.A. Поэтому alpha=0 не является надёжным выключателем всей декали.

public void SetSize(Vector3 size);

Задаёт Size. Полный размер объёма проекции по локальным осям. X/Z задают область текстуры, Y — глубину. Объём должен пересекать поверхность. Каждая компонента при присваивании ограничивается снизу значением 0.001; это не половина размера.

public void SetTexture(Decal.DecalTexture type, Texture2D texture);

Назначает текстуру в указанный канал декали. null очищает канал. Для Normal/ORM нужна отдельная TextureAlbedo с alpha-маской; канал Emission обрабатывается независимо.