Lights (Metroid Prime) - Revision history

Aruki: /* Metroid Prime 3 */

2019-03-27T04:30:29Z

‎Metroid Prime 3

Aruki: /* Custom */

2019-03-27T04:30:18Z

‎Custom

Aruki at 04:29, 27 March 2019

2019-03-27T04:29:53Z

Aruki at 15:07, 28 September 2015

2015-09-28T15:07:00Z

Aruki at 09:01, 28 September 2015

2015-09-28T09:01:51Z

Aruki at 21:02, 18 March 2015

2015-03-18T21:02:15Z

Aruki at 20:57, 18 March 2015

2015-03-18T20:57:25Z

Aruki: /* Light */

2015-03-10T23:05:51Z

‎Light

Aruki at 15:54, 9 March 2015

2015-03-09T15:54:30Z

Aruki: /* Light Types */ Removing some info that might not be accurate for now

2015-03-09T15:54:15Z

‎Light Types: Removing some info that might not be accurate for now

@@ Line 140: / Line 140: @@
 | 0x49
 | u32
-| Falloff Type
+| '''Falloff Type'''
+|
 |-

@@ Line 222: / Line 222: @@
 Each falloff type will set one distance attenuation coefficient, with the other two set to 0. For each type:
-* 0: '''Constant''': Coefficient A is set to <code>2.0 / Multiplier</code>
+* 0: '''Constant''': Coefficient A is set to <code>2.0 / Brightness</code>
-* 1: '''Linear''': Coefficient B is set to <code>250 / Multiplier</code>
+* 1: '''Linear''': Coefficient B is set to <code>250 / Brightness</code>
-* 2: '''Quadratic''': Coefficient C is set to <code>25000 / Multiplier</code>
+* 2: '''Quadratic''': Coefficient C is set to <code>25000 / Brightness</code>
 [[Category:File Formats]]
 [[Category:Metroid Prime]]
 [[Category:Metroid Prime 2: Echoes]]

@@ Line 26: / Line 26: @@
 | 0x4
 | float3
-| '''Light Color'''
+| '''Color'''
 | There is no alpha component.
 |-
@@ Line 41: / Line 41: @@
 | 0x28
 | float
-| '''Multiplier'''
+| '''Brightness'''
-| Color multiplier for local ambient, used to calculate attenuation coefficients for spot/custom
+| Multiplied by color for local ambient, used to calculate distance attenuation coefficients for spot/custom
 |-
 | 0x2C
 | float
 | '''Spot Cutoff'''
+| Used to calculate angle attenuation coefficients for spotlights
 |-
 | 0x30
@@ Line 95: / Line 95: @@
 | 0x4
 | float4
-| '''Light Color'''
+| '''Color'''
 | This color ''does'' have an alpha component, unlike Prime 1 lights.
 |-
@@ Line 115: / Line 115: @@
 | 0x38
 | float
-| '''Multiplier'''
+| '''Brightness'''
-| Color multiplier for local ambient, used to calculate attenuation coefficients for spot/custom
+| Multiplied by color for local ambient, used to calculate distance attenuation coefficients for spot/custom
 |-
 | 0x3C
 | float
 | '''Spot Cutoff'''
+| Used to calculate angle attenuation coefficients for spotlights
 |-
 | 0x40

@@ Line 7: / Line 7: @@
 ==Format==
-The header for the light section is extremely simple and consists of the magic value <code>0xBABEDEAD</code>. It's then followed by two arrays of lights, each preceded by a light count.
+The lights section has a very brief header consisting of the magic value <code>0xBABEDEAD</code>. It's then followed by a number of '''light layers'''. Each light layer consists of a count value, then an array of lights. Each layer represents a separate set of lights; actors can choose with set they're lit with through an object property in LightParameters. The number of light layers is static, but it varies from game to game; Prime 1 and 2 can have up to two light layers, while Prime 3 can have four.
 === Metroid Prime 1/2 ===

@@ Line 1: / Line 1: @@
-The '''lights''' section in Metroid Prime areas defines several different types of lights: local ambient, directional, spot, and custom. Every light type has the same structure in the file; however, different types are utilized in different ways by the engine. This particular light format can be found in Metroid Prime 1 and 2.
+The '''lights''' section in Metroid Prime areas defines several different types of lights: local ambient, directional, spot, and custom. Every light type has the same structure in the file; however, different types are utilized in different ways by the engine.
-{{research|minor|Lights are mostly figured out; the remaining unknowns are very likely unused, because the game's code never accesses them or passes them to the main light class, but it would be good to have some double-checking.}}
+{{research|minor|Lights are mostly figured out; the remaining unknowns are very likely unused, because the game's code never accesses them or passes them to the main light class, but it would be good to have some double-checking. There's also more unknowns in the Prime 3 lights format that probably -are- used.}}
 __TOC__
@@ Line 9: / Line 9: @@
 The header for the light section is extremely simple and consists of the magic value <code>0xBABEDEAD</code>. It's then followed by two arrays of lights, each preceded by a light count.
-===Light===
+=== Metroid Prime 1/2 ===
 Each light is a 0x41-byte struct. Note that the same structure is used for every light type, but not every value is used by every type; in fact, some of them aren't used by any of them.
@@ Line 27: / Line 27: @@
 | float3
 | '''Light Color'''
+| There is no alpha component.
 |-
 | 0x10
@@ Line 55: / Line 55: @@
 |-
 | 0x34
-| byte
+| bool
 | {{unknown|'''Unknown'''}}
 | Possibly unused
@@ Line 75: / Line 75: @@
 |-
 | 0x41
 | colspan=3 {{unknown|End of light}}
 |}

@@ Line 1: / Line 1: @@
-The '''Lights''' section in Metroid Prime areas defines several different types of lights: spot, point, directional, and custom. The exact behavior for each type of light is not entirely known, however they all use the same struct. The only difference is how they're utilized by the engine.
+The '''lights''' section in Metroid Prime areas defines several different types of lights: local ambient, directional, spot, and custom. Every light type has the same structure in the file; however, different types are utilized in different ways by the engine.
 {{research|moderate|Need to research meaning behind remaining unknowns}}
@@ Line 11: / Line 11: @@
 ===Light===
-Each light is a 0x41-byte struct that consists of the following data:
+Each light is a 0x41-byte struct. Note that the same structure is used for every light type, but not every value is used by every type; in fact, some of them aren't used by any of them.
 {| class="wikitable"
@@ Line 98: / Line 98: @@
 | Custom
 |}
 [[Category:File Formats]]