ZeldaMods (Breath of the Wild) - User contributions [en]

TSCB

2020-05-22T13:28:22Z

THplusplus: /* Extra Information Array Value Table */

<onlyinclude>
'''T'''errain '''sc'''ene '''b'''inary (TSCB) files describe terrain areas layout and terrain materials.
</onlyinclude>

==TSCB File Specification==

===Header===
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|String
|TSCB file signature (magic) <code>54 53 43 42</code> or "TSCB"
|-
|<code>0x04</code>
|4
|Unsigned Int
|TSCB version? <code>0A 00 00 00</code> or "10.0.0.0"<ref>U-King.elf:0x024D2F8C-0x024D300A holds two error messages: "【データロード】メジャーバージョンの不一致" ("[Data load] Major version mismatch") and "【データロード】マイナーバージョンの不一致" ("[Data Load] Minor version mismatch")</ref><ref>Game crashes on load screen if not equal to <code>0A 00 00 00</code></ref>
|-
|<code>0x08</code>
|4
|Unsigned Int
|Unknown. Always <code>00 00 00 01</code>. Game crashes on load screen if not equal to <code>00 00 00 01</code>.
|-
|<code>0x0c</code>
|4
|Unsigned Int
|<code>file_base</code> table relative offset
|-
|<code>0x10</code>
|4
|Float
|<code>world_scale</code> <code>500.0</code>. Scales the terrain along the x- and z-axis.
|-
|<code>0x14</code>
|4
|Float
|Terrain mesh max height <code>800.0</code>. Used to calculate the actual vertex height with [[HGHT|hght]] data.
|-
|<code>0x18</code>
|4
|Unsigned Int
|<code>material_info_array</code> length (number of elements in the array)
|-
|<code>0x1c</code>
|4
|Unsigned Int
|<code>area_array</code> length (number of elements in the array)
|-
|<code>0x20</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x24</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x28</code>
|4
|Float
|<code>tile_size</code>. Used by the area array.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|Unknown <code>00 00 00 08</code>. <ref>Values <code>1</code>, <code>2</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>8</code>, <code>9</code>, <code>10</code>, <code>13</code>, <code>14</code> affects textures. <code>0</code>, <code>3</code>, <code>7</code>, <code>11</code>, <code>12</code>, <code>15</code>, <code>16</code> will crash the game.</ref>
|}

==Material Information Array==
The material information array references texture data contained in <code>content/Model/Terrain.Tex1.sbfres</code>.

===Header===
The material information header is one value, the section size. This includes the index table and the value table.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Material info section size in bytes
|}

===Material Information Array Lookup Table===
Following the header is a table of relative offsets to each entry in <code>material_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

===Material Information Value Table===
Each entry in the array contains an index and four attributes
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Array index (<code>mat_index</code>) of <code>material_info_array</code>
|-
|<code>0x04</code>
|4
|Float
|Texture u-axis (x-axis)
|-
|<code>0x08</code>
|4
|Float
|Texture v-axis (y-axis)
|-
|<code>0x0c</code>
|4
|Float
|Unknown. values range from 0-1.
|-
|<code>0x10</code>
|4
|Float
|Unknown. values range from 0.2-1.63
|}

==Area Array==

===Area Array Lookup Table===
Following the material information section is a table of relative offsets to each entry in area_array
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

===Area Array Value Table===
Each entry contains meta data for one tile in the terrain scene. There are multiple levels of detail (lod) for the terrain.

Entry size ranges from <code>0x30</code> to <code>0x58</code> depending on the size of <code>extra_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Float
|X Position
|-
|<code>0x04</code>
|4
|Float
|Z Position
|-
|<code>0x08</code>
|4
|Float
|<code>area_size</code> (length and width)
|-
|<code>0x0c</code>
|4
|Float
|Unknown - Affects grass density.<ref>0 may be default. Higher numbers have increased density.</ref>
|-
|<code>0x10</code>
|4
|Float
|Unknown
|-
|<code>0x14</code>
|4
|Float
|Unknown
|-
|<code>0x18</code>
|4
|Float
|Unknown
|-
|<code>0x1c</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>, <code>1</code> or <code>2</code>, crashes on <code>4</code>, <code>16</code>.<ref>May be a flag for grass and water? <code>0</code> seems to indicate no water or grass.</ref>
|-
|<code>0x20</code>
|4
|Unsigned Int
|<code>file_base</code>. Relative offset to file base name string.
|-
|<code>0x24</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x28</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|<code>ref_extra</code>. It seems to be a flag to indicate if there is an attached <code>extra_info_array</code>
|}

