matt johnson 4fd3699e7d AnimationBlueprintLibrary: add function for evaluating the subframe timecode attribute ...

Since the subframe component of FFrameTime is clamped to the range [0.0, 1.0),
it cannot accurately represent the use case where the timecode metadata represents
subframe values as whole numbered subframes instead of as a percentage of a frame
the way the engine does. The subframe component of the FQualifiedFrameTime returned
by EvaluateRootBoneTimecodeAttributesAtTime() may not reflect the authored subframe
metadata in that case.

This new function allows access to the subframe values that were actually authored in the
timecode metadata.

An additional explicit clamp was added to EvaluateRootBoneTimecodeAttributesAtTime()
to ensure that the subframe value read from the timecode metadata is in range *before*
we try to construct an FFrameTime from it, since the constructor has a checkSlow() that
will assert if the value is out of range.

#jira UE-141224
#rb max.chen
#preflight 620ffdcead11de9431ce8cc5

[CL 19060425 by matt johnson in ue5-main branch]

2022-02-18 19:47:57 -05:00

87 KiB

Raw Blame History

View Raw