Environment Track Data: Difference between revisions

From Burnout Wiki
Content added Content deleted
VisualWikitext
mNo edit summary
 
(18 intermediate revisions by 2 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 =
=== PS2 (WIP) ===


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 || ||
|-
|-
| <tt>0x00 || <tt>0x04 || Float32 || Fog hue (red) ||
| 0x30 || Maximum environment info || Environment Info || ||
|-
|-
| <tt>0x04 || <tt>0x04 || Float32 || Fog hue (green) ||
| 0x60 || Specular color || [[Common Data Types#GtRGB|GtRGB]] || ||
|-
|-
| <tt>0x08 || <tt>0x04 || Float32 || Fog hue (blue) ||
| 0x70 || Sun color || GtRGB || ||
|-
|-
| <tt>0x10 || <tt>0x04 || Float32 || Fog start distance ||
| 0x80 || Sun position || [[Common Data Types#GtV3d|GtV3d]] || ||
|-
|-
| <tt>0x14 || <tt>0x04 || Float32 || Fog intensity ||
| 0x90 || Sun corona radius || float || ||
|-
|-
| <tt>0x1C || <tt>0x04 || Float32 || Specular lighting intensity ||
| 0x94 || Is sun moon? || bool || ||
|-
|-
| <tt>0x60 || <tt>0x04 || Float32 || Specular lighting hue (red) ||
| 0x98 || Gradient texture || GtTexture* || ||
|-
|-
| <tt>0x64 || <tt>0x04 || Float32 || Specular lighting hue (green) ||
| 0x9C || Cloud texture || GtTexture* || ||
|-
|-
| 0xA0 || Cloud environment map texture || GtTexture* || ||
| <tt>0x68 || <tt>0x04 || Float32 || Specular lighting hue (blue) ||
|-
|-
| <tt>0x70 || <tt>0x04 || Float32 || Sun corona hue (red) ||
| 0xA4 || Sun/moon texture || GtTexture* || ||
|-
|-
| <tt>0x74 || <tt>0x04 || Float32 || Sun corona hue (green) ||
| 0xA8 || Version number || uint || 0x02 ||
|-
|-
| <tt>0x78 || <tt>0x04 || Float32 || Sun corona hue (blue) ||
| 0xAC || File size (bytes) || uint || || Is unused in Revenge/Dominator.
|-
| <tt>0x80 || <tt>0x04 || Float32 || Sun X Position ||
|-
| <tt>0x84 || <tt>0x04 || Float32 || Sun Y Position ||
|-
| <tt>0x88 || <tt>0x04 || Float32 || Sun Z Position ||
|-
| <tt>0x90 || <tt>0x04 || Float32 || Sun brightness ||
|-
| <tt>0x9C || <tt>0x12 || CGtTexture*[3] || Texture offsets ||
|}
|}


=== PSP (Revision 1) ===
==== Environment Info ====
<!-- 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.

{|class="wikitable"
{|class="wikitable"
|-
|-
! Offset
! Offset
! Length
! Name
! Type
! Type
! Value
! Description
! Details
! Notes
|-
|-
| <tt>0x00 || <tt>0x98 || Float32/UInt32 || Unused data ||
| 0x00 || Fog color || GtRGB || ||
|-
|-
| 0x10 || Fog distance || float || ||
| <tt>0x98 || <tt>0x14 || [[Texture_(PSP)|Texture]]*[5] || Texture offsets ||
|-
|-
| 0x14 || World fog intensity || float || ||
! colspan="5" | Fog settings
|-
|-
| 0x18 || Sky fog intensity || float || ||
| <tt>0xB0 || <tt>0x01 || UInt8 || Enable/disable fog || <tt>0x00</tt> = disabled; <tt>0x01</tt> = enabled. This applies for all other boolean values in the header.
|-
|-
| <tt>0xB4 || <tt>0x04 || Float32 || Fog start distance ||
| 0x1C || Specular lighting intensity || float || ||
|-
|-
| <tt>0xB8 || <tt>0x04 || Float32 || Fog end distance ||
| 0x20 || Sun corona intensity || float || ||
|-
|-
| <tt>0xC0 || <tt>0x04 || Float32 || Fog hue (red) ||
| 0x24 || Precipitation || float || ||
|-
|-
| <tt>0xC4 || <tt>0x04 || Float32 || Fog hue (green) ||
| 0x28 || Star intensity || float || ||
|-
|-
| <tt>0xC8 || <tt>0x04 || Float32 || Fog hue (blue) ||
| 0x2C || Overall brightness || float || ||
|-
|-
|}
! colspan="5" | Lighting settings

= Layout (Version 0x03) =
{|class="wikitable"
|-
|-
! Offset
| <tt>0xD0 || <tt>0x04 || Float32 || Light vector X-position ||
! Name
! Type
! Value
! Notes
|-
|-
| <tt>0xD4 || <tt>0x04 || Float32 || Light vector Y-position ||
| 0x00 || Unused data || float<br>int || ||
|-
|-
| <tt>0xD8 || <tt>0x04 || Float32 || Light vector Z-position ||
| 0x98 || Texture offsets || GtTexture*[6] || ||
|-
|-
| <tt>0xE0 || <tt>0x04 || Float32 || Ambient lighting hue (red) ||
| 0xB0 || Draw fog || bool || ||
|-
|-
| <tt>0xE4 || <tt>0x04 || Float32 || Ambient lighting hue (green) ||
| 0xB4 || Fog start distance || float || ||
|-
|-
| <tt>0xE8 || <tt>0x04 || Float32 || Ambient lighting hue (blue) ||
| 0xB8 || Fog end distance || float || ||
|-
|-
| <tt>0xF0 || <tt>0x04 || Float32 || Diffuse lighting hue (red) ||
| 0xC0 || Fog color || GtRGB || ||
|-
|-
| <tt>0xF4 || <tt>0x04 || Float32 || Diffuse lighting hue (green) ||
| 0xD0 || Light position || GtV3d || ||
|-
|-
| 0xE0 || Ambient lighting color || GtRGB || ||
| <tt>0xF8 || <tt>0x04 || Float32 || Diffuse lighting hue (blue) ||
|-
|-
| 0xF0 || Diffuse lighting color || GtRGB || ||
| <tt>0x100 || <tt>0x04 || Float32 || Specular lighting hue (red) ||
|-
|-
| 0x100 || Specular lighting color || GtRGB || ||
| <tt>0x104 || <tt>0x04 || Float32 || Specular lighting hue (green) ||
|-
|-
| 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>0x108 || <tt>0x04 || Float32 || Specular lighting hue (blue) ||
|-
|-
| 0x120 || Diffuse lighting color (tunnel) || GtRGB || ||
| <tt>0x110 || <tt>0x04 || Float32 || 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.
|-
|-
| 0x130 || Specular lighting color (tunnel) || GtRGB || ||
| <tt>0x114 || <tt>0x04 || Float32 || Ambient lighting hue (green, tunnel) ||
|-
|-
| <tt>0x118 || <tt>0x04 || Float32 || Ambient lighting hue (blue, tunnel) ||
| 0x140 || Specular lighting coefficient || float || || Intensity of the specular lighting applied to the vehicle.
|-
|-
| 0x144 || Specular lighting coefficient (tunnel) || float || ||
| <tt>0x120 || <tt>0x04 || Float32 || Diffuse lighting hue (red, tunnel) ||
|-
|-
| <tt>0x124 || <tt>0x04 || Float32 || Diffuse lighting hue (green, tunnel) ||
| 0x148 || Draw bloom || bool || 0x01 ||
|-
|-
| 0x14C || Bloom intensity || int || ||
| <tt>0x128 || <tt>0x04 || Float32 || Diffuse lighting hue (blue, tunnel) ||
|-
|-
| 0x150 || Bloom additive amount || int32 || ||
| <tt>0x130 || <tt>0x04 || Float32 || Specular lighting hue (red, tunnel) ||
|-
|-
| 0x154 || Bloom blur factor || float || ||
| <tt>0x134 || <tt>0x04 || Float32 || Specular lighting hue (green, tunnel) ||
|-
|-
| <tt>0x138 || <tt>0x04 || Float32 || Specular lighting hue (blue, tunnel) ||
| 0x158 || Draw sun || bool || 0x01 ||
|-
|-
| 0x15C || Sun size || int32 || ||
| <tt>0x140 || <tt>0x04 || Float32 || Specular lighting coefficient || Intensity of the specular lighting applied to the car.
|-
|-
| 0x160 || Sun X-scale || float || ||
| <tt>0x144 || <tt>0x04 || Float32 || Specular lighting coefficient (tunnel) ||
|-
|-
| 0x164 || Sun Y-scale || float || ||
! colspan="5" | Bloom settings
|-
|-
| <tt>0x148 || <tt>0x01 || UInt8 || Enable/disable bloom ||
| 0x168 || Number of sun copies || int || ||
|-
|-
| <tt>0x150 || <tt>0x04 || UInt32 || Bloom additive amount ||
| 0x170 || Sun color || GtRGB || ||
|-
|-
| <tt>0x154 || <tt>0x04 || Float || Bloom blur factor ||
| 0x180 || Sun core color || GtRGB || ||
|-
|-
| 0x190 || Sun position || GtV3d || ||
! colspan="5" | Sun settings
|-
|-
| <tt>0x158 || <tt>0x04 || UInt8 || Enable/disable sun ||
| 0x1A0 || Draw sun corona || bool || 0x01 ||
|-
|-
| <tt>0x15C || <tt>0x04 || UInt32 || Sun size ||
| 0x1A4 || Sun corona X-size || float || ||
|-
|-
| <tt>0x160 || <tt>0x04 || Float32 || Sun X-scale ||
| 0x1A8 || Sun corona Y-size || float || ||
|-
|-
| <tt>0x160 || <tt>0x04 || Float32 || Sun Y-scale ||
| 0x1B0 || Sun corona color || GtRGB || ||
|-
|-
| 0x1C0 || Enable/disable sun blur occlusion || bool || ||
| <tt>0x168 || <tt>0x04 || UInt32 || Number of sun copies ||
|-
|-
| <tt>0x170 || <tt>0x04 || Float32 || Sun hue (red) ||
| 0x1C4 || Sun blur offset || float || ||
|-
|-
| <tt>0x174 || <tt>0x04 || Float32 || Sun hue (green) ||
| 0x1C8 || Version number || uint || 0x03 ||
|-
|-
| <tt>0x178 || <tt>0x04 || Float32 || Sun hue (blue) ||
| 0x1CC || File size (bytes) || uint || ||
|-
| <tt>0x180 || <tt>0x04 || Float32 || Sun core hue (red) ||
|-
| <tt>0x184 || <tt>0x04 || Float32 || Sun core hue (green) ||
|-
| <tt>0x188 || <tt>0x04 || Float32 || Sun core hue (blue) ||
|-
| <tt>0x190 || <tt>0x04 || Float32 || Sun X Vector ||
|-
| <tt>0x194 || <tt>0x04 || Float32 || Sun Y Vector ||
|-
| <tt>0x198 || <tt>0x04 || Float32 || Sun Z Vector ||
|-
| <tt>0x1A0 || <tt>0x01 || UInt8 || Enable/disable sun corona ||
|-
| <tt>0x1A4 || <tt>0x04 || Float32 || Sun corona X-size ||
|-
| <tt>0x1A8 || <tt>0x04 || Float32 || Sun corona Y-size ||
|-
| <tt>0x1B0 || <tt>0x04 || Float32 || Sun corona hue (red) ||
|-
| <tt>0x1B4 || <tt>0x04 || Float32 || Sun corona hue (green) ||
|-
| <tt>0x1B8 || <tt>0x04 || Float32 || Sun corona hue (blue) ||
|-
| <tt>0x1C0 || <tt>0x01 || UInt8 || Enable/disable sun blur occlusion ||
|-
| <tt>0x1C4 || <tt>0x04 || Float32 || 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"