TSCB

2020-08-22T01:47:47Z

Arcaith: Updated some of the area array value table information.

<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
|Minimum Terrain Height - ranges from 0 to 1
|-
|<code>0x10</code>
|4
|Float
|Maximum Terrain Height - ranges from 0 to 1
|-
|<code>0x14</code>
|4
|Float
|Minimum Water Height - ranges from 0 to 1
|-
|<code>0x18</code>
|4
|Float
|Maximum Water Height - ranges from 0 to 1
|-
|<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

===Terrain and Water Height===
0x0c through 0x18 are used to determine what height range the terrain and water should render within. This is possibly used to assist with occlusion. If the heightmap moves outside of the range defined here, there will be visual artefacts present at higher viewing angles, usually between 45 and 90 degrees. The range value is multiplied by the max height defined in the TSCB header to determine the final value in 'real' co-ordinates.

====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)]]

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

TSCB