1.1 --- a/doc/goatanimfmt	Sat Oct 05 03:08:22 2013 +0300
     1.2 +++ b/doc/goatanimfmt	Sat Oct 05 21:19:10 2013 +0300
     1.3 @@ -1,3 +1,34 @@
     1.4 -goat3d animation file format
     1.5 +Goat3D animation file format
     1.6  ----------------------------
     1.7 -TODO
     1.8 +
     1.9 +Chunk structure
    1.10 +---------------
    1.11 +Multiple tracks might apply to the same node, to allow for different
    1.12 +interpolation, extrapolation, and time ranges between position, rotation, and
    1.13 +scaling tracks.
    1.14 +
    1.15 +ANIM
    1.16 + +--ANIM_NAME
    1.17 + |   +--<STRING>
    1.18 + +--TRACK
    1.19 +     +--TRACK_NAME
    1.20 +     |   +--<STRING>
    1.21 +     +--TRACK_NODE
    1.22 +     |   +--<STRING>	(name of the scene node using this track)
    1.23 +     +--TRACK_ATTR
    1.24 +     |   +--<STRING>	(specify the attribute affected, see NOTE1)
    1.25 +     +--TRACK_INTERP
    1.26 +     |   +--<STRING>    ("step", "linear", "cubic")
    1.27 +     +--TRACK_EXTRAP
    1.28 +     |   +--<STRING>	("extend", "clamp", "repeat", "pingpong")
    1.29 +     +--TRACK_KEY
    1.30 +         +--TRACK_KEY_TIME
    1.31 +         |   +--<INT>	(time in milliseconds)
    1.32 +         +--TRACK_KEY_VALUE
    1.33 +             +--<FLOAT|FLOAT3|FLOAT4>
    1.34 +
    1.35 +NOTE1: The attribute might be any user-defined string, but the following
    1.36 +standard attribute names are specified:
    1.37 + - "position" keys are (x,y,z) vectors
    1.38 + - "rotation" keys are (x,y,z,w) quaternions, with w being the real part
    1.39 + - "scaling" keys are (x,y,z) scale factors