Break Hit Result
GameplayStaticsЧто это
Pure-функция, которая «разворачивает» структуру Hit Result (результат трассировки) на отдельные поля: точку попадания, нормаль, физический материал, кость и т.д. Удобна, когда нужно получить конкретные данные из Hit Result без ручного доступа к каждому полю.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Hit (Hit Result) — структура, которую нужно разобрать
Выходы (данные):
- bBlockingHit (bool) — true, если трассировка заблокирована
- bInitialOverlap (bool) — true, если начальная точка уже перекрыта
- Time (float) — нормализованное время вдоль луча (0..1)
- Distance (float) — расстояние от Start до точки попадания
- Location (Vector) — точка попадания в мировых координатах
- ImpactPoint (Vector) — точка контакта (может отличаться от Location при сложной геометрии)
- Normal (Vector) — нормаль в точке попадания (единичный вектор)
- ImpactNormal (Vector) — нормаль в точке контакта
- PhysMaterial (Physical Material Object) — физический материал в точке попадания
- HitActor (Actor Object) — актёр, в который попал луч
- HitComponent (Primitive Component Object) — компонент, в который попал луч
- HitBoneName (Name) — имя кости (для скелетных мешей)
- HitItem (Integer) — индекс элемента (для процедурных мешей)
- FaceIndex (Integer) — индекс грани (для статических мешей)
Когда используется
После любой трассировки (Line Trace, Sphere Trace, Sweep), когда нужно получить координаты точки попадания, нормаль, актёра или физический материал. Альтернатива — читать поля напрямую из структуры, но Break Hit Result удобнее для визуального восприятия в графе.
Типичные проблемы
- Путаница Location и ImpactPoint: Location — точка на луче на расстоянии Time, ImpactPoint — реальная точка контакта с поверхностью. Для коллизий с толстой геометрией они могут различаться.
- Normal vs ImpactNormal: Normal — нормаль к поверхности в точке пересечения луча, ImpactNormal — нормаль в точке контакта. Для простых случаев совпадают, но при сложной геометрии (например, углы) могут давать разные значения.
- HitActor = None: если трассировка игнорирует владельца (Owner) или сам актёр, HitActor может быть пустым. Проверяйте bBlockingHit перед использованием.