Read Render Target Raw Pixel Area
KismetRenderingLibrary
0
Что это
Exec-функция для синхронного чтения цвета пикселей из прямоугольной области render target. Возвращает массив значений LinearColor, соответствующий выбранной зоне (построчно, сверху вниз). Используется, когда нужен прямой доступ к пиксельным данным RT из Blueprint.
Пины
Exec-входы:
- execute (exec) — запуск чтения
Exec-выходы:
- then (exec) — продолжение выполнения после завершения чтения
Входы (данные):
- Texture Render Target (TextureRenderTarget2D Object Reference) — целевая текстура-рендертаргет, из которой читаются пиксели
- X (Integer) — начальная координата по X (левая граница области)
- Y (Integer) — начальная координата по Y (верхняя граница области)
- Width (Integer) — ширина читаемой области в пикселях
- Height (Integer) — высота читаемой области в пикселях
Выходы (данные):
- Return Value (Array of LinearColor) — массив цветов пикселей. Порядок: построчно, слева направо, начиная с верхней строки (Y → Y+Height-1)
Когда используется
- Снятие «скриншота» части UI или 3D-сцены, отрендеренной в RT, для последующего анализа (например, определение цвета под курсором).
- Чтение данных карт высот/нормалей из водопадов или текстур ландшафта, нарисованных через Draw Material to Render Target.
Типичные проблемы
- Выход за границы RT: если X + Width > ширина текстуры или Y + Height > высота — чтение вернёт пустой массив или некорректные данные. Всегда проверяйте размеры через
Get Render Target Size. - Производительность: синхронное чтение большого участка (например, 512×512) каждый кадр может вызывать падение FPS. Используйте для однократных вызовов или кешируйте результат.
- Render target должен быть создан с включённым флагом
bCanBeRead(в настройках текстуры). Иначе чтение вернёт нулевые значения без ошибки.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.