Environment Track Data: Difference between revisions

m
no edit summary
(Created page with "The '''Environment Slice''' is a container format used to store environment lighting/weather values and skybox textures. It uses the filename <code>ENVIRO.DAT</code>. = Layou...")
 
mNo edit summary
 
(35 intermediate revisions by 3 users not shown)
Line 1:
''Not to be confused with [[Burnout Game Data (Takedown-Dominator)#Environment Slice|Environment Slice]], a subtype of [[Burnout Game Data (Takedown-Dominator)|Burnout Game Data]].''
The '''Environment Slice''' is a container format used to store environment lighting/weather values and skybox textures. It uses the filename <code>ENVIRO.DAT</code>.
 
{{todo|<small>Document version 0x04.</small>}}
= Layout =
=== PSP (Revision 1) ===
<!-- TODO: Document Dom PSP aka revision 2's enviro layout -->
Note that this layout applies specifically to Burnout Legends. Burnout Dominator<sup>(PSP)</sup> uses a slightly updated revision of this format, and as such its layout is similar but not identical to this one.
 
The '''Environment Data''' format is used to store lighting/weather values and skybox textures for a given track environment. It uses the filename <code>ENVIRO.DAT</code>.
 
= Versions =
{| class="wikitable"
! rowspan="2" |
! colspan="3" | Version
|-
! 0x02 || 0x03 || 0x04
|-
| Date || Jul 2004 || Jun 2005 || Jan 2007
|-
| Games || Takedown<br>Revenge<br>Dominator<sup>(PS2)</sup> || Legends || Dominator<sup>(PSP)</sup>
|}
 
= Layout (Version 0x02) =
{|class="wikitable"
|-
! Offset
! LengthName
! Type
! Value
! Description
! DetailsNotes
|-
| 0x00 || Minimum environment info || Environment Info || ||
|-
| 0x30 || Maximum environment info || Environment Info || ||
| <tt>0x00 || <tt>0x98 || Floating points/integers || Unused data ||
|-
| 0x60 || Specular color || [[Common Data Types#GtRGB|GtRGB]] || ||
| <tt>0x98 || <tt>0x14 || Unsigned integer (32) || Texture pointer table ||
|-
| 0x70 || Sun color || GtRGB || ||
! colspan="5" | Fog settings
|-
| 0x80 || Sun position || [[Common Data Types#GtV3d|GtV3d]] || ||
| <tt>0xB0 || <tt>0x01 || Unsigned integer (8) || Enable/disable fog || 0 = disabled, 1 = enabled
|-
| 0x90 || Sun corona radius || float || ||
| <tt>0xB4 || <tt>0x04 || Floating-point number || Fog start distance ||
|-
| <tt>0xB80x94 || <tt>0x04Is sun moon? || Floating-point numberbool || Fog end distance ||
|-
| <tt>0xC00x98 || <tt>0x04Gradient texture || Floating-point numberGtTexture* || Fog hue (red) ||
|-
| <tt>0xC40x9C || <tt>0x04Cloud texture || Floating-point numberGtTexture* || Fog hue (green) ||
|-
| 0xA0 || Cloud environment map texture || GtTexture* || ||
| <tt>0xC8 || <tt>0x04 || Floating-point number || Fog hue (blue) ||
|-
| 0xA4 || Sun/moon texture || GtTexture* || ||
! colspan="5" | Lighting settings
|-
| <tt>0xD00xA8 || <tt>0x04Version number || Floating-point numberuint || Light vector X-position0x02 ||
|-
| 0xAC || File size (bytes) || uint || || Is unused in Revenge/Dominator.
| <tt>0xD4 || <tt>0x04 || Floating-point number || Light vector Y-position ||
|}
 
==== Environment Info ====
{|class="wikitable"
|-
! Offset
| <tt>0xD8 || <tt>0x04 || Floating-point number || Light vector Z-position ||
! Name
! Type
! Value
! Notes
|-
| 0x00 || Fog color || GtRGB || ||
| <tt>0xE0 || <tt>0x04 || Floating-point number || Ambient lighting hue (red) ||
|-
| 0x10 || Fog distance || float || ||
| <tt>0xE4 || <tt>0x04 || Floating-point number || Ambient lighting hue (green) ||
|-
| 0x14 || World fog intensity || float || ||
| <tt>0xE8 || <tt>0x04 || Floating-point number || Ambient lighting hue (blue) ||
|-
| 0x18 || Sky fog intensity || float || ||
| <tt>0xF0 || <tt>0x04 || Floating-point number || Diffuse lighting hue (red) ||
|-
| 0x1C || Specular lighting intensity || float || ||
| <tt>0xF4 || <tt>0x04 || Floating-point number || Diffuse lighting hue (green) ||
|-
| 0x20 || Sun corona intensity || float || ||
| <tt>0xF8 || <tt>0x04 || Floating-point number || Diffuse lighting hue (blue) ||
|-
| 0x24 || Precipitation || float || ||
| <tt>0x100 || <tt>0x04 || Floating-point number || Specular lighting hue (red) ||
|-
| 0x28 || Star intensity || float || ||
| <tt>0x104 || <tt>0x04 || Floating-point number || Specular lighting hue (green) ||
|-
| 0x2C || Overall brightness || float || ||
| <tt>0x108 || <tt>0x04 || Floating-point number || Specular lighting hue (blue) ||
|-
|}
| <tt>0x110 || <tt>0x04 || Floating-point number || Ambient lighting hue (red, tunnel) || All values from here to 0x138 (as well as 0x144's value) are only applied to the vehicle when it has entered a tunnel or overpass.
 
= Layout (Version 0x03) =
{|class="wikitable"
|-
! Offset
| <tt>0x114 || <tt>0x04 || Floating-point number || Ambient lighting hue (green, tunnel) ||
! Name
! Type
! Value
! Notes
|-
| 0x00 || Unused data || float<br>int || ||
| <tt>0x118 || <tt>0x04 || Floating-point number || Ambient lighting hue (blue, tunnel) ||
|-
| 0x98 || Texture offsets || GtTexture*[6] || ||
| <tt>0x120 || <tt>0x04 || Floating-point number || Diffuse lighting hue (red, tunnel) ||
|-
| 0xB0 || Draw fog || bool || ||
| <tt>0x124 || <tt>0x04 || Floating-point number || Diffuse lighting hue (green, tunnel) ||
|-
| 0xB4 || Fog start distance || float || ||
| <tt>0x128 || <tt>0x04 || Floating-point number || Diffuse lighting hue (blue, tunnel) ||
|-
| 0xB8 || Fog end distance || float || ||
| <tt>0x130 || <tt>0x04 || Floating-point number || Specular lighting hue (red, tunnel) ||
|-
| 0xC0 || Fog color || GtRGB || ||
| <tt>0x134 || <tt>0x04 || Floating-point number || Specular lighting hue (green, tunnel) ||
|-
| 0xD0 || Light position || GtV3d || ||
| <tt>0x138 || <tt>0x04 || Floating-point number || Specular lighting hue (blue, tunnel) ||
|-
| 0xE0 || Ambient lighting color || GtRGB || ||
| <tt>0x140 || <tt>0x04 || Floating-point number || Specular lighting coefficient ||
|-
| 0xF0 || Diffuse lighting color || GtRGB || ||
| <tt>0x144 || <tt>0x04 || Floating-point number || Specular lighting coefficient (tunnel) ||
|-
| 0x100 || Specular lighting color || GtRGB || ||
! colspan="5" | Bloom settings
|-
| 0x110 || Ambient lighting color (tunnel) || GtRGB || || All values from here to 0x138</tt> (as well as 0x144</tt>'s value) are<br> only applied to the vehicle when it has entered a tunnel or overpass.
| <tt>0x148 || <tt>0x01 || Unsigned integer (8) || Enable/disable bloom ||
|-
| <tt>0x1500x120 || <tt>0x04Diffuse ||lighting Unsigned integercolor (32tunnel) || BloomGtRGB additive amount|| ||
|-
| <tt>0x1540x130 || <tt>0x04Specular ||lighting Unsigned integercolor (32tunnel) || BloomGtRGB blur factor|| ||
|-
| 0x140 || Specular lighting coefficient || float || || Intensity of the specular lighting applied to the vehicle.
! colspan="5" | Sun settings
|-
| <tt>0x1580x144 || <tt>0x04Specular ||lighting Unsigned integercoefficient (8tunnel) || Enable/disablefloat sun|| ||
|-
| <tt>0x15C0x148 || <tt>0x04Draw bloom || Unsigned integer (32)bool || Sun size0x01 ||
|-
| <tt>0x1600x14C || <tt>0x04Bloom intensity || Floating-point numberint || Sun X-scale ||
|-
| <tt>0x1600x150 || <tt>0x04Bloom additive amount || Floating-point numberint32 || Sun Y-scale ||
|-
| 0x154 || Bloom blur factor || float || ||
| <tt>0x164 || <tt>0x04 || Unsigned integer (32) || Number of sun copies ||
|-
| <tt>0x1700x158 || <tt>0x04 Draw sun || Floating-point numberbool || Sun color (red)0x01 ||
|-
| <tt>0x1740x15C || <tt>0x04 Sun size || Floating-point numberint32 || Sun color (green) ||
|-
| <tt>0x1780x160 || <tt>0x04 ||Sun FloatingX-point numberscale || Sunfloat color (blue)|| ||
|-
| <tt>0x1800x164 || <tt>0x04 ||Sun FloatingY-point numberscale || Sunfloat core color (red)|| ||
|-
| <tt>0x1840x168 || <tt>0x04Number ||of Floating-pointsun numbercopies || Sunint core color (green)|| ||
|-
| <tt>0x1880x170 || <tt>0x04Sun color || Floating-point numberGtRGB || Sun core color (blue) ||
|-
| <tt>0x1900x180 || <tt>0x04Sun core color || Floating-point numberGtRGB || Sun X Vector ||
|-
| <tt>0x1940x190 || <tt>0x04Sun position || Floating-point numberGtV3d || Sun Y Vector ||
|-
| <tt>0x1980x1A0 || <tt>0x04Draw sun corona || Floating-point numberbool || Sun Z Vector0x01 ||
|-
| 0x1A4 || Sun corona X-size || float || ||
| <tt>0x1A0 || <tt>0x01 || Unsigned integer (8) || Enable/disable sun corona ||
|-
| <tt>0x1A40x1A8 || <tt>0x04Sun ||corona FloatingY-point numbersize || Sunfloat corona X size|| ||
|-
| 0x1B0 || Sun corona color || GtRGB || ||
| <tt>0x1A8 || <tt>0x04 || Floating-point number || Sun corona Y size ||
|-
| 0x1C0 || Enable/disable sun blur occlusion || bool || ||
| <tt>0x1B0 || <tt>0x04 || Floating-point number || Sun corona color (red) ||
|-
| 0x1C4 || Sun blur offset || float || ||
| <tt>0x1B4 || <tt>0x04 || Floating-point number || Sun corona color (green) ||
|-
| <tt>0x1B80x1C8 || <tt>0x04Version number || Floating-point numberuint || Sun corona color (blue)0x03 ||
|-
| 0x1CC || File size (bytes) || uint || ||
| <tt>0x1C0 || <tt>0x01 || Unsigned integer (8) || Enable/disable sun blur occlusion ||
|-
| <tt>0x1C4 || <tt>0x04 || Floating-point number || Sun blur offset ||
|}
 
 
[[Category:Formats_(Takedown-Dominator)]]