UBlueprintSpringMathLibrary

class Engine Blueprint Since 5.7

Inherits: UObjectBase › UObjectBaseUtility › UObject › UBlueprintFunctionLibrary › UBlueprintSpringMathLibrary

#include "Kismet/BlueprintSpringMathLibrary.h"

Description

Blueprint-thread-safe function library exposing critically damped spring interpolation, velocity-spring damping, and simple exponential damping helpers for floats, vectors, quaternions, and rotators. Marked experimental in UE 5.7.

Caveats & Gotchas

• The whole class is marked UE_EXPERIMENTAL(5.7, "SpringMath is experimental") — the API surface, defaults, and even the class's continued existence may change or be removed in a future engine version without a deprecation path.
• All functions are declared BlueprintThreadSafe at the class level, so they must not touch non-thread-safe engine state (e.g. UObject properties without proper synchronization) if called from async Blueprint contexts.

Functions (21)

Interpolation 21

Interpolation

21 ▼

Access	Type	Name	Description
public	function	UBlueprintSpringMathLibrary::ConvertHalfLifeToSmoothingTime	Converts a spring's half life (time to close half the remaining distance to the target) into an equivalent smoothing time in seconds.
public	function	UBlueprintSpringMathLibrary::ConvertSmoothingTimeToHalfLife	Converts a spring's smoothing time into its equivalent half life — how long it takes the value to close half the remaining distance to the target.
public	function	UBlueprintSpringMathLibrary::ConvertSmoothingTimeToStrength	Converts a spring's smoothing time into its equivalent strength, which corresponds to the spring's undamped frequency in Hz.
public	function	UBlueprintSpringMathLibrary::ConvertStrengthToSmoothingTime	Converts a spring's strength (undamped frequency in Hz) into its equivalent smoothing time in seconds.
public	function	UBlueprintSpringMathLibrary::CriticalSpringDampAngle	Interpolates InOutAngle towards TargetAngle using the motion of a critically damped spring, storing the resulting angular velocity back into InOutAngularVelocity.
public	function	UBlueprintSpringMathLibrary::CriticalSpringDampFloat	Interpolates InOutX towards TargetX using the motion of a critically damped spring, storing the resulting velocity back into InOutV.
public	function	UBlueprintSpringMathLibrary::CriticalSpringDampQuat	Interpolates InOutRotation towards TargetRotation using the motion of a critically damped spring on SO(3), storing the resulting angular velocity back into InOutAngularVelocity.
public	function	UBlueprintSpringMathLibrary::CriticalSpringDampRotator	Interpolates InOutRotation towards TargetRotation using the motion of a critically damped spring, storing the resulting angular velocity back into InOutAngularVelocity.
public	function	UBlueprintSpringMathLibrary::CriticalSpringDampVector	Interpolates InOutX towards TargetX using the motion of a critically damped spring, storing the resulting velocity back into InOutV.
public	function	UBlueprintSpringMathLibrary::CriticalSpringDampVector2D	Interpolates InOutX towards TargetX using the motion of a critically damped spring, storing the resulting velocity back into InOutV.
public	function	UBlueprintSpringMathLibrary::DampAngle	Smooths Angle towards TargetAngle using exponential damping, returning the new smoothed angle in degrees each call.
public	function	UBlueprintSpringMathLibrary::DampFloat	Smooths Value towards Target using exponential damping, returning the new smoothed value each call.
public	function	UBlueprintSpringMathLibrary::DampQuat	Smooths Rotation towards TargetRotation using exponential damping over the shortest arc, returning the new smoothed quaternion each call.
public	function	UBlueprintSpringMathLibrary::DampRotator	Smooths Rotation towards TargetRotation using exponential damping, returning the new smoothed rotator each call.
public	function	UBlueprintSpringMathLibrary::DampVector	Smooths Value towards Target using exponential damping, returning the new smoothed vector each call.
public	function	UBlueprintSpringMathLibrary::DampVector2D	Smooths a 2D vector Value towards Target using exponential damping, returning the new smoothed value each call.
public	function	UBlueprintSpringMathLibrary::SpringCharacterUpdate	Advances a character's position toward a target velocity using a damped spring, smoothing out sudden velocity changes rather than snapping to them instantly.
public	function	UBlueprintSpringMathLibrary::VelocitySpringCharacterUpdate	Advances a character's position toward a target velocity using a velocity spring that tracks an intermediate velocity moving at a capped maximum acceleration.
public	function	UBlueprintSpringMathLibrary::VelocitySpringDampFloat	Damps InOutX towards TargetX using a target that follows a fixed linear velocity, giving control over interpolation speed via MaxSpeed while still producing smoothed motion.
public	function	UBlueprintSpringMathLibrary::VelocitySpringDampVector	Damps InOutX towards TargetX using a target that follows a fixed linear velocity, giving control over interpolation speed via MaxSpeed while still producing smoothed motion.
public	function	UBlueprintSpringMathLibrary::VelocitySpringDampVector2D	Damps InOutX towards TargetX using a target that follows a fixed linear velocity, giving control over interpolation speed via MaxSpeed while still producing smoothed motion.

Version History

Introduced in: 5.7

Version	Status	Notes
5.7	experimental	SpringMath is experimental.

Feedback

Was this helpful?