Vector Is Nearly Zero
KismetMathLibraryЧто это
Pure-функция из библиотеки KismetMathLibrary. Проверяет, находится ли переданный вектор в пределах заданной точности от нулевого вектора (0,0,0). Возвращает true, если длина каждого компонента вектора меньше или равна указанному допуску (Tolerance). Полезна для сравнения векторов с плавающей погрешностью без строгого равенства.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Vector) — проверяемый вектор
- Tolerance (float) — порог точности (значение по умолчанию 0.0001)
Выходы (данные):
- Return Value (bool) — true, если длина вектора меньше или равна Tolerance
Когда используется
- Проверка, остановился ли объект (скорость почти нулевая).
- Сравнение перемещений с эпсилон-погрешностью, чтобы избежать дрейфа при физике.
- Фильтрация незначительных смещений в логике движения (например, отмена анимации при остановке).
Типичные проблемы
- Слишком низкое Tolerance — функция будет возвращать false даже при мизерных флоатинговых ошибках, вызывая нестабильное поведение (постоянные переключения состояний).
- Сравнение больших значений — если вектор имеет компоненты порядка тысяч, а Tolerance оставлено по умолчанию (0.0001), условие никогда не выполнится; для практических задач нужно адаптировать допуск под масштаб.
- Забытая проверка Z-компоненты — функция проверяет все три оси, поэтому для игнорирования высоты (например, при движении по плоскости) используйте отдельное сравнение X и Y через
Vector.IsZero? нет, лучше брать компоненты отдельно, иначе вертикальная составляющая сломает логику.