====Parameters====
<code>x</code> - Area tile x coordinate (East-West)

<code>z</code> - Area tile z coordinate (North-South)
<code>area_size</code> - Determines the length and width of the area. It can be calculated with:<blockquote><code>(area_size / tile_size * world_scale) * 20</code></blockquote><code>tile_size</code> and <code>world_scale</code> are in the header.

===Extra Information Array===
if <code>ref_extra</code> does not equal <code>0</code> there is an <code>extra_info_array</code> attached to this area. The array is 4 or 8 values long.

Every area includes a [[HGHT|.hght]] and [[MATE|.mate]] file. The <code>extra_info_array</code> indicates if there is an additional [[Water.extm|.water.extm]] and / or [[Grass.extm|.grass.extm]] file

====Header====
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|extra_info_array length. Number of values (not elements) in array.
|-
|<code>(0x04)</code>
|4
|Unsigned Int
|Unknown. Always 20, but only present when extra_info_array length is 8.
|}

====Extra Information Array Value Table====
After the Header, there are <code>extra_info_array length / 4</code> elements of this structure.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|0x00
|4
|Unsigned Int
|Unknown. Always 3.
|-
|0x04
|4
|Unsigned Int
|Unknown. 0 or 1.
|-
|0x08
|4
|Unsigned Int
|Unknown. Always 1.
|-
|0x0c
|4
|Unsigned Int
|Unknown. Always 0.
|}
[3, 0, 1, 0, 3, 1, 1, 0] = grass, water
[3, 1, 1, 0, 3, 0, 1, 0] = water, grass
[3, 1, 1, 0] = water
[3, 0, 1, 0] = grass
It seems that water is <code>[3, 1, 1]</code> and grass is <code>[3, 0, 1]</code>

==<code>stera</code> File Positions==
[[File:Stera_File_Positions.png|alt=stera File Positions|thumb|<code>stera</code> File Positions]]
<code>stera</code> files referenced in the area array are positioned using a [[wikipedia:Z-order_curve|z-order curve]] or the [[wikipedia:Moser–de_Bruijn_sequence|Moser-de Bruijn sequence]].
<references />
[[Category:File formats]]
[[Category:File extensions]]
[[Category:File extensions (STERA)]]

TSCB

2020-05-21T15:15:29Z

THplusplus:

<onlyinclude>
'''T'''errain '''sc'''ene '''b'''inary (TSCB) files describe terrain areas layout and terrain materials.
</onlyinclude>

==TSCB File Specification==

