UKismetMathLibrary::GetRuntimeFloatCurveValue

function Engine Blueprint Since 4.0

#include "Kismet/KismetMathLibrary.h"

Access: public Specifiers: staticBlueprintPureUFUNCTION

Description

Evaluates an FRuntimeFloatCurve at the given time. Returns InDefaultValue if the curve has no keys or the underlying asset is null.

Caveats & Gotchas

• FRuntimeFloatCurve can hold either a reference to an external UCurveFloat asset or inline keys. If the asset reference is valid it takes precedence over inline keys — be explicit about which mode your UPROPERTY is configured for.
• InDefaultValue defaults to 0.0 in Blueprint. A silent zero return is indistinguishable from a valid evaluation at a time where the curve value happens to be zero, which can hide misconfigured curve assets.

Signature

static ENGINE_API float GetRuntimeFloatCurveValue(const FRuntimeFloatCurve& Curve, const float InTime, const float InDefaultValue = 0.0f);

Parameters

Name	Type	Description	Default
Curve	const FRuntimeFloatCurve&	The runtime float curve to evaluate.	—
InTime	const float	The time at which to evaluate the curve.	—
InDefaultValue	const float	Fallback value if the curve cannot be evaluated.	0.0f

Return Type

float

Example

Sample a damage falloff curve at hit distance C++

// DamageFalloff is an FRuntimeFloatCurve UPROPERTY set in the editor
float DamageMultiplier = UKismetMathLibrary::GetRuntimeFloatCurveValue(
    DamageFalloff, HitDistance, 1.0f);
ApplyDamage(Target, BaseDamage * DamageMultiplier);

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?