Constrain Location To Plane
MovementComponentЧто это
Pure-функция (не изменяет состояние, вызывается без exec-пинов). Ограничивает переданную точку (Location) плоскостью, заданной ранее через SetPlaneConstraint (нормаль плоскости и смещение). Возвращает точку, спроецированную на эту плоскость. Если плоскость не настроена (ограничение отключено) – возвращает исходную точку без изменений.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (MovementComponent Object Reference) — сам компонент движения, из которого берутся настройки плоскости
- Location (Vector) — исходная точка
Выходы (данные):
- Return Value (Vector) — точка, ограниченная плоскостью (проекция Location на плоскость)
Когда используется
- При кастомной обработке перемещения, когда нужно гарантировать, что позиция персонажа/объекта не выходит за заданную плоскость (например, платформа для ходьбы, ограничение зоны движения).
- Перед фиксацией Location в Tick или при расчёте движения, чтобы избежать выхода за границы плоскости.
Типичные проблемы
- Плоскость не настроена — если перед вызовом не включить ограничение (
SetPlaneConstraintEnabled(true)) и не задать нормаль (SetPlaneNormal), функция вернёт Location без изменений, что может быть неожидано. - Размерность плоскости — функция работает только по нормали; если нужно ограничить по двум осям (прямоугольная область), нужна отдельная логика.
- Игнорирование смещения — плоскость определяется тольконормалью и смещнием (PlaneConstarint), заданными ранее; без сменщения ограничение происходит через (0,0,0).