BTK - Revision history

LagoLunatic: Add hex byte padding to clarify byte size of MatrixMode

2022-07-13T15:34:51Z

Add hex byte padding to clarify byte size of MatrixMode

2022-07-13T15:26:18Z

Various minor fixes

2019-12-10T00:51:40Z

2019-12-10T00:51:32Z

2019-12-10T00:51:07Z

2019-12-10T00:48:35Z

2019-12-10T00:47:55Z

2019-12-09T23:35:40Z

‎Material Name and Texture Coordinate Index

2019-12-09T23:34:58Z

‎Calculating the SRT Texture Matrix

2019-12-09T23:34:02Z

@@ Line 57: / Line 57: @@
 ! Value !! Name || Meaning
 |-
-| 0x00 || Basic Mode ||
+| 0x00000000 || Basic Mode ||
 |-
-| 0x01 || Maya Mode ||
+| 0x00000001 || Maya Mode ||
 |}

@@ Line 5: / Line 5: @@
 The file starts with a standard [[JSYSTEM#Header|JSYSTEM]] header, using a magic of J3D1btk1. BTK files have one chunk, the TTK1 chunk.
-=TTK1=
+=TTK1 Chunk=
 {| class="wikitable"
@@ Line 27: / Line 25: @@
 | <center>0x10</center> || short || Rotation Table Count || The number of entries in the rotation table
 |-
-| <center>0x12</center> || short || Translation Table Count || The number of entries in the rotation table
+| <center>0x12</center> || short || Translation Table Count || The number of entries in the translation table
 |-
 | <center>0x14</center> || int || Animation Data Table Offset || Offset to the start of the animation data table
@@ Line 50: / Line 48: @@
 |-
 |}
 MatrixMode is an enum as follows:

@@ Line 12: / Line 12: @@
 |-
 ! Offset                !! Type !! Name !! Description
 | <center>0x00</center> || [[JSYSTEM#Chunk_Data|Chunk Header]] || Standard JSYSTEM chunk header
 |-

@@ Line 14: / Line 14: @@
 | <center>0x00</center> || [[JSYSTEM#Chunk_Data|Chunk Header]] || Standard JSYSTEM chunk header
 |-
-| <center>0x08</center> || [[BCK#LoopMode]] || Loop Mode ||
+| <center>0x08</center> || [[BCK#LoopMode|Loop Mode]] || Loop Mode ||
 |-
 | <center>0x09</center> || int || Rotation Frac || Multiplier for fixed-point decimal

@@ Line 1: / Line 1: @@
-'''BTK''' is stores texture matrix animation data.
+'''BTK''' stores texture matrix animation data.
 =JSYSTEM header=
@@ Line 6: / Line 6: @@
 =TTK1=
 ==Header==
@@ Line 14: / Line 12: @@
 |-
 ! Offset                !! Type !! Name !! Description
 |-
-| <center>0x08</center> || LoopMode || Loop Mode ||
+| <center>0x08</center> || [[BCK#LoopMode]] || Loop Mode ||
 |-
 | <center>0x09</center> || int || Rotation Frac || Multiplier for fixed-point decimal
@@ Line 49: / Line 48: @@
 | <center>0x5C</center> || MatrixMode || Matrix Mode || Determines whether texture coordinates should be calculated with the Basic or Maya algorithm. This field is not read in Sunshine's copy of JSYSTEM, hardcoding the Basic mode, and their tooling seems to have output uninitialized data instead of a valid enum value. It is explicitly checked to equal exactly 0x01 in Wind Waker onwards, likely for this reason.
 |-
 |}

@@ Line 7: / Line 7: @@
 =TTK1=
-This follows the standard header and contains data specific to the BTK format. It includes keyframe data for each texture being manipulated, as well as the actual key data in the form of data banks.
+This follows the standard header and contains data specific to the BTK format. It includes the animation data for each texture matrix being manipulated.
 ==Header==

@@ Line 83: / Line 83: @@
 ==Material Name and Texture Coordinate Index==
-The material name and texture coordinate index tell you how to bind the animation to a model. Animations are always bound by material name and texture coordinate index. The material name table is a [[JSYSTEM|JUTNameTab]] table. The table entries are laid out as follows:
+The material name and texture coordinate index tell you how to bind the animation to a model. Animations are always bound by material name and texture coordinate index. The material name table is a [[JSYSTEM#Name_Tables|JUTNameTab]] table. The table entries are laid out as follows:
 {| class="wikitable"

@@ Line 129: / Line 129: @@
 === Maya Mode ===
-The Scale S, ScaleT, Rotation Q, Translation S and Translation T inputs are used. The final matrix is a 3x2 matrix, which is as follows:
+The Scale S, Scale T, Rotation Q, Translation S and Translation T inputs are used. The final matrix is a 3x2 matrix, which is as follows:
 = Scale S * cos(Rotation Q)