BMD and BDL - Revision history

LagoLunatic: Pixel engine mode

2023-10-11T07:04:09Z

Pixel engine mode

LagoLunatic: Add a couple unknowns

2023-08-16T06:01:18Z

Add a couple unknowns

LagoLunatic: Matrix type header

2023-08-09T02:40:16Z

Matrix type header

LagoLunatic: Make shape format a table, and fix matrix type

2023-08-09T02:38:59Z

Make shape format a table, and fix matrix type

LagoLunatic: Initial import of the MAT3 header and material entry format from the old wiki.

2022-01-01T22:05:32Z

Initial import of the MAT3 header and material entry format from the old wiki.

LagoLunatic: /* Header */

2020-08-29T21:39:19Z

‎Header

LagoLunatic: Document Do Not Inherit Parent Scale joint attribute

2020-02-25T23:38:25Z

Document Do Not Inherit Parent Scale joint attribute

Jasper: Fix wording for matrix groups

2020-02-24T23:41:30Z

Fix wording for matrix groups

Jasper at 01:06, 10 December 2019

2019-12-10T01:06:47Z

Jasper at 01:04, 10 December 2019

2019-12-10T01:04:22Z

@@ Line 650: / Line 650: @@
 ! Offset                !! Type !! Name !! Description
 |-
-| <center>0x000</center> || byte || Flag || Read by patched material, always 1?
+| <center>0x000</center> || byte || Pixel Engine Mode || 1 = Opaque, 2 = Alpha Test, 4 = Translucent
 |-
 | <center>0x001</center> || byte || Cull Mode Index ||
@@ Line 725: / Line 725: @@
   /*0x10*/ int SubPacketLocationOffset; // Sub-packet Location Offset
   /*0x14*/ int MatrixIndexOffset; // Matrix Index Offset
-  /*0x18*/ int Unknown0Offset; // Unknown0 Offset
+  /*0x18*/ int PixelEngineModesOffset;
   /*0x1C*/ int IndexesOffset;
   /*0x20*/ int StringTableOffset; //See JNT1
@@ Line 801: / Line 801: @@
 This value is found in the majority of files, sometimes alongside other values.
-==Unknown Section 3==
+==Pixel Engine Modes==
-'''This needs to be investigated.'''
+This is an array of bytes, padded to the nearest 8 with the standard padding string.
-The byte seems to match the value of the Flag at 0x00 of the material that the packet is associated with - either a value of 1 or 4. What this means is currently unknown.
+The byte is the same as the Pixel Engine Mode of the the material that the packet is associated with.
 =Texture Data (TEX1)=

@@ Line 698: / Line 698: @@
 | <center>0x104</center> || short[16] || Tev Swap Modes Info Indexes ||
 |-
-| <center>0x124</center> || short[4] || Tev Swap Mode Tables Indexes ||
+| <center>0x124</center> || short[16] || Tev Swap Mode Tables Indexes ||
 |-
 | <center>0x144</center> || short || Fog Info Index ||
@@ Line 708: / Line 706: @@
 | <center>0x148</center> || short || Blend Mode Index ||
 |-
-| <center>0x14A</center> || short || Unknown 1 ||
+| <center>0x14A</center> || short || NBT Scale Index ||
 |}

@@ Line 469: / Line 469: @@
 The Attributes Offset variable is the offset to the first vertex attribute to enable for the shape. After this first attribute is enabled, the next is enabled, and so on, until an attribute with the type 0xFF (null attribute) is encountered.
