MOTN - Revision history

LemonHaze: Added more MOTN info

2021-05-29T23:20:04Z

Added more MOTN info

← Older revision		Revision as of 00:20, 30 May 2021
Line 114:		Line 114:
	The fifth and last block contains the actual data for the keyframes.<br>		The fifth and last block contains the actual data for the keyframes.<br>
	Each entry in the block is 2 bytes in size and could be interpreted as degrees.		Each entry in the block is 2 bytes in size and could be interpreted as degrees.

			Sequences are expressed using a minimal skeleton hierarchy designed for use with a full-body IK solver which is somewhat custom to the original games (more info here: https://www.shenmuedojo.com/forum/index.php?threads/development-log-3.3595/)

			Keyframes are described using the instructions as detailed above, which also pack the bones they are associated with. Function curves are used for interpolation and as such, keyframe data may store a left and right slope/tangent if necessary. Values stored within keyframes are half-precision floats, which are then expanded to 32-bit full-precision floats at runtime.

			Keyframes are parsed and a structure such as the following is constructed:

			<syntaxhighlight lang="cpp">
			struct struct_FCVKey {
			fp32 fp32_time;
			fp16 fp16_left_slope;
			fp16 fp16_right_slope;
			fp16 fp16_value;

			uint16_t reserved[3];
			};
			</syntaxhighlight>

2021-05-29T23:12:43Z

Added descriptions for segment layout

← Older revision		Revision as of 00:12, 30 May 2021
Line 9:		Line 9:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! Section		! Section !! Description
	\|-		\|-
	\| Header		\| Header \|\| File description
	\|-		\|-
	\| Sequence Data Table		\| Sequence Data Table \|\| Pointers to sequence data blocks
	\|-		\|-
	\| Unknown Extra Data		\| Unknown Extra Data \|\| Extra data for sequence data
	\|-		\|-
	\| Sequence Name Table		\| Sequence Name Table \|\| Sequence names
	\|-		\|-
	\| Sequence Data		\| Sequence Data \|\| Animation data
	\|}		\|}

2021-05-29T22:25:24Z

Corrected bone index description

← Older revision		Revision as of 23:25, 29 May 2021
Line 81:		Line 81:
	! Bit-Mask !! Description		! Bit-Mask !! Description
	\|-		\|-
	\| ~~0xFE00~~ \|\| Node ID/Bone ID?		\| ins >> 9 \|\| Node ID/Bone ID
	\|-		\|-
	\| 0x0100 \|\| Translation X channel available		\| 0x0100 \|\| Translation X channel available
Line 95:		Line 95:
	\| 0x0008 \|\| Rotation Z channel available		\| 0x0008 \|\| Rotation Z channel available
	\|-		\|-
	\| 0x0007 \|\| ~~Unknown~~		\| 0x0007 \|\| Reserved
	\|}		\|}

2019-06-15T14:51:38Z

Block 1

← Older revision		Revision as of 15:51, 15 June 2019
Line 83:		Line 83:
	\| 0xFE00 \|\| Node ID/Bone ID?		\| 0xFE00 \|\| Node ID/Bone ID?
	\|-		\|-
	\| 0x0100 \|\| ~~First~~ X? channel available		\| 0x0100 \|\| Translation X channel available
	\|-		\|-
	\| 0x0080 \|\| ~~First~~ Y? channel available		\| 0x0080 \|\| Translation Y channel available
	\|-		\|-
	\| 0x0040 \|\| ~~First~~ Z? channel available		\| 0x0040 \|\| Translation Z channel available
	\|-		\|-
	\| 0x0020 \|\| ~~Second~~ X? channel available		\| 0x0020 \|\| Rotation X channel available
	\|-		\|-
	\| 0x0010 \|\| ~~Second~~ Y? channel available		\| 0x0010 \|\| Rotation Y channel available
	\|-		\|-
	\| 0x0008 \|\| ~~Second~~ Z? channel available		\| 0x0008 \|\| Rotation Z channel available
	\|-		\|-
	\| 0x0007 \|\| Unknown		\| 0x0007 \|\| Unknown

2019-06-14T21:27:59Z

Block 3

← Older revision		Revision as of 22:27, 14 June 2019
Line 103:		Line 103:

	====Block 3====		====Block 3====
	The third block contains ~~unknown~~ data.<br>		The third block contains frame index data.<br>
	Each entry in the block is 2 bytes or 1 bytes in size depending on the flag.		Each entry in the block is 2 bytes or 1 bytes in size depending on the flag.<br>
			Each frame is 0.0333333 milliseconds (30 FPS)

	====Block 4====		====Block 4====

