GeometryInstance3D

public GeometryInstance3D.ShadowCastingSetting CastShadow { get; set; }

Управляет отбрасыванием тени геометрией, а не её обычной видимостью и не приёмом теней. Off убирает тень объекта; источник также должен иметь ShadowEnabled. В примере проверен DirectionalLight3D в Compatibility.

public Aabb CustomAabb { get; set; }

Пользовательские локальные границы для отсечения экземпляра рендеринга. Ненулевой Aabb заменяет вычисленные границы; default(Aabb) снимает замену. Затем применяется ExtraCullMargin, и результат трансформируется в мировой базис. Не изменяет вершины, Mesh.GetAabb(), VisualInstance3D.GetAabb() или коллизию. Слишком большой объём ухудшает отсечение и не является общим отключением проверки видимости.

public float ExtraCullMargin { get; set; }

Дополнительный запас границ для culling геометрии. Полезен, когда vertex shader выводит вершины за исходный AABB. Не меняет CPU-вершины, исходный Mesh.GetAabb или CollisionShape3D. Подбирайте запас по максимально возможному смещению; в примере 2.

public GeometryInstance3D.LightmapScale GILightmapScale { get; set; }

Плотность текселей, используемая для отображения освещения в LightmapGI.

public float GILightmapTexelScale { get; set; }

Плотность текселей для использования при отображении освещения в LightmapGI. Большие значения масштаба обеспечивают более высокое разрешение в карте освещения, что может привести к более резким теням для источников света, которые имеют как прямой, так и непрямой свет, запеченный. Однако большие значения масштаба также увеличат пространство, занимаемое сеткой в текстуре карты освещения, что увеличивает требования к памяти, хранению и времени запекания. При использовании одной сетки в разных масштабах рассмотрите возможность корректировки этого значения, чтобы сохранить плотность текселей карты освещения одинаковой для всех сеток. Например, удвоение GeometryInstance3D.GILightmapTexelScale удваивает разрешение текстуры карты освещения для этого объекта на каждой оси, поэтому это учетверит количество текселей.

public GeometryInstance3D.GIModeEnum GIMode { get; set; }

Режим глобального освещения для использования во всей геометрии. Чтобы избежать непоследовательных результатов, используйте режим, который соответствует назначению сетки во время игры (статичный/динамичный). Примечание: Режим запекания источников света также повлияет на рендеринг глобального освещения. См. Light3D.LightBakeMode.

public bool IgnoreOcclusionCulling { get; set; }

Исключает геометрию из occlusion-отсечения. В примере возвращает скрытую сферу в список отрисовки за стеной; это не делает её видимой сквозь непрозрачную стену и не отменяет все остальные виды culling.

public float LodBias { get; set; }

Множитель выбора mesh LOD для экземпляра. В проверке увеличение с 1 до 8 сохраняет больше примитивов на дальней дистанции. Не заменяет отсутствующие LOD-данные, не меняет физическую форму и не задаёт фиксированную дистанцию переключения.

public Material MaterialOverlay { get; set; }

Дополнительный материал, отрисовываемый поверх основного отдельным проходом. Не заменяет MaterialOverride и не возвращается GetActiveMaterial. Проверен прозрачный Alpha overlay; настройте прозрачность, глубину и стоимость дополнительного прохода отдельно.

public Material MaterialOverride { get; set; }

Основной материал для всех поверхностей экземпляра с приоритетом над surface override и материалами Mesh. Назначение существующего ресурса не делает его уникальным. null возвращает выбор материалов поверхностей.

public float Transparency { get; set; }

Прозрачность применяется ко всей геометрии (в качестве множителя существующей транспарентности материалов). 0.0 полностью непрозрачна, в то время как 1.0 - полностью прозрачны. 0.0 (исключительно) заставит материалы геометрии пройти через прозрачный трубопровод, который медленнее доставлять и может проявлять проблемы из-за неправильной транспарентности сортировки. GeometryInstance3D.Transparency на величину, превышающую 0.0 (исключительно) отключит тень. В пространственных теннисах, 1.0 - transparency установлен в качестве значения по умолчанию ALPHA Встроенный. Примечание: GeometryInstance3D.Transparency зажимается между 0.0 и 1.0Таким образом, это имущество не может быть использовано для того, чтобы сделать прозрачные материалы более непрозрачными, чем они были изначально. Примечание: Поддержку поддерживают только при использовании метода трансляции " Вперед+ " . GeometryInstance3D.Transparency игнорируется и считается, что 0.0.

