ZeldaMods (Breath of the Wild)

TSCB: Difference between revisions

Page Discussion

TSCB (view source)

Revision as of 21:49, 10 January 2022

921 bytes added ,  2 years ago
m
Specify what extra_info_array is for.
VisualWikitext
imported>Zephenryus
m (Specify what extra_info_array is for.)
 
(6 intermediate revisions by 3 users not shown)
Line 3: Line 3:
</onlyinclude>
</onlyinclude>


== TSCB File Specification ==
==TSCB File Specification==


=== Header ===
===Header===
{| class="wikitable"
{| class="wikitable"
!Offset (h)
!Offset (h)
Line 73: Line 73:
|}
|}


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


=== Header ===
===Header===
The material information header is one value, the section size. This includes the index table and the value table.
The material information header is one value, the section size. This includes the index table and the value table, as well as itself.
{| class="wikitable"
{| class="wikitable"
!Offset (h)
!Offset (h)
Line 90: Line 90:
|}
|}


=== Material Information Array Lookup Table ===
===Material Information Array Lookup Table===
Following the header is a table of relative offsets to each entry in <code>material_info_array</code>
Following the header is a table of relative offsets to each entry in <code>material_info_array</code>
{| class="wikitable"
{| class="wikitable"
Line 101: Line 101:
|4
|4
|Unsigned Int
|Unsigned Int
|Relative offset to array entry
|Offset to array entry, relative to the first byte of this offset
|}
|}


=== Material Information Value Table ===
===Material Information Value Table===
Each entry in the array contains an index and four attributes
Each entry in the array contains an index and four attributes
{| class="wikitable"
{| class="wikitable"
Line 138: Line 138:
|}
|}


== Area Array ==
==Area Array==


=== Area Array Lookup Table ===
===Area Array Lookup Table===
Following the material information section is a table of relative offsets to each entry in area_array
Following the material information section is a table of relative offsets to each entry in area_array
{| class="wikitable"
{| class="wikitable"
Line 151: Line 151:
|4
|4
|Unsigned Int
|Unsigned Int
|Relative offset to array entry
|Offset to array entry, relative to the first byte of this offset
|}
|}


=== Area Array Value Table ===
===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.
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>
Entry size ranges from <code>0x30</code> to <code>0x58</code> depending on the size of <code>extra_info_array</code>
{| class="wikitable"
{| class="wikitable"
!Offset (h)
!Offset (h)
Line 182: Line 182:
|4
|4
|Float
|Float
|Unknown - Affects grass density.<ref>0 may be default. Higher numbers have increased density.</ref>
|Minimum Terrain Height - ranges from 0 to 1
|-
|-
|<code>0x10</code>
|<code>0x10</code>
|4
|4
|Float
|Float
|Unknown
|Maximum Terrain Height - ranges from 0 to 1
|-
|-
|<code>0x14</code>
|<code>0x14</code>
|4
|4
|Float
|Float
|Unknown
|Minimum Water Height - ranges from 0 to 1
|-
|-
|<code>0x18</code>
|<code>0x18</code>
|4
|4
|Float
|Float
|Unknown
|Maximum Water Height - ranges from 0 to 1
|-
|-
|<code>0x1c</code>
|<code>0x1c</code>
Line 225: Line 225:
|}
|}


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


Line 231: Line 231:
<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.
<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 ===
===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.
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
Every area includes a [[HGHT|.hght]] and [[MATE|.mate]] file. Entries in the <code>extra_info_array</code> indicate if there is an additional [[Water.extm|.water.extm]] and / or [[Grass.extm|.grass.extm]] file to look for.
 
===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"
{| class="wikitable"
!Offset (h)
!Offset (h)
Line 241: Line 246:
!Description
!Description
|-
|-
|<code>0x30</code>
|<code>0x00</code>
|4
|4
|Unsigned Int
|Unsigned Int
|extra_info_array length. Number of elements in array.
|extra_info_array length. Number of values (not elements) in array.
|-
|-
|<code>0x34</code>
|<code>(0x04)</code>
|4
|4
|Unsigned Int
|Unsigned Int
|Unknown. Usually 20 or 3.
|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.
Elements act as flags for presence of [[Water.extm|.water.extm]] or [[Grass.extm|.grass.extm]] files.
A "water" element indicates that there is water data for the terrain section defined in a [[Water.extm|.water.extm]] file. A "grass" element similarly indicates the presence of a [[Grass.extm|.grass.extm]] file.
Grass and water are referenced via the <code>extra_info_array</code> because presence water and grass data for any given terrain area is optional.
{| class="wikitable"
!Offset (h)
!Size
!Data Type
!Description
|-
|-
|<code>0x38</code>
|0x00
|4
|4
|Unsigned Int
|Unsigned Int
|Unknown. Usually 0, 1 or 3.
|Unknown. Always 3.
|-
|-
|<code>0x3c</code>
|0x04
|4
|4
|Unsigned Int
|Unsigned Int
|Unknown. Usually 0 or 1.
|Unknown. 0 or 1.
|-
|-
|<code>0x40</code>
|0x08
|4
|4
|Unsigned Int
|Unsigned Int
|Unknown. Usually 0 or 1.
|Unknown. Always 1.
|-
|-
|<code>0x44</code>
|0x0c
|4
|4
|Unsigned Int
|Unsigned Int
|Unknown. Always 0.
|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
  [3, 0, 1, 0, 3, 1, 1, 0] = grass, water
  [20, 3, 1, 1, 0, 3, 0, 1] = water, grass
  [3, 1, 1, 0, 3, 0, 1, 0] = water, grass
  [ 3, 1, 1, 0]            = water
  [3, 1, 1, 0]            = water
  [ 3, 0, 1, 0]            = grass
  [3, 0, 1, 0]            = grass
It seems that water is <code>[3, 1, 1]</code> and grass is <code>[3, 0, 1]</code>
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 ==
==<code>stera</code> File Positions==
[[File:Stera_File_Positions.png|alt=stera File Positions|thumb|<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]].
<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]].
Greenlord
7

edits

Retrieved from "https://zeldamods.org/wiki/Special:MobileDiff/1568...11071"