===Header===
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|String
|TSCB file signature (magic) <code>54 53 43 42</code> or "TSCB"
|-
|<code>0x04</code>
|4
|Unsigned Int
|TSCB version? <code>0A 00 00 00</code> or "10.0.0.0"<ref>U-King.elf:0x024D2F8C-0x024D300A holds two error messages: "【データロード】メジャーバージョンの不一致" ("[Data load] Major version mismatch") and "【データロード】マイナーバージョンの不一致" ("[Data Load] Minor version mismatch")</ref><ref>Game crashes on load screen if not equal to <code>0A 00 00 00</code></ref>
|-
|<code>0x08</code>
|4
|Unsigned Int
|Unknown. Always <code>00 00 00 01</code>. Game crashes on load screen if not equal to <code>00 00 00 01</code>.
|-
|<code>0x0c</code>
|4
|Unsigned Int
|<code>file_base</code> table relative offset
|-
|<code>0x10</code>
|4
|Float
|<code>world_scale</code> <code>500.0</code>. Scales the terrain along the x- and z-axis.
|-
|<code>0x14</code>
|4
|Float
|Terrain mesh max height <code>800.0</code>. Used to calculate the actual vertex height with [[HGHT|hght]] data.
|-
|<code>0x18</code>
|4
|Unsigned Int
|<code>material_info_array</code> length (number of elements in the array)
|-
|<code>0x1c</code>
|4
|Unsigned Int
|<code>area_array</code> length (number of elements in the array)
|-
|<code>0x20</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x24</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x28</code>
|4
|Float
|<code>tile_size</code>. Used by the area array.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|Unknown <code>00 00 00 08</code>. <ref>Values <code>1</code>, <code>2</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>8</code>, <code>9</code>, <code>10</code>, <code>13</code>, <code>14</code> affects textures. <code>0</code>, <code>3</code>, <code>7</code>, <code>11</code>, <code>12</code>, <code>15</code>, <code>16</code> will crash the game.</ref>
|}

==Material Information Array==
The material information array references texture data contained in <code>content/Model/Terrain.Tex1.sbfres</code>.

===Header===
The material information header is one value, the section size. This includes the index table and the value table.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Material info section size in bytes
|}

===Material Information Array Lookup Table===
Following the header is a table of relative offsets to each entry in <code>material_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

===Material Information Value Table===
Each entry in the array contains an index and four attributes
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Array index (<code>mat_index</code>) of <code>material_info_array</code>
|-
|<code>0x04</code>
|4
|Float
|Texture u-axis (x-axis)
|-
|<code>0x08</code>
|4
|Float
|Texture v-axis (y-axis)
|-
|<code>0x0c</code>
|4
|Float
|Unknown. values range from 0-1.
|-
|<code>0x10</code>
|4
|Float
|Unknown. values range from 0.2-1.63
|}

==Area Array==

===Area Array Lookup Table===
Following the material information section is a table of relative offsets to each entry in area_array
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

===Area Array Value Table===
Each entry contains meta data for one tile in the terrain scene. There are multiple levels of detail (lod) for the terrain.

Entry size ranges from <code>0x30</code> to <code>0x58</code> depending on the size of <code>extra_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Float
|X Position
|-
|<code>0x04</code>
|4
|Float
|Z Position
|-
|<code>0x08</code>
|4
|Float
|<code>area_size</code> (length and width)
|-
|<code>0x0c</code>
|4
|Float
|Unknown - Affects grass density.<ref>0 may be default. Higher numbers have increased density.</ref>
|-
|<code>0x10</code>
|4
|Float
|Unknown
|-
|<code>0x14</code>
|4
|Float
|Unknown
|-
|<code>0x18</code>
|4
|Float
|Unknown
|-
|<code>0x1c</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>, <code>1</code> or <code>2</code>, crashes on <code>4</code>, <code>16</code>.<ref>May be a flag for grass and water? <code>0</code> seems to indicate no water or grass.</ref>
|-
|<code>0x20</code>
|4
|Unsigned Int
|<code>file_base</code>. Relative offset to file base name string.
|-
|<code>0x24</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x28</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|<code>ref_extra</code>. It seems to be a flag to indicate if there is an attached <code>extra_info_array</code>
|}

====Parameters====
<code>x</code> - Area tile x coordinate (East-West)

<code>z</code> - Area tile z coordinate (North-South)
<code>area_size</code> - Determines the length and width of the area. It can be calculated with:<blockquote><code>(area_size / tile_size * world_scale) * 20</code></blockquote><code>tile_size</code> and <code>world_scale</code> are in the header.

===Extra Information Array===
if <code>ref_extra</code> does not equal <code>0</code> there is an <code>extra_info_array</code> attached to this area. The array is 4 or 8 values long.

Every area includes a [[HGHT|.hght]] and [[MATE|.mate]] file. The <code>extra_info_array</code> indicates if there is an additional [[Water.extm|.water.extm]] and / or [[Grass.extm|.grass.extm]] file