public float VisibilityRangeBegin { get; set; }

Нижняя граница видимости по дистанции от камеры до преобразованного центра AABB. Ноль отключает нижний предел. Скрытие по диапазону не останавливает _Process, физику и не выгружает ресурсы. При нулевых margin на точной общей границе обе соседние модели могут быть видимы.

public float VisibilityRangeBeginMargin { get; set; }

Запас около нижней границы. При отключённом fade используется для гистерезиса переключения с учётом предыдущего состояния. Это не автоматически прозрачный переход. Настраивайте вместе с верхним диапазоном соседней модели.

public float VisibilityRangeEnd { get; set; }

Верхняя граница дистанционной видимости; ноль отключает верхний предел. Измеряется до преобразованного центра AABB, не обязательно до origin Entity. Это выбор видимой геометрии, не стриминг и не автоматическое упрощение треугольников.

public float VisibilityRangeEndMargin { get; set; }

Запас около верхней границы. При отключённом fade участвует в гистерезисе; в режимах fade задаёт полосу перехода. Само значение не включает прозрачное исчезновение и не выключает обработку Entity.

public GeometryInstance3D.VisibilityRangeFadeModeEnum VisibilityRangeFadeMode { get; set; }

Режим перехода диапазонов. Disabled переключает видимость без прозрачного fade. По исходникам прозрачные Self/Dependencies требуют Forward+; не рассчитывайте на них в Compatibility или Mobile. Нативный пример проверяет только Disabled с нулевыми margin.

public Aabb GetCustomAabb();

Возвращает сохранённое значение CustomAabb, а не окончательные границы серверного отсечения. Прямой вызов RenderingServer.InstanceSetCustomAabb не обновляет это значение обёртки.

public float GetExtraCullMargin();

Возвращает сохранённый дополнительный запас локальных границ. Прямой вызов RenderingServer.InstanceSetExtraVisibilityMargin меняет серверное состояние, но не это значение обёртки.

public Variant GetInstanceShaderParameter(StringName name);

Читает эффективное значение instance uniform этой геометрии. После снятия override через Nil в проверенном примере возвращается shader-default White. Это отличается от ShaderMaterial.GetShaderParameter, который без сохранённого override возвращает Nil.

public Material GetMaterialOverlay();

Дополнительный материал отдельного прохода. Не заменяет базовый MaterialOverride и не возвращается как GetActiveMaterial. Подчиняется своей очереди, смешиванию и глубине: непрозрачный overlay не гарантирует положение сверху. В проверке прозрачный alpha-overlay смешивается с базой.

public Material GetMaterialOverride();

Базовый материал всего экземпляра, приоритетнее override отдельных поверхностей и материалов Mesh. Назначение не создаёт отдельную копию ресурса. null возвращает выбор по поверхностям; MaterialOverlay остаётся отдельным проходом.

public void SetCustomAabb(Aabb aabb);

Сохраняет CustomAabb и передаёт его экземпляру RenderingServer. Объём задаётся в локальных координатах. Для ветровой или другой GPU-деформации охватите все положения вершин: движок не выводит эти смещения из кода шейдера.

public void SetExtraCullMargin(float margin);

Расширяет локальные границы рендеринга во все стороны до применения трансформации экземпляра. Помогает учитывать смещения вершин в шейдере; при уменьшении масштаба мировой запас тоже уменьшается. Не изменяет исходные вершины, GetAabb() или коллизию. Отрицательное значение отклоняется с ошибкой движка, прежняя настройка сохраняется.

public void SetInstanceShaderParameter(StringName name, Variant value);

Задаёт instance uniform для этой геометрии, сохраняя общий ShaderMaterial у других мешей. Параметр должен быть объявлен как instance uniform. Nil снимает override и восстанавливает shader-default этого параметра.

public void SetMaterialOverlay(Material material);

Дополнительный материал отдельного прохода. Не заменяет базовый MaterialOverride и не возвращается как GetActiveMaterial. Подчиняется своей очереди, смешиванию и глубине: непрозрачный overlay не гарантирует положение сверху. В проверке прозрачный alpha-overlay смешивается с базой.

public void SetMaterialOverride(Material material);

Базовый материал всего экземпляра, приоритетнее override отдельных поверхностей и материалов Mesh. Назначение не создаёт отдельную копию ресурса. null возвращает выбор по поверхностям; MaterialOverlay остаётся отдельным проходом.