To Byte (Integer64)
KismetMathLibrary
0
Что это
Pure-функция преобразования значения из типа Integer64 (int64) в тип Byte (uint8). Выполняет приведение с усечением: если исходное значение выходит за диапазон 0–255, результат будет обрезан по модулю 256.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- In (Integer64) — исходное 64-битное целое число для преобразования
Выходы (данные):
- ReturnValue (Byte) — результат приведения (0–255)
Когда используется
- Когда нужно передать большое целое число в параметр, ожидающий Byte (например, индекс массива, цветовой канал, флаги).
- При работе с данными из внешних источников (сеть, файлы), где числа хранятся в int64, а в Blueprint требуется uint8.
Типичные проблемы
- Потеря данных при усечении: Если In > 255 или In < 0, значение будет обрезано по модулю 256, что может привести к неожиданным результатам (например, 256 → 0, -1 → 255). Перед вызовом стоит проверять диапазон через
BranchсInRange(Integer64). - Неявное приведение в обратную сторону: Если после
Conv_Int64ToByteзначение снова преобразуется в Integer64 (черезConv_ByteToInt64), исходное число не восстановится — это необратимая операция.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.