2019-06-05T18:13:38Z

Sequence Data

@@ Line 58: / Line 58: @@
 ===Sequence Data===
 {| class="wikitable"
 |-
 ! Position !! Length !! Type !! Description
 |-
-| 0x00 || 0x04 || uint || Unknown
+| 0x00 || 0x04 || uint || Flag (decides the byte size for the block 2 and block 3 entries)
 |-
-| 0x04 || 0x02 || ushort || First block offset
+| 0x04 || 0x02 || ushort || Block 1 end offset/Block 2 start offset
 |-
-| 0x06 || 0x02 || ushort || Second block offset
+| 0x06 || 0x02 || ushort || Block 2 end offset/Block 3 start offset
 |-
-| 0x08 || 0x02 || ushort || Third block offset
+| 0x08 || 0x02 || ushort || Block 3 end offset/Block 4 start offset
 |}

2019-06-05T18:01:19Z

Structure

2019-04-27T11:25:51Z

@@ Line 5: / Line 5: @@
 The MOTN file format contains the animations for models based on their node structure.<br>
 This format can be found in various PKS files and in the motion.bin file.<br>
 ===Header===
@@ Line 42: / Line 58: @@
 ===Sequence Data===

2019-04-26T05:48:32Z

← Older revision		Revision as of 06:48, 26 April 2019
Line 13:		Line 13:
	\| 0x00 \|\| 0x04 \|\| uint \|\| Sequence data table offset		\| 0x00 \|\| 0x04 \|\| uint \|\| Sequence data table offset
	\|-		\|-
	\| 0x04 \|\| 0x04 \|\| uint \|\| Sequence ~~name~~ offset		\| 0x04 \|\| 0x04 \|\| uint \|\| Sequence names offset
	\|-		\|-
	\| 0x08 \|\| 0x04 \|\| uint \|\| Sequence data offset		\| 0x08 \|\| 0x04 \|\| uint \|\| Sequence data offset
Line 29:		Line 29:
	\| 0x00000FFF \|\| uint12_t \|\| Sequence count		\| 0x00000FFF \|\| uint12_t \|\| Sequence count
	\|}		\|}

			===Sequence Data Table===
			The sequence data table consists out of two offsets (each unsigned 32bit) per sequence.<br>
			Both offsets point inside the sequence data segment.<br>
			The first offset points to the main sequence data containing the key frames.<br>
			The second offset points to some unknown data array.<br>

	===Sequence Name Table===		===Sequence Name Table===
Line 34:		Line 40:
	The amount of names is given by the sequence count inside the header.<br>		The amount of names is given by the sequence count inside the header.<br>
	The strings are zero terminated/seperated.		The strings are zero terminated/seperated.

			===Sequence Data===

2019-04-26T05:14:27Z

← Older revision		Revision as of 06:14, 26 April 2019
Line 11:		Line 11:
	! Position !! Length !! Type !! Description		! Position !! Length !! Type !! Description
	\|-		\|-
	\| 0x00 \|\| 0x04 \|\| uint \|\| ~~Motion~~ data table offset		\| 0x00 \|\| 0x04 \|\| uint \|\| Sequence data table offset
	\|-		\|-
	\| 0x04 \|\| 0x04 \|\| uint \|\| ~~Motion~~ name offset		\| 0x04 \|\| 0x04 \|\| uint \|\| Sequence name offset
	\|-		\|-
	\| 0x08 \|\| 0x04 \|\| uint \|\| ~~Motion~~ data offset		\| 0x08 \|\| 0x04 \|\| uint \|\| Sequence data offset
	\|-		\|-
	\| 0x0C \|\| 0x04 \|\| Attributes \|\| Attributes		\| 0x0C \|\| 0x04 \|\| Attributes \|\| Attributes
Line 27:		Line 27:
	! Mask !! Type !! Description		! Mask !! Type !! Description
	\|-		\|-
	\| 0x00000FFF \|\| uint12_t \|\| ~~Animation~~ count		\| 0x00000FFF \|\| uint12_t \|\| Sequence count
	\|}		\|}

			===Sequence Name Table===
			The sequence name table consists out of the offsets (unsigned 32bit) to the strings and the strings themself.<br>
			The amount of names is given by the sequence count inside the header.<br>
			The strings are zero terminated/seperated.