-Matrix Type is an enum that determines how the position and normal matrices are calculated for the shape.
+=== Matrix Type ===
 {| class="wikitable"

@@ Line 436: / Line 436: @@
 A shape is a series of draw calls that use the same vertex attributes. A shape also has a bounding box and a bounding sphere.
- // 0x28/40 bytes long
+{| class="wikitable"
- /*0x00*/ short DisplayFlags; // Contains some information about how the shape should be displayed (See below)
+|-
- /*0x02*/ short MatrixGroupCount; // How many matrix groups to this shape
+| <center>0x00</center> || byte || Matrix Type || See below
- /*0x04*/ short AttributesOffset; // Relative to SHP1Header.AttribsTableOffset
+|-
- /*0x06*/ short FirstMatrixDataIndex; // Index of the first MatrixData for this shape
+| <center>0x01</center> || byte || Padding || 0xFF
- /*0x08*/ short FirstMatrixGroupIndex; // Index to first matrix group ('MtxGroupCount' consecutive Indexes)
+|-
- /*0x0A*/ short Padding;
+| <center>0x02</center> || short || Matrix Group Count || How many matrix groups to this shape
- /*0x0C*/ float BoundingSphereRadius;
+|-
- /*0x10*/ float BBoxMinX;
+| <center>0x04</center> || short || Attributes Offset || Relative to SHP1Header.AttribsTableOffset
- /*0x14*/ float BBoxMinY;
+|-
- /*0x18*/ float BBoxMinZ;
+| <center>0x06</center> || short || First Matrix Data Index || Index of the first MatrixData for this shape
- /*0x1C*/ float BBoxMaxX;
+|-
- /*0x20*/ float BBoxMaxY;
+| <center>0x08</center> || short || First Matrix Group Index || Index to first matrix group ('Matrix Group Count' consecutive Indexes)
- /*0x24*/ float BBoxMaxZ;
+|-
-The AttributesOffset variable is the offset to the first vertex attribute to enable for the shape. After this first attribute is enabled, the next is enabled, and so on, until an attribute with the type 0xFF (null attribute) is encountered.
+The Attributes Offset variable is the offset to the first vertex attribute to enable for the shape. After this first attribute is enabled, the next is enabled, and so on, until an attribute with the type 0xFF (null attribute) is encountered.
-DisplayFlags is an enum that determines how the position and normal matrices are calculated for the shape.
+Matrix Type is an enum that determines how the position and normal matrices are calculated for the shape.
 {| class="wikitable"

← Older revision		Revision as of 22:05, 1 January 2022
Line 546:		Line 546:

	To-do		To-do
		+
		+	== Header ==
		+
		+	Size: 0x84 bytes.
		+
		+	{\| class="wikitable"
		+	\|-
		+	! Offset !! Type !! Name !! Description
		+	\|-
		+	\| <center>0x00</center> \|\| string \|\| Magic \|\| Should be "MAT3".
		+	\|-
		+	\| <center>0x04</center> \|\| int \|\| Section Size \|\|
		+	\|-
		+	\| <center>0x08</center> \|\| short \|\| Num Materials \|\|
		+	\|-
		+	\| <center>0x0A</center> \|\| short \|\| Padding 1 \|\|
		+	\|-
		+	\| <center>0x0C</center> \|\| int \|\| Material Entry Data Offset \|\|
		+	\|-
		+	\| <center>0x10</center> \|\| int \|\| Material Remap Table Offset \|\|
		+	\|-
		+	\| <center>0x14</center> \|\| int \|\| String Table Offset \|\|
		+	\|-
		+	\| <center>0x18</center> \|\| int \|\| Indirect Texturing Info Offset \|\|
		+	\|-
		+	\| <center>0x1C</center> \|\| int \|\| Cull Mode Info Offset \|\|
		+	\|-
		+	\| <center>0x20</center> \|\| int \|\| Material Colors Offset \|\|
		+	\|-
		+	\| <center>0x24</center> \|\| int \|\| Num Color Channels Offset \|\|
		+	\|-
		+	\| <center>0x28</center> \|\| int \|\| Color Channel Info Offset \|\|
		+	\|-
		+	\| <center>0x2C</center> \|\| int \|\| Ambient Colors Offset \|\|
		+	\|-
		+	\| <center>0x30</center> \|\| int \|\| Light Info Offset \|\|
		+	\|-
		+	\| <center>0x34</center> \|\| int \|\| Num Tex Gens Offset \|\|
		+	\|-
		+	\| <center>0x38</center> \|\| int \|\| Tex Gen Info Offset \|\|
		+	\|-
		+	\| <center>0x3C</center> \|\| int \|\| Post Tex Gen Info Offset \|\|
		+	\|-
		+	\| <center>0x40</center> \|\| int \|\| Tex Matrix Info Offset \|\|
		+	\|-
		+	\| <center>0x44</center> \|\| int \|\| Post Tex Matrix Info Offset \|\|
		+	\|-
		+	\| <center>0x48</center> \|\| int \|\| Texture Remap Table Offset \|\|
		+	\|-
		+	\| <center>0x4C</center> \|\| int \|\| Tev Order Info Offset \|\|
		+	\|-
		+	\| <center>0x50</center> \|\| int \|\| Tev Colors Offset \|\|
		+	\|-
		+	\| <center>0x54</center> \|\| int \|\| Tev Konst Colors Offset \|\|
		+	\|-
		+	\| <center>0x58</center> \|\| int \|\| Num Tev Stages Offset \|\|
		+	\|-
		+	\| <center>0x5C</center> \|\| int \|\| Tev Stage Info Offset \|\|
		+	\|-
		+	\| <center>0x60</center> \|\| int \|\| Tev Swap Mode Info Offset \|\|
		+	\|-
		+	\| <center>0x64</center> \|\| int \|\| Tev Swap Mode Table Info Offset \|\|
		+	\|-
		+	\| <center>0x68</center> \|\| int \|\| Fog Info Offset \|\|
		+	\|-
		+	\| <center>0x6C</center> \|\| int \|\| Alpha Compare Info Offset \|\|
		+	\|-
		+	\| <center>0x70</center> \|\| int \|\| Blend Mode Info Offset \|\|
		+	\|-
		+	\| <center>0x74</center> \|\| int \|\| ZMode Info Offset \|\|
		+	\|-
		+	\| <center>0x78</center> \|\| int \|\| ZCompare Info Offset \|\|
		+	\|-
		+	\| <center>0x7C</center> \|\| int \|\| Dither Info Offset \|\|
		+	\|-
		+	\| <center>0x80</center> \|\| int \|\| NBTScale Info Offset \|\|
		+	\|}
		+
		+	== Material Entry ==
		+
		+	Size: 0x14C bytes.
		+
		+	{\| class="wikitable"
		+	\|-
		+	! Offset !! Type !! Name !! Description
		+	\|-
		+	\| <center>0x000</center> \|\| byte \|\| Flag \|\| Read by patched material, always 1?
		+	\|-
		+	\| <center>0x001</center> \|\| byte \|\| Cull Mode Index \|\|
		+	\|-
		+	\| <center>0x002</center> \|\| byte \|\| Num Color Channel Controls Index \|\|
		+	\|-
		+	\| <center>0x003</center> \|\| byte \|\| Num Tex Gens Index \|\|
		+	\|-
		+	\| <center>0x004</center> \|\| byte \|\| Num Tev Stages Index \|\|
		+	\|-
		+	\| <center>0x005</center> \|\| byte \|\| ZCompLoc Index \|\|
		+	\|-
		+	\| <center>0x006</center> \|\| byte \|\| ZMode Index \|\|
		+	\|-
		+	\| <center>0x007</center> \|\| byte \|\| Dither Index \|\|
		+	\|-
		+	\| <center>0x008</center> \|\| short[2] \|\| Material Color Indexes \|\|
		+	\|-
		+	\| <center>0x00C</center> \|\| short[4] \|\| Color Channel Control Indexes \|\|
		+	\|-
		+	\| <center>0x014</center> \|\| short[2] \|\| Ambient Color Indexes \|\|
		+	\|-
		+	\| <center>0x018</center> \|\| short[8] \|\| Light Color Indexes \|\|
		+	\|-
		+	\| <center>0x028</center> \|\| short[8] \|\| Tex Gen Info Indexes \|\|
		+	\|-
		+	\| <center>0x038</center> \|\| short[8] \|\| Post Tex Gen Info Indexes \|\|
		+	\|-
		+	\| <center>0x048</center> \|\| short[10] \|\| Tex Matrix Indexes \|\|
		+	\|-
		+	\| <center>0x05C</center> \|\| short[20] \|\| Post Tex Matrix Indexes \|\|
		+	\|-
		+	\| <center>0x084</center> \|\| short[8] \|\| Texture Indexes \|\|
		+	\|-
		+	\| <center>0x094</center> \|\| short[4] \|\| Tev Konst Color Indexes \|\|
		+	\|-
		+	\| <center>0x09C</center> \|\| byte[16] \|\| Tev Konst Color Sels \|\|
		+	\|-
		+	\| <center>0x0AC</center> \|\| byte[16] \|\| Tev Konst Alpha Sels \|\|
		+	\|-
		+	\| <center>0x0BC</center> \|\| short[16] \|\| Tev Order Info Indexes \|\|
		+	\|-
		+	\| <center>0x0DC</center> \|\| short[4] \|\| Tev Color Indexes \|\|
		+	\|-
		+	\| <center>0x0E4</center> \|\| short[16] \|\| Tev Stage Info Indexes \|\|
		+	\|-
		+	\| <center>0x104</center> \|\| short[16] \|\| Tev Swap Modes Info Indexes \|\|
		+	\|-
		+	\| <center>0x124</center> \|\| short[4] \|\| Tev Swap Mode Tables Indexes \|\|
		+	\|-
		+	\| <center>0x12C</center> \|\| short[12] \|\| Unknown Indexes \|\|
		+	\|-
		+	\| <center>0x144</center> \|\| short \|\| Fog Info Index \|\|
		+	\|-
		+	\| <center>0x146</center> \|\| short \|\| Alpha Compare Index \|\|
		+	\|-
		+	\| <center>0x148</center> \|\| short \|\| Blend Mode Index \|\|
		+	\|-
		+	\| <center>0x14A</center> \|\| short \|\| Unknown 1 \|\|
		+	\|}

	=FIFO Data (MDL3)=		=FIFO Data (MDL3)=

@@ Line 344: / Line 344: @@
 | <center>0x08</center> || short || Joint Count ||
 |-
-| <center>0x08</center> || short || Padding || 0xFFFF
+| <center>0x0A</center> || short || Padding || 0xFFFF
 |-
 | <center>0x0C</center> || int || Joint Transform Table Offset ||

@@ Line 367: / Line 367: @@
 | <center>0x00</center> || MatrixTypeFlags (short) || Matrix Type Flags || Affects Joint Matrix Calculation
 |-
-| <center>0x02</center> || short || Misc Flags || Affects Joint Matrix Calculation
+| <center>0x02</center> || bool || Do Not Inherit Parent Scale ||
 |-
 | <center>0x04</center> || float || Scale X ||

@@ Line 259: / Line 259: @@
 ==Index and Weight tables==
-The joint indices and joint weights are used to scale each joint that affects the envelope matirx. The weights of each joints should add up to a sum of 1; otherwise, the vertexes do not move with the bones correctly.
+The joint indices and joint weights are used to scale each joint that affects the envelope matrix. The weights of each joints should add up to a sum of 1; otherwise, the vertexes do not move with the bones correctly.
 These arrays are paired -- that is, both the joint index and joint weight arrays should be the same size.
@@ Line 480: / Line 480: @@
 ==Matrix Table==
-This section stores indexes of draw matrices, as defined by DRW1.
+This section stores indexes of draw matrices, as defined by DRW1. There are 10 of them, and they map to the 10 hardware matrix slots available through GX.
-  // 2 bytes long
+  // 20 bytes long
-  /*0x00*/ short DrawMatrixIndex;
+  /*0x00*/ short DrawMatrixIndex[10];
-This section has an oddity. If a shape contains more than one matrix group, the index referenced by a vertex's position matrix index may end up being 0xFFFF/-1. If this is the case, then that means that the position matrix index must be walked back through the table to find the first value that isn't 0xFFFF/-1. In other words, if the value in the matrix table is -1, that means that the last valid index must be used.
+This index can also sometimes be 0xFFFF. If this happens, then the index for this slot should be taken from the previous matrix group. An index of 0xFFFF should not appear on the first matrix group.
 ==Primitive Display List Data==

@@ Line 646: / Line 646: @@
 The byte seems to match the value of the Flag at 0x00 of the material that the packet is associated with - either a value of 1 or 4. What this means is currently unknown.
 =Texture Data (TEX1)=
@@ Line 667: / Line 663: @@
 ==Embedded BTI Images==
 These are the actual textures. Information about embedded images can be found in the [[BTI|article]] about the BTI format.

@@ Line 334: / Line 334: @@
 ==Header==
- // 0x18/24 bytes long
+{| class="wikitable"
- /*0x00*/ char[4] Magic; //'JNT1'
+|-
- /*0x04*/ int Size; //Total bytes of chunk
+! Offset                !! Type !! Name !! Description
- /*0x08*/ short JointCount; //How many joints there are
+|-
- /*0x0A*/ short Padding;
+| <center>0x00</center> || char[4] || Chunk Type || JNT1
- /*0x0C*/ int JointConfigDataOffset; //Relative to JNT1Header start
+|-
- /*0x10*/ int ConfigTableOffset; //There are JointCount ushorts at this point.
+| <center>0x04</center> || int || Size ||
- /*0x14*/ int StringTableOffset; //Names of Joints
+|-
-There are JointCount joints. Each joint is defined as a name in the string array, and an index in the config table. The config table determines the joint's settings and initial configuration. It is possible, if unlikely, for two joints with different names to have the same configuration. In this case, JointConfigData will not have JointCount entries. These must be treated as two separate joints for the purposes of animation, or you might have off-by-one errors in your code and animation will be screwed up.
+There are JointCount joints. Each joint is defined as a name in the name table, and an index in the remap table. The config table determines the joint's settings and initial configuration. It is possible, if unlikely, for two joints with different names to have the same configuration. In this case, JointConfigData will not have JointCount entries. These should be treated as two separate joints that share a single configuration.
-==Joint Configuration Data==
+== Joint Transformation Data ==
- // 0x40/64 bytes long
+This includes scaling, rotation, and translation data for the joint, as well as a bounding sphere radius and bounding box information.
- /*0x00*/ short MtxTypeFlags; //Always 0, 1 or 2
- /*0x02*/ short MiscFlags; //TODO: document
+{| class="wikitable"
- /*0x04*/ float ScaleX;
+|-
- /*0x08*/ float ScaleY;
+! Offset                !! Type !! Name !! Description
- /*0x0C*/ float ScaleZ;
+|-
- /*0x10*/ short RotationX; //-32768 = -180 deg, 32767 = 180 deg. float degrees = ((float)rotShort * 180.0f) / 32767.0f;
+| <center>0x00</center> || MatrixTypeFlags (short) || Matrix Type Flags || Affects Joint Matrix Calculation
- /*0x12*/ short RotationY;
+|-
- /*0x14*/ short RotationZ;
+| <center>0x02</center> || short || Misc Flags || Affects Joint Matrix Calculation
- /*0x16*/ short Padding;
+|-
- /*0x18*/ float TranslationX;
+| <center>0x04</center> || float || Scale X ||
- /*0x1C*/ float TranslationY;
+|-
- /*0x20*/ float TranslationZ;
+| <center>0x08</center> || float || Scale Y ||
- /*0x24*/ float BoundingSphereRadius;
+|-
- /*0x28*/ float BBoxMinX;
+| <center>0x0C</center> || float || Scale Z ||
- /*0x2C*/ float BBoxMinY;
+|-
- /*0x30*/ float BBoxMinZ;
+| <center>0x10</center> || short || Rotation X ||
- /*0x34*/ float BBoxMaxX;
+|-
- /*0x38*/ float BBoxMaxY;
+| <center>0x12</center> || short || Rotation Y ||
- /*0x3C*/ float BBoxMaxZ;
+|-
 =Shape Data (SHP1)=