Is Point In Box With Transform
KismetMathLibraryЧто это
Pure-функция из KismetMathLibrary. Проверяет, находится ли заданная точка внутри ориентированного бокса (OBB – oriented bounding box). Бокс задаётся через Transform (положение, поворот, масштаб) и половину размера по каждой оси. Возвращает true, если точка внутри, иначе false.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Point (
Vector) — проверяемая точка в мировом пространстве. - BoxWorldTransform (
Transform) — трансформация бокса (положение + поворот + масштаб). - BoxHalfExtent (
Vector) — половина размера бокса по всем трём осям (X, Y, Z) после применения трансформации.
Выходы (данные):
- Return Value (
Boolean) —true, если точка находится внутри бокса.
Когда используется
- Проверка попадания точки в повёрнутый прямоугольный объём (например, попадание снаряда в зону эффекта, триггер).
- Определение нахождения персонажа/объекта внутри области, которая может быть не параллельна мировым осям.
- Альтернатива
IsPointInBox(без Transform), когда нужен учёт поворота.
Типичные проблемы
- Ошибка «Вектор вместо Transform» — путают
IsPointInBox(входыBoxOrigin,BoxExtent) с данной функцией, которая ожидаетTransformкак единое целое. - Неправильный Half Extent — забывают, что это половина, а не полная длина стороны. Указывают полный размер бокса, из-за чего граница смещается в два раза дальше.
- Неучтённый масштаб в Transform — если в
BoxWorldTransformвстроен неединичный масштаб, функция масштабирует Half Extent автоматически. Разработчики иногда дополнительно умножают Half Extent на масштаб, получая двойное масштабирование.