Get Unscaled Capsule Half Height Without Hemisphere
CapsuleComponentЧто это
Pure-функция компонента-капсулы (CapsuleComponent) в UE5. Возвращает половину высоты цилиндрической части капсулы (без учёта верхней и нижней полусфер). Значение не масштабировано (unscaled) — не зависит от масштаба компонента. Полезна, когда требуется только длина «прямого» отрезка капсулы, например для расчёта смещения или коллизий с учётом только цилиндра.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (CapsuleComponent) — ссылка на компонент-капсулу, для которой нужно получить значение.
Выходы (данные):
- Return Value (float) — половина высоты цилиндрической части капсулы (без учёта полусфер), в «сырых» (unscaled) единицах.
Когда используется
- При программном построении геометрии или линий, где нужны чисто цилиндрические размеры капсулы.
- В процедурной генерации (например, смещение объекта вдоль оси капсулы только на высоту цилиндра, игнорируя закругления).
- В расчётах, где полусферы капсулы учитываются отдельно (например, при кастомной обработке коллизий с шариковыми наконечниками).
Типичные проблемы
- Путаница с
GetUnscaledCapsuleHalfHeight– эта функция возвращает полную половину высоты (включая полусферу), тогда как «Without Hemisphere» даёт только цилиндр. Использование не той версии ломает расчёты, где нужна именно цилиндрическая часть. - Игнорирование «unscaled» – функция выдаёт значение без учёта масштаба компонента. Если масштаб изменен, результат не будет соответствовать фактическому размеру в мире (для масштабированного размера нужно использовать
GetScaledCapsuleHalfHeight_WithoutHemisphere). - Ошибка в математике – при суммировании с радиусом (высота полусферы равна радиусу) неправильно получают полную высоту капсулы: следует складывать
GetUnscaledCapsuleHalfHeight_WithoutHemisphere+GetUnscaledCapsuleRadius(по одной полусфере) или + 2*radius (для двух полусфер).