Changes between Initial Version and Version 1 of PSA_File_Format

Timestamp:

Feb 23, 2008, 4:18:58 AM (16 years ago)

Author:

trac

Comment:

--

PSA_File_Format

@@ +1 @@
+PSA files store a skeletal animation, which consists of bone states at a number of keyframes (see [wiki:PMD_File_Format PMD File Format]). Animations can only be applied to models with the same number of bones in the same order (no bone names are used, only indices). Although PSA contains a name field and a frame length field, these are no longer used in the game since animation variants and total animation lengths (so the same animation can be reused with different lengths) are given in the actor XML files.
+
+All types are stored in little-endian format. Text is always ASCII. The following is the version 1 PSA format:
+
+{{{
+ PSA {
+    char magic[4];  // == "PSSA"
+    u32 version;  // == 1
+    u32 data_size;  // == filesize-12
+ 
+    u32 nameLength;
+    char name[nameLength];  // no longer used in the game
+ 
+    float frameLength;  // no longer used in the game, not valid for most of the animations
+ 
+    u32 numBones;
+    u32 numFrames;
+ 
+    BoneState boneStates[numBones * numFrames];
+ 
+    // the state of bone b at frame f is stored in boneStates[f * numBones + b]
+ }
+ 
+ BoneState {
+    Vector3D translation;
+    Quaternion rotation;
+ 
+    // the bone's final transform matrix is translation * rotation, as in PMD
+ }
+ 
+ Vector3D {
+    float x, y, z;
+ }
+ 
+ Quaternion {
+    float x, y, z, w;
+ }
+}}}