Clamp (Float)
KismetMathLibraryЧто это
Pure-функция, возвращающая значение, ограниченное заданным диапазоном. Если входное значение меньше минимума — возвращает минимум, если больше максимума — возвращает максимум, иначе возвращает само значение. Полезна для защиты от выхода числа за допустимые границы.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Value (float) — исходное значение
- Min (float) — нижняя граница диапазона
- Max (float) — верхняя граница диапазона
Выходы (данные):
- Return Value (float) — значение, ограниченное диапазоном [Min, Max]
Когда используется
- Ограничение громкости звука, скорости персонажа, углов поворота.
- Нормализация координат, чтобы объект не выходил за границы уровня.
- Защита от деления на ноль или отрицательных значений в последующих вычислениях.
Типичные проблемы
- Перепутанные Min и Max — если Min > Max, функция всё равно сработает, но логически это ошибка: значение будет ограничено неверным диапазоном.
- Использование Clamp вместо Clamp Angle — для углов (например, -180..180) обычный Clamp даст разрыв в 0°, нужен Clamp Angle.
- Забытый Clamp при делении — если делитель может быть нулём или отрицательным, Clamp предотвращает ошибки, но не заменяет проверку на ноль.