To Matrix (Transform)
KismetMathLibraryЧто это
Pure-функция из библиотеки KismetMathLibrary. Преобразует Transform (комбинация переноса, поворота, масштаба) в матрицу 4×4 (Matrix). Матрица сохраняет все компоненты трансформации и может использоваться для низкоуровневых операций (умножение с другими матрицами, передача в материалы, кастомные расчёты). Функция pure — не имеет exec-пинов, выполняется мгновенно при передаче значений.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Transform (Transform) — исходная трансформация, которую нужно преобразовать в матрицу
Выходы (данные):
- Return Value (Matrix) — результирующая матрица 4×4, представляющая ту же трансформацию
Когда используется
- Расчёт матрицы для кастомной математики (смешивание анимаций, работа с костями напрямую)
- Передача трансформации в материал через параметр типа
Matrix4илиTransform(не все версии движка одинаково обрабатываютTransformв материалах) - Умножение с другой матрицей (например, из компонента
WorldToLocal) для получения результата в своём пространстве
Типичные проблемы
- Потеря обратной совместимости: после преобразования в матрицу обратное получение
Transform(черезBreakMatrixили иные ручные расчёты) может дать неточный масштаб или поворот — используйте только если точно знаете, что делаете - Неправильный порядок умножения: матрица из
Transformсодержит перенос, поворот, масштаб в порядке(T * R * S). Если умножать в обратном порядке, результат трансформации будет неверным - Путаница между FTransform и FMatrix в C++: в Blueprint функция безопасна, но при вызове из таск-нод или макросов учитывайте, что
Matrixне хранит явное разделение на компоненты (Scale, Rotation, Location) — они «схлопнуты» в одну матрицу