UKismetMathLibrary::MakeQualifiedFrameTime

function Engine Blueprint Since 4.23

#include "Kismet/KismetMathLibrary.h"

Access: public Specifiers: staticUFUNCTIONBlueprintPure

Description

Assembles an FQualifiedFrameTime from a frame number, frame rate, and optional sub-frame offset. Use this whenever you need to pass a frame position with its rate context together, such as when scrubbing a Sequencer track.

Caveats & Gotchas

• SubFrame is clamped to [0, 1) by convention, but this function does not enforce the clamp — passing 1.0 or higher produces an invalid state that can desynchronise Sequencer evaluation. Always clamp SubFrame explicitly.
• FQualifiedFrameTime is a value type with no implicit conversion. Assigning one from a different frame rate without re-expressing the frame number will produce a time at the wrong position. Use FFrameRate::TransformTime to convert between rates first.

Signature

static ENGINE_API FQualifiedFrameTime MakeQualifiedFrameTime(FFrameNumber Frame, FFrameRate FrameRate, float SubFrame = 0.f);

Parameters

Name	Type	Description	Default
Frame	FFrameNumber	The integer frame number.	—
FrameRate	FFrameRate	The frame rate that gives meaning to the frame number.	—
SubFrame	float	Sub-frame offset in the range [0, 1). Defaults to 0.	0.f

Return Type

FQualifiedFrameTime

Example

Build a qualified frame time for Sequencer C++

FFrameRate Rate = FFrameRate(24, 1); // 24 fps
FFrameNumber Frame(48);              // 2 seconds in
FQualifiedFrameTime QFT = UKismetMathLibrary::MakeQualifiedFrameTime(Frame, Rate, 0.f);
Sequencer->SetLocalTime(QFT);

Version History

Introduced in: 4.23

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?