Set Translucency Sort Distance Offset
PrimitiveComponentЧто это
Exec-функция класса PrimitiveComponent. Устанавливает смещение (offset) для сортировки полупрозрачных объектов по глубине. Позволяет вручную корректировать порядок отрисовки translucency-объектов, когда стандартная сортировка по расстоянию до камеры даёт неверный результат (например, артефакты наложения).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (PrimitiveComponent Object Reference) — компонент, для которого задаётся смещение
- NewSortDistanceOffset (float) — значение смещения сортировки (в юнитах мира). Положительное — объект рисуется «дальше» (позади других), отрицательное — «ближе» (поверх других)
Выходы (данные):
- нет (void)
Когда используется
- Исправление артефактов наложения полупрозрачных материалов (например, дым, стекло, вода), когда стандартная сортировка по Z-буферу ошибочно рисует ближний объект позади дальнего.
- Принудительное задание порядка отрисовки для группы overlapping-объектов с translucency (например, частицы и декали).
Типичные проблемы
- Неверный знак смещения: положительное значение отодвигает объект «назад» (рисуется раньше), отрицательное — «вперёд» (рисуется позже). Путаница в знаке приводит к противоположному эффекту.
- Игнорирование при сложной иерархии: если компонент вложен в другой PrimitiveComponent с собственным смещением, итоговый порядок может быть неочевидным — смещения не суммируются автоматически.
- Отсутствие эффекта на opaque-материалах: функция влияет только на объекты с режимом Blend Mode = Translucent. На непрозрачные материалы (Opaque, Masked) не действует.