Pure Root Motion Format

Pure Root Motion, captured from character movement or simulated, can be uploaded to the Trail Set Manager for creating custom Trails.

Pure Root Motion

When uploading a JSON file to create a Trail in the Trail Set Manager, the JSON must be written in the compatible format.

Format Definition

Pure Root Motion uses a flat array where each 7 elements represents 1 frame. It may look like this:

In this order, each element within a set of 7 represents:

1. X Position

2. Y Position

3. Z Position

4. Quaternion W

5. Quaternion X

6. Quaternion Y

7. Quaternion Z

[Px1, Py1, Pz1, Qw1, Qx1, Qy1, Qz1, Px2, Py2, Pz2, Qw2, Qx2, Qy2, Qz2, ... ]

Example

[0.0,0.0,0.0,1.0,0.0,0.0,0.0,1.0,0.0,2.0,1.0,0.0,0.0,0.0, ...]

Motion Factory uses a right-handed Y-Up Axis:

• X is left

• Y is up

• Z is forward.

Frame Rate

Root motion is locked to 30 fps, and any uploaded root motion paths will cause artefacts.

Recording at Runtime

If recording at runtime, we recommend plotting recorded values to a curve and then resampling at a constant 30 fps due to the uncertainty of frame intervals. You can then record at a higher frame rate and downsample the root motion to the JSON file before uploading.

Simulating paths

If simulating paths, you must simulate with an exact delta for 30 fps (0.33333 seconds).