Vector Snapped To Grid
KismetMathLibraryЧто это
Pure-функция, которая привязывает вектор к равномерной трёхмерной сетке с заданным шагом. Каждый компонент (X, Y, Z) округляется до ближайшего кратного соответствующему компоненту размера ячейки. Полезна для приведения произвольных координат к дискретным позициям сетки.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- In Vector (Vector) — исходный произвольный вектор в мировом пространстве.
- Grid Size (Vector) — размер ячейки сетки по каждой оси (например, Vector(100, 100, 0) для двумерной сетки с шагом 100).
Выходы (данные):
- Return Value (Vector) — вектор, каждый компонент которого округлён до ближайшего кратного соответствующего компонента Grid Size.
Когда используется
- Привязка координат спауна или перемещения объектов к дискретной сетке в строительных / градостроительных механиках.
- Нормализация позиций для пошаговых тактических игр или систем размещения модулей.
- Округление векторов движения или цели для упрощения логики навигации.
Типичные проблемы
- Нулевой Grid Size — если хотя бы один компонент размера ячейки равен 0, функция порождает деление на ноль (ошибка выполнения). Всегда проверяйте, что Grid Size > 0 по нужным осям.
- Отрицательный Grid Size — функция корректно обрабатывает отрицательные значения, но результат может быть неочевидным. Рекомендуется использовать только положительные размеры ячеек.
- Независимое округление по осям — каждый компонент обрабатывается отдельно, поэтому если нужно округление только по X и Y (игнорируя Z), следует передать Grid Size с Z = 0 (но учтите первое предупреждение; лучше оставить Z = 1 и вручную обнулить высоту после вызова).