Skip to content

novaphy.UsdAnimationTrack

USD animation track for a single attribute on a UsdPrim. Each track holds either vec3 samples (e.g. xformOp:translate) or vec4 samples (e.g. quaternion rotation), keyed by USD timeCode.

Attributes

Attribute Description
property_name Animated USD attribute name (e.g. "xformOp:translate", "xformOp:orient").
vec3_samples List of (time, Vec3) samples. Populated for translate / scale tracks.
vec4_samples List of (time, Vec4) samples. Populated for orientation (quaternion) tracks.

Example

import novaphy

stage = novaphy.OpenUsdImporter().import_file("anim.usda")
for prim in stage.prims:
    for track in prim.tracks:
        if track.property_name == "xformOp:translate":
            for t, p in track.vec3_samples:
                print(prim.path, t, p)

Notes

  • A given track is either vec3 or vec4 — the unused list is empty.
  • Time values are USD timeCode (frame-based). Convert to seconds using the stage's timeCodesPerSecond if you need wall-clock time.
  • NovaPhy does not currently bake animation into a Model automatically; treat tracks as input data for your own keyframe playback layer.

See Also