Get Curve Value With Default
AnimInstanceЧто это
Чистая функция (pure) для чтения значения кривой анимации (Animation Curve) из текущего состояния AnimInstance. Если кривая с указанным именем не найдена, возвращает заданное значение по умолчанию. Позволяет безопасно читать кастомные параметры анимации без предварительной проверки на существование кривой.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Curve Name (Name) — имя кривой анимации.
- Default Value (Float) — значение, возвращаемое, если кривая не найдена.
Выходы (данные):
- Return Value (Float) — значение кривой, либо значение по умолчанию.
Когда используется
В анимационных Blueprint (AnimBP) для чтения кастомных свойств, заданных в анимации (например, скорость вращения, смещение кости, высота прыжка). Используется вместо GetCurveValue, когда кривая может отсутствовать, чтобы явно задать fallback-значение вместо нуля.
Типичные проблемы
- Имя кривой должно совпадать точно. Регистр и пробелы в
Curve Nameимеют значение. Ошибка в имени приводит к возврату значения по умолчанию без предупреждения. - Контекст вызова. Функция корректно работает только внутри AnimInstance (AnimBP). Вызов из обычного игрового Blueprint всегда вернёт значение по умолчанию, так как кривые анимации не загружены.
- Тип возвращаемого значения. Функция всегда возвращает
Float. Если в кривой закодировано булево или целочисленное значение, требуется явное приведение (например,Compare FloatилиRound).