Set Rendering Phase
RetainerBox
0
Что это
Exec-функция, задаёт фазу рендеринга для виджета RetainerBox. Внутреннее содержимое ретейнера будет отрисовываться на указанной фазе – это позволяет управлять порядком отрисовки среди нескольких ретейнеров или между ними и другими элементами интерфейса.
Пины
Exec-входы:
- execute (exec) – запуск установки фазы.
Exec-выходы:
- then (exec) – продолжение выполнения после установки.
Входы (данные):
- Target (RetainerBox Object Reference) – сам ретейнер, у которого меняется фаза.
- RenderingPhase (Integer) – номер фазы (обычно 0, 1, 2…). Чем меньше число, тем раньше отрисовывается содержимое в пределах своего слоя.
Выходы (данные):
- нет (void).
Когда используется
- При динамической настройке порядка отрисовки слоёв внутри одного родительского виджета (например, чтобы один ретейнер с анимацией был поверх другого).
- В UI-системах, где несколько RetainerBox накладываются друг на друга и требуется точный контроль z-порядка.
Типичные проблемы
- Выход фазы за допустимые границы – если задать слишком большой номер фазы, содержимое ретейнера может не отрисоваться вовсе (обычно поддерживается диапазон 0…N, где N – максимальная фаза, заданная в настройках проекта или виджета).
- Конфликт фаз с другими ретейнерами – одинаковые фазы у нескольких перекрывающихся ретейнеров приводят к неопределённому порядку отрисовки; для предсказуемости каждому ретейнеру лучше назначать уникальную фазу.
- Игнорирование начальной фазы – если не вызвать SetRenderingPhase, используется значение по умолчанию (обычно 0), что может не соответствовать задуманному порядку слоёв.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.