Set Retain Rendering
RetainerBox
0
Что это
Устанавливает, будет ли RetainerBox рендерить своё содержимое в промежуточную текстуру (Offscreen) перед выводом на экран. Exec-функция (не pure).
Пины
Exec-входы:
- execute (exec) — запуск
Exec-выходы:
- then (exec) — продолжение
Входы (данные):
- Retain Rendering (bool) —
true— включить оффскрин-рендеринг,false— выключить (обычный рендеринг напрямую)
Выходы (данные):
- нет (void)
Когда используется
- Для кэширования сложного UI (например, анимированные частицы или видео), чтобы не перерисовывать каждый кадр.
- Для создания эффектов (размытие, пост-обработка всего содержимого виджета).
- Когда нужно гарантировать, что содержимое не перерисовывается при изменении родительских параметров (производительность).
Типичные проблемы
- Содержимое не обновляется при изменениях — после включения
Retain Renderingнужно явно вызыватьRequestRender, чтобы перерисовать оффскрин-текстуру. - Потеря производительности при частом перерисовывании — если содержимое меняется каждый кадр, оффскрин-рендеринг только ухудшит FPS. В таком случае лучше отключить
Retain Renderingили использовать более лёгкие методы. - Забыли отключить при динамическом контенте — виджет может выглядеть «застывшим», если
Retain Renderingвключён, но не вызываетсяRequestRender.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.