TSCB - Revision history

Jycerian: Improve description of file_base mainly for the area array entry

2025-07-25T19:50:36Z

Improve description of file_base mainly for the area array entry

← Older revision		Revision as of 19:50, 25 July 2025
Line 30:		Line 30:
	\|4		\|4
	\|Unsigned Int		\|Unsigned Int
	\|<code>file_base</code> table ~~relative offset~~		\|<code>file_base</code> Offset to the basename (filename without extension) table
	\|-		\|-
	\|<code>0x10</code>		\|<code>0x10</code>
Line 207:		Line 207:
	\|4		\|4
	\|Unsigned Int		\|Unsigned Int
	\|<code>file_base</code>. ~~Relative offset~~ to ~~file base name~~ string.		\|<code>file_base</code>. Offset to the basename string relative to the current tile entry
	\|-		\|-
	\|<code>0x24</code>		\|<code>0x24</code>

Greenlord: Specify what extra_info_array is for.

2022-01-10T21:49:40Z

Specify what extra_info_array is for.

← Older revision		Revision as of 21:49, 10 January 2022
Line 234:		Line 234:
	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===		===Terrain and Water Height===
Line 259:		Line 259:
	====Extra Information Array Value Table====		====Extra Information Array Value Table====
	After the Header, there are <code>extra_info_array length / 4</code> elements of this structure.		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"		{\| class="wikitable"
	!Offset (h)		!Offset (h)

Greenlord: Material information header value should include itself

2021-10-18T21:09:12Z

Material information header value should include itself

← Older revision		Revision as of 21:09, 18 October 2021
Line 77:		Line 77:

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

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

2020-08-22T01:47:47Z

Updated some of the area array value table information.

← Older revision		Revision as of 01:47, 22 August 2020
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 235:		Line 235:

	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. 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====		====Header====

THplusplus: /* Extra Information Array Value Table */

2020-05-22T13:28:22Z

Extra Information Array Value Table

← Older revision		Revision as of 13:28, 22 May 2020
Line 255:		Line 255:

	====Extra Information Array Value Table====		====Extra Information Array Value Table====
	After the Header, there is <code>extra_info_array length</code> ~~/ 4~~ elements of this structure.		After the Header, there are <code>extra_info_array length / 4</code> elements of this structure.
	{\| class="wikitable"		{\| class="wikitable"
	!Offset (h)		!Offset (h)

THplusplus at 15:15, 21 May 2020

2020-05-21T15:15:29Z

← Older revision		Revision as of 15:15, 21 May 2020
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.
	{\| class="wikitable"		{\| class="wikitable"
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 104:		Line 104:
	\|}		\|}

	=== 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 154:		Line 154:
	\|}		\|}

	=== 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.

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. The <code>extra_info_array</code> indicates if there is an additional [[Water.extm\|.water.extm]] and / or [[Grass.extm\|.grass.extm]] file

	==== Header ====		====Header====
	{\| class="wikitable"		{\| class="wikitable"
	!Offset (h)		!Offset (h)
Line 246:		Line 246:
	\|4		\|4
	\|Unsigned Int		\|Unsigned Int
	\|extra_info_array length. Number of values (not elements) in array.		\|extra_info_array length. Number of values (not elements) in array.
	\|-		\|-
	\|<code>(0x04)</code>		\|<code>(0x04)</code>
Line 254:		Line 254:
	\|}		\|}

	==== Extra Information Array Value Table ====		====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.		After the Header, there is <code>extra_info_array length</code> / 4 elements of this structure.
	{\| class="wikitable"		{\| class="wikitable"
	!Offset (h)		!Offset (h)
Line 288:		Line 288:
	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>

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

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

2020-05-21T14:53:35Z

More in depth exploration of the Extra Information Array structure.

← Older revision		Revision as of 14:53, 21 May 2020
Line 157:		Line 157:
	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 235:		Line 235:

	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. 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"		{\| class="wikitable"
	!Offset (h)		!Offset (h)
Line 241:		Line 243:
	!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 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
	\|-		\|-
	\|~~<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 ==

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

2020-05-21T13:58:41Z

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

← Older revision		Revision as of 13:58, 21 May 2020
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
	\|}		\|}

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
	\|}		\|}

imported>Zephenryus: /* Material Information Array */

2019-01-16T01:09:02Z

Material Information Array

← Older revision		Revision as of 01:09, 16 January 2019
Line 74:		Line 74:

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

	=== Header ===		=== Header ===

imported>Zephenryus: /* Header */ Terrain mesh altitude value was found to be the max height value

2019-01-16T01:02:00Z

Header: Terrain mesh altitude value was found to be the max height value

← Older revision		Revision as of 01:02, 16 January 2019
Line 40:		Line 40:
	\|4		\|4
	\|Float		\|Float
	\|Terrain mesh ~~altitude~~ <code>800.0</code>. ~~Moves~~ the ~~terrain along the y-axis (vertically)~~.		\|Terrain mesh max height <code>800.0</code>. Used to calculate the actual vertex height with [[HGHT\|hght]] data.
	\|-		\|-
	\|<code>0x18</code>		\|<code>0x18</code>