====Header====
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|extra_info_array length. Number of values (not elements) in array.
|-
|<code>(0x04)</code>
|4
|Unsigned Int
|Unknown. Always 20, but only present when extra_info_array length is 8.
|}

====Extra Information Array Value Table====
After the Header, there is <code>extra_info_array length</code> / 4 elements of this structure.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|0x00
|4
|Unsigned Int
|Unknown. Always 3.
|-
|0x04
|4
|Unsigned Int
|Unknown. 0 or 1.
|-
|0x08
|4
|Unsigned Int
|Unknown. Always 1.
|-
|0x0c
|4
|Unsigned Int
|Unknown. Always 0.
|}
[3, 0, 1, 0, 3, 1, 1, 0] = grass, water
[3, 1, 1, 0, 3, 0, 1, 0] = water, grass
[3, 1, 1, 0] = water
[3, 0, 1, 0] = grass
It seems that water is <code>[3, 1, 1]</code> and grass is <code>[3, 0, 1]</code>

==<code>stera</code> File Positions==
[[File:Stera_File_Positions.png|alt=stera File Positions|thumb|<code>stera</code> File Positions]]
<code>stera</code> files referenced in the area array are positioned using a [[wikipedia:Z-order_curve|z-order curve]] or the [[wikipedia:Moser–de_Bruijn_sequence|Moser-de Bruijn sequence]].
<references />
[[Category:File formats]]
[[Category:File extensions]]
[[Category:File extensions (STERA)]]

TSCB

2020-05-21T14:53:35Z

THplusplus: More in depth exploration of the Extra Information Array structure.

<onlyinclude>
'''T'''errain '''sc'''ene '''b'''inary (TSCB) files describe terrain areas layout and terrain materials.
</onlyinclude>

== TSCB File Specification ==

=== Header ===
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|String
|TSCB file signature (magic) <code>54 53 43 42</code> or "TSCB"
|-
|<code>0x04</code>
|4
|Unsigned Int
|TSCB version? <code>0A 00 00 00</code> or "10.0.0.0"<ref>U-King.elf:0x024D2F8C-0x024D300A holds two error messages: "【データロード】メジャーバージョンの不一致" ("[Data load] Major version mismatch") and "【データロード】マイナーバージョンの不一致" ("[Data Load] Minor version mismatch")</ref><ref>Game crashes on load screen if not equal to <code>0A 00 00 00</code></ref>
|-
|<code>0x08</code>
|4
|Unsigned Int
|Unknown. Always <code>00 00 00 01</code>. Game crashes on load screen if not equal to <code>00 00 00 01</code>.
|-
|<code>0x0c</code>
|4
|Unsigned Int
|<code>file_base</code> table relative offset
|-
|<code>0x10</code>
|4
|Float
|<code>world_scale</code> <code>500.0</code>. Scales the terrain along the x- and z-axis.
|-
|<code>0x14</code>
|4
|Float
|Terrain mesh max height <code>800.0</code>. Used to calculate the actual vertex height with [[HGHT|hght]] data.
|-
|<code>0x18</code>
|4
|Unsigned Int
|<code>material_info_array</code> length (number of elements in the array)
|-
|<code>0x1c</code>
|4
|Unsigned Int
|<code>area_array</code> length (number of elements in the array)
|-
|<code>0x20</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x24</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x28</code>
|4
|Float
|<code>tile_size</code>. Used by the area array.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|Unknown <code>00 00 00 08</code>. <ref>Values <code>1</code>, <code>2</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>8</code>, <code>9</code>, <code>10</code>, <code>13</code>, <code>14</code> affects textures. <code>0</code>, <code>3</code>, <code>7</code>, <code>11</code>, <code>12</code>, <code>15</code>, <code>16</code> will crash the game.</ref>
|}

== Material Information Array ==
The material information array references texture data contained in <code>content/Model/Terrain.Tex1.sbfres</code>.

=== Header ===
The material information header is one value, the section size. This includes the index table and the value table.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Material info section size in bytes
|}

=== Material Information Array Lookup Table ===
Following the header is a table of relative offsets to each entry in <code>material_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

=== Material Information Value Table ===
Each entry in the array contains an index and four attributes
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Array index (<code>mat_index</code>) of <code>material_info_array</code>
|-
|<code>0x04</code>
|4
|Float
|Texture u-axis (x-axis)
|-
|<code>0x08</code>
|4
|Float
|Texture v-axis (y-axis)
|-
|<code>0x0c</code>
|4
|Float
|Unknown. values range from 0-1.
|-
|<code>0x10</code>
|4
|Float
|Unknown. values range from 0.2-1.63
|}

== Area Array ==

=== Area Array Lookup Table ===
Following the material information section is a table of relative offsets to each entry in area_array
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

=== Area Array Value Table ===
Each entry contains meta data for one tile in the terrain scene. There are multiple levels of detail (lod) for the terrain.

Entry size ranges from <code>0x30</code> to <code>0x58</code> depending on the size of <code>extra_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Float
|X Position
|-
|<code>0x04</code>
|4
|Float
|Z Position
|-
|<code>0x08</code>
|4
|Float
|<code>area_size</code> (length and width)
|-
|<code>0x0c</code>
|4
|Float
|Unknown - Affects grass density.<ref>0 may be default. Higher numbers have increased density.</ref>
|-
|<code>0x10</code>
|4
|Float
|Unknown
|-
|<code>0x14</code>
|4
|Float
|Unknown
|-
|<code>0x18</code>
|4
|Float
|Unknown
|-
|<code>0x1c</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>, <code>1</code> or <code>2</code>, crashes on <code>4</code>, <code>16</code>.<ref>May be a flag for grass and water? <code>0</code> seems to indicate no water or grass.</ref>
|-
|<code>0x20</code>
|4
|Unsigned Int
|<code>file_base</code>. Relative offset to file base name string.
|-
|<code>0x24</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x28</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|<code>ref_extra</code>. It seems to be a flag to indicate if there is an attached <code>extra_info_array</code>
|}

==== Parameters ====
<code>x</code> - Area tile x coordinate (East-West)

<code>z</code> - Area tile z coordinate (North-South)
<code>area_size</code> - Determines the length and width of the area. It can be calculated with:<blockquote><code>(area_size / tile_size * world_scale) * 20</code></blockquote><code>tile_size</code> and <code>world_scale</code> are in the header.

=== Extra Information Array ===
if <code>ref_extra</code> does not equal <code>0</code> there is an <code>extra_info_array</code> attached to this area. The array is 4 or 8 values long.

Every area includes a [[HGHT|.hght]] and [[MATE|.mate]] file. The <code>extra_info_array</code> indicates if there is an additional [[Water.extm|.water.extm]] and / or [[Grass.extm|.grass.extm]] file

==== Header ====
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|extra_info_array length. Number of values (not elements) in array.
|-
|<code>(0x04)</code>
|4
|Unsigned Int
|Unknown. Always 20, but only present when extra_info_array length is 8.
|}

==== Extra Information Array Value Table ====
After the Header, there is either 1 (extra_info_array length 4) or 2 (extra_info_array length 8) elements of this structure.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|0x00
|4
|Unsigned Int
|Unknown. Always 3.
|-
|0x04
|4
|Unsigned Int
|Unknown. 0 or 1.
|-
|0x08
|4
|Unsigned Int
|Unknown. Always 1.
|-
|0x0c
|4
|Unsigned Int
|Unknown. Always 0.
|}
[3, 0, 1, 0, 3, 1, 1, 0] = grass, water
[3, 1, 1, 0, 3, 0, 1, 0] = water, grass
[3, 1, 1, 0] = water
[3, 0, 1, 0] = grass
It seems that water is <code>[3, 1, 1]</code> and grass is <code>[3, 0, 1]</code>

== <code>stera</code> File Positions ==
[[File:Stera_File_Positions.png|alt=stera File Positions|thumb|<code>stera</code> File Positions]]
<code>stera</code> files referenced in the area array are positioned using a [[wikipedia:Z-order_curve|z-order curve]] or the [[wikipedia:Moser–de_Bruijn_sequence|Moser-de Bruijn sequence]].
<references />
[[Category:File formats]]
[[Category:File extensions]]
[[Category:File extensions (STERA)]]

TSCB

2020-05-21T13:58:41Z

THplusplus: Clarified the exact meaning of the offsets in the lookup tables.

<onlyinclude>
'''T'''errain '''sc'''ene '''b'''inary (TSCB) files describe terrain areas layout and terrain materials.
</onlyinclude>

== TSCB File Specification ==

=== Header ===
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|String
|TSCB file signature (magic) <code>54 53 43 42</code> or "TSCB"
|-
|<code>0x04</code>
|4
|Unsigned Int
|TSCB version? <code>0A 00 00 00</code> or "10.0.0.0"<ref>U-King.elf:0x024D2F8C-0x024D300A holds two error messages: "【データロード】メジャーバージョンの不一致" ("[Data load] Major version mismatch") and "【データロード】マイナーバージョンの不一致" ("[Data Load] Minor version mismatch")</ref><ref>Game crashes on load screen if not equal to <code>0A 00 00 00</code></ref>
|-
|<code>0x08</code>
|4
|Unsigned Int
|Unknown. Always <code>00 00 00 01</code>. Game crashes on load screen if not equal to <code>00 00 00 01</code>.
|-
|<code>0x0c</code>
|4
|Unsigned Int
|<code>file_base</code> table relative offset
|-
|<code>0x10</code>
|4
|Float
|<code>world_scale</code> <code>500.0</code>. Scales the terrain along the x- and z-axis.
|-
|<code>0x14</code>
|4
|Float
|Terrain mesh max height <code>800.0</code>. Used to calculate the actual vertex height with [[HGHT|hght]] data.
|-
|<code>0x18</code>
|4
|Unsigned Int
|<code>material_info_array</code> length (number of elements in the array)
|-
|<code>0x1c</code>
|4
|Unsigned Int
|<code>area_array</code> length (number of elements in the array)
|-
|<code>0x20</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x24</code>
|4
|Unsigned Int
|Probably padding
|-
|<code>0x28</code>
|4
|Float
|<code>tile_size</code>. Used by the area array.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|Unknown <code>00 00 00 08</code>. <ref>Values <code>1</code>, <code>2</code>, <code>4</code>, <code>5</code>, <code>6</code>, <code>8</code>, <code>9</code>, <code>10</code>, <code>13</code>, <code>14</code> affects textures. <code>0</code>, <code>3</code>, <code>7</code>, <code>11</code>, <code>12</code>, <code>15</code>, <code>16</code> will crash the game.</ref>
|}

== Material Information Array ==
The material information array references texture data contained in <code>content/Model/Terrain.Tex1.sbfres</code>.

=== Header ===
The material information header is one value, the section size. This includes the index table and the value table.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Material info section size in bytes
|}

=== Material Information Array Lookup Table ===
Following the header is a table of relative offsets to each entry in <code>material_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

=== Material Information Value Table ===
Each entry in the array contains an index and four attributes
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Array index (<code>mat_index</code>) of <code>material_info_array</code>
|-
|<code>0x04</code>
|4
|Float
|Texture u-axis (x-axis)
|-
|<code>0x08</code>
|4
|Float
|Texture v-axis (y-axis)
|-
|<code>0x0c</code>
|4
|Float
|Unknown. values range from 0-1.
|-
|<code>0x10</code>
|4
|Float
|Unknown. values range from 0.2-1.63
|}

== Area Array ==

=== Area Array Lookup Table ===
Following the material information section is a table of relative offsets to each entry in area_array
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Unsigned Int
|Offset to array entry, relative to the first byte of this offset
|}

=== Area Array Value Table ===
Each entry contains meta data for one tile in the terrain scene. There are multiple levels of detail (lod) for the terrain.

Entries range from <code>0x30</code> to <code>0x54</code> depending on the size of <code>extra_info_array</code>
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x00</code>
|4
|Float
|X Position
|-
|<code>0x04</code>
|4
|Float
|Z Position
|-
|<code>0x08</code>
|4
|Float
|<code>area_size</code> (length and width)
|-
|<code>0x0c</code>
|4
|Float
|Unknown - Affects grass density.<ref>0 may be default. Higher numbers have increased density.</ref>
|-
|<code>0x10</code>
|4
|Float
|Unknown
|-
|<code>0x14</code>
|4
|Float
|Unknown
|-
|<code>0x18</code>
|4
|Float
|Unknown
|-
|<code>0x1c</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>, <code>1</code> or <code>2</code>, crashes on <code>4</code>, <code>16</code>.<ref>May be a flag for grass and water? <code>0</code> seems to indicate no water or grass.</ref>
|-
|<code>0x20</code>
|4
|Unsigned Int
|<code>file_base</code>. Relative offset to file base name string.
|-
|<code>0x24</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x28</code>
|4
|Unsigned Int
|Unknown. Usually <code>0</code>.
|-
|<code>0x2c</code>
|4
|Unsigned Int
|<code>ref_extra</code>. It seems to be a flag to indicate if there is an attached <code>extra_info_array</code>
|}

==== Parameters ====
<code>x</code> - Area tile x coordinate (East-West)

<code>z</code> - Area tile z coordinate (North-South)
<code>area_size</code> - Determines the length and width of the area. It can be calculated with:<blockquote><code>(area_size / tile_size * world_scale) * 20</code></blockquote><code>tile_size</code> and <code>world_scale</code> are in the header.

=== Extra Information Array ===
if <code>ref_extra</code> does not equal <code>0</code> there is an <code>extra_info_array</code> attached to this area. The array is 4 or 8 values long.

Every area includes a [[HGHT|.hght]] and [[MATE|.mate]] file. The <code>extra_info_array</code> indicates if there is an additional [[Water.extm|.water.extm]] and / or [[Grass.extm|.grass.extm]] file
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|<code>0x30</code>
|4
|Unsigned Int
|extra_info_array length. Number of elements in array.
|-
|<code>0x34</code>
|4
|Unsigned Int
|Unknown. Usually 20 or 3.
|-
|<code>0x38</code>
|4
|Unsigned Int
|Unknown. Usually 0, 1 or 3.
|-
|<code>0x3c</code>
|4
|Unsigned Int
|Unknown. Usually 0 or 1.
|-
|<code>0x40</code>
|4
|Unsigned Int
|Unknown. Usually 0 or 1.
|-
|<code>0x44</code>
|4
|Unsigned Int
|Unknown. Always 0.
|-
|<code>0x48</code>
|4
|Unsigned Int
|Unknown. Always 3
|-
|<code>0x4c</code>
|4
|Unsigned Int
|Unknown. Usually 0 or 1.
|-
|<code>0x50</code>
|4
|Unsigned Int
|Unknown. Always 1.
|}
[20, 3, 0, 1, 0, 3, 1, 1] = water, grass
[20, 3, 1, 1, 0, 3, 0, 1] = water, grass
[ 3, 1, 1, 0] = water
[ 3, 0, 1, 0] = grass
It seems that water is <code>[3, 1, 1]</code> and grass is <code>[3, 0, 1]</code>
[20, `3, 0, 1`, 0, `3, 1, 1`] = grass, water
[20, `3, 1, 1`, 0, `3, 0, 1`] = water, grass
[`3, 1, 1`, 0] = water
[`3, 0, 1`, 0] = grass

== <code>stera</code> File Positions ==
[[File:Stera_File_Positions.png|alt=stera File Positions|thumb|<code>stera</code> File Positions]]
<code>stera</code> files referenced in the area array are positioned using a [[wikipedia:Z-order_curve|z-order curve]] or the [[wikipedia:Moser–de_Bruijn_sequence|Moser-de Bruijn sequence]].
<references />
[[Category:File formats]]
[[Category:File extensions]]
[[Category:File extensions (STERA)]]