Environment Track Data: Difference between revisions

From Burnout Wiki
Content added Content deleted
VisualWikitext
mNo edit summary
mNo edit summary
 
(33 intermediate revisions by 3 users not shown)
Line 1: 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''' container format is used to store track 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"
{|class="wikitable"
|-
|-
! Offset
! Offset
! Length
! Name
! Type
! Type
! Value
! Description
! Details
! Notes
|-
| 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 || <tt>0x00</tt> = disabled; <tt>0x01</tt> = enabled. This applies for all other boolean values in the header.
|-
|-
| 0x90 || Sun corona radius || float || ||
| <tt>0xB4 || <tt>0x04 || Floating-point number || Fog start distance ||
|-
|-
| <tt>0xB8 || <tt>0x04 || Floating-point number || Fog end distance ||
| 0x94 || Is sun moon? || bool || ||
|-
|-
| <tt>0xC0 || <tt>0x04 || Floating-point number || Fog hue (red) ||
| 0x98 || Gradient texture || GtTexture* || ||
|-
|-
| <tt>0xC4 || <tt>0x04 || Floating-point number || Fog hue (green) ||
| 0x9C || Cloud texture || GtTexture* || ||
|-
|-
| 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>0xD0 || <tt>0x04 || Floating-point number || Light vector X-position ||
| 0xA8 || Version number || uint || 0x02 ||
|-
|-
| 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 <tt>0x138</tt> (as well as <tt>0x144</tt>'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 || Intensity of the specular lighting applied to the car.
|-
|-
| 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>0x150 || <tt>0x04 || Unsigned integer (32) || Bloom additive amount ||
| 0x120 || Diffuse lighting color (tunnel) || GtRGB || ||
|-
|-
| <tt>0x154 || <tt>0x04 || Unsigned integer (32) || Bloom blur factor ||
| 0x130 || Specular lighting color (tunnel) || GtRGB || ||
|-
|-
| 0x140 || Specular lighting coefficient || float || || Intensity of the specular lighting applied to the vehicle.
! colspan="5" | Sun settings
|-
|-
| <tt>0x158 || <tt>0x04 || Unsigned integer (8) || Enable/disable sun ||
| 0x144 || Specular lighting coefficient (tunnel) || float || ||
|-
|-
| <tt>0x15C || <tt>0x04 || Unsigned integer (32) || Sun size ||
| 0x148 || Draw bloom || bool || 0x01 ||
|-
|-
| <tt>0x160 || <tt>0x04 || Floating-point number || Sun X-scale ||
| 0x14C || Bloom intensity || int || ||
|-
|-
| <tt>0x160 || <tt>0x04 || Floating-point number || Sun Y-scale ||
| 0x150 || Bloom additive amount || int32 || ||
|-
|-
| 0x154 || Bloom blur factor || float || ||
| <tt>0x164 || <tt>0x04 || Unsigned integer (32) || Number of sun copies ||
|-
|-
| <tt>0x170 || <tt>0x04 || Floating-point number || Sun hue (red) ||
| 0x158 || Draw sun || bool || 0x01 ||
|-
|-
| <tt>0x174 || <tt>0x04 || Floating-point number || Sun hue (green) ||
| 0x15C || Sun size || int32 || ||
|-
|-
| <tt>0x178 || <tt>0x04 || Floating-point number || Sun hue (blue) ||
| 0x160 || Sun X-scale || float || ||
|-
|-
| <tt>0x180 || <tt>0x04 || Floating-point number || Sun core hue (red) ||
| 0x164 || Sun Y-scale || float || ||
|-
|-
| <tt>0x184 || <tt>0x04 || Floating-point number || Sun core hue (green) ||
| 0x168 || Number of sun copies || int || ||
|-
|-
| <tt>0x188 || <tt>0x04 || Floating-point number || Sun core hue (blue) ||
| 0x170 || Sun color || GtRGB || ||
|-
|-
| <tt>0x190 || <tt>0x04 || Floating-point number || Sun X Vector ||
| 0x180 || Sun core color || GtRGB || ||
|-
|-
| <tt>0x194 || <tt>0x04 || Floating-point number || Sun Y Vector ||
| 0x190 || Sun position || GtV3d || ||
|-
|-
| <tt>0x198 || <tt>0x04 || Floating-point number || Sun Z Vector ||
| 0x1A0 || Draw sun corona || bool || 0x01 ||
|-
|-
| 0x1A4 || Sun corona X-size || float || ||
| <tt>0x1A0 || <tt>0x01 || Unsigned integer (8) || Enable/disable sun corona ||
|-
|-
| <tt>0x1A4 || <tt>0x04 || Floating-point number || Sun corona X-size ||
| 0x1A8 || Sun corona Y-size || float || ||
|-
|-
| 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 hue (red) ||
|-
|-
| 0x1C4 || Sun blur offset || float || ||
| <tt>0x1B4 || <tt>0x04 || Floating-point number || Sun corona hue (green) ||
|-
|-
| <tt>0x1B8 || <tt>0x04 || Floating-point number || Sun corona hue (blue) ||
| 0x1C8 || Version number || uint || 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)]]

Latest revision as of 22:09, 5 February 2022

Not to be confused with Environment Slice, a subtype of Burnout Game Data.

Hmmm...
Hmmm...
To do:
Document version 0x04.

The Environment Data format is used to store lighting/weather values and skybox textures for a given track environment. It uses the filename ENVIRO.DAT.

Versions

Version
0x02 0x03 0x04
Date Jul 2004 Jun 2005 Jan 2007
Games Takedown
Revenge
Dominator(PS2)		 Legends Dominator(PSP)

Layout (Version 0x02)

Offset Name Type Value Notes
0x00 Minimum environment info Environment Info
0x30 Maximum environment info Environment Info
0x60 Specular color GtRGB
0x70 Sun color GtRGB
0x80 Sun position GtV3d
0x90 Sun corona radius float
0x94 Is sun moon? bool
0x98 Gradient texture GtTexture*
0x9C Cloud texture GtTexture*
0xA0 Cloud environment map texture GtTexture*
0xA4 Sun/moon texture GtTexture*
0xA8 Version number uint 0x02
0xAC File size (bytes) uint Is unused in Revenge/Dominator.

Environment Info

Offset Name Type Value Notes
0x00 Fog color GtRGB
0x10 Fog distance float
0x14 World fog intensity float
0x18 Sky fog intensity float
0x1C Specular lighting intensity float
0x20 Sun corona intensity float
0x24 Precipitation float
0x28 Star intensity float
0x2C Overall brightness float

Layout (Version 0x03)

Offset Name Type Value Notes
0x00 Unused data float
int
0x98 Texture offsets GtTexture*[6]
0xB0 Draw fog bool
0xB4 Fog start distance float
0xB8 Fog end distance float
0xC0 Fog color GtRGB
0xD0 Light position GtV3d
0xE0 Ambient lighting color GtRGB
0xF0 Diffuse lighting color GtRGB
0x100 Specular lighting color GtRGB
0x110 Ambient lighting color (tunnel) GtRGB 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.
0x120 Diffuse lighting color (tunnel) GtRGB
0x130 Specular lighting color (tunnel) GtRGB
0x140 Specular lighting coefficient float Intensity of the specular lighting applied to the vehicle.
0x144 Specular lighting coefficient (tunnel) float
0x148 Draw bloom bool 0x01
0x14C Bloom intensity int
0x150 Bloom additive amount int32
0x154 Bloom blur factor float
0x158 Draw sun bool 0x01
0x15C Sun size int32
0x160 Sun X-scale float
0x164 Sun Y-scale float
0x168 Number of sun copies int
0x170 Sun color GtRGB
0x180 Sun core color GtRGB
0x190 Sun position GtV3d
0x1A0 Draw sun corona bool 0x01
0x1A4 Sun corona X-size float
0x1A8 Sun corona Y-size float
0x1B0 Sun corona color GtRGB
0x1C0 Enable/disable sun blur occlusion bool
0x1C4 Sun blur offset float
0x1C8 Version number uint 0x03
0x1CC File size (bytes) uint
Retrieved from "https://burnout.wiki/wiki/Environment_Track_Data?oldid=6231"