Lights (Metroid Prime) - Revision history

>Aruki: /* Metroid Prime 3 */

2019-03-27T04:30:29Z

Metroid Prime 3

← Older revision		Revision as of 04:30, 27 March 2019
Line 140:		Line 140:
	\| 0x49		\| 0x49
	\| u32		\| u32
	\| Falloff Type		\| '''Falloff Type'''
	\|		\|
	\|-		\|-

>Aruki: /* Custom */

2019-03-27T04:30:18Z

Custom

← Older revision		Revision as of 04:30, 27 March 2019
Line 222:		Line 222:
	Each falloff type will set one distance attenuation coefficient, with the other two set to 0. For each type:		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:File Formats]]
	[[Category:Metroid Prime]]		[[Category:Metroid Prime]]
	[[Category:Metroid Prime 2: Echoes]]		[[Category:Metroid Prime 2: Echoes]]

>Aruki at 04:29, 27 March 2019

2019-03-27T04:29:53Z

← Older revision		Revision as of 04:29, 27 March 2019
Line 26:		Line 26:
	\| 0x4		\| 0x4
	\| float3		\| float3
	\| '''~~Light~~ Color'''		\| '''Color'''
	\| There is no alpha component.		\| There is no alpha component.
	\|-		\|-
Line 41:		Line 41:
	\| 0x28		\| 0x28
	\| float		\| 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		\| 0x2C
	\| float		\| float
	\| '''Spot Cutoff'''		\| '''Spot Cutoff'''
	\|		\| Used to calculate angle attenuation coefficients for spotlights
	\|-		\|-
	\| 0x30		\| 0x30
Line 95:		Line 95:
	\| 0x4		\| 0x4
	\| float4		\| float4
	\| '''~~Light~~ Color'''		\| '''Color'''
	\| This color ''does'' have an alpha component, unlike Prime 1 lights.		\| This color ''does'' have an alpha component, unlike Prime 1 lights.
	\|-		\|-
Line 115:		Line 115:
	\| 0x38		\| 0x38
	\| float		\| 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		\| 0x3C
	\| float		\| float
	\| '''Spot Cutoff'''		\| '''Spot Cutoff'''
	\|		\| Used to calculate angle attenuation coefficients for spotlights
	\|-		\|-
	\| 0x40		\| 0x40

>Aruki at 15:07, 28 September 2015

2015-09-28T15:07:00Z

← Older revision		Revision as of 15:07, 28 September 2015
Line 7:		Line 7:
	==Format==		==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 ===		=== Metroid Prime 1/2 ===

>Aruki at 09:01, 28 September 2015

2015-09-28T09:01:51Z

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

>Aruki at 21:02, 18 March 2015

2015-03-18T21:02:15Z

← Older revision		Revision as of 21:02, 18 March 2015
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.		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.

	{{research\|~~moderate~~\|~~Need to research meaning behind~~ remaining unknowns}}		{{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.}}

	__TOC__		__TOC__
Line 130:		Line 130:
	[[Category:Metroid Prime]]		[[Category:Metroid Prime]]
	[[Category:Metroid Prime 2: Echoes]]		[[Category:Metroid Prime 2: Echoes]]
	~~[[Category:Major research needed]]~~

>Aruki at 20:57, 18 March 2015

2015-03-18T20:57:25Z

@@ 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]]

>Aruki: /* Light */

2015-03-10T23:05:51Z

Light

← Older revision		Revision as of 23:05, 10 March 2015
Line 41:		Line 41:
	\| 0x28		\| 0x28
	\| float		\| float
	~~\| {{unknown~~\|'''~~Unknown~~'''}}		\| '''Multiplier'''
	\| ~~Used as a color~~ multiplier for local ambient, ~~and~~ used to calculate attenuation for spot/custom.		\| Color multiplier for local ambient, used to calculate attenuation coefficients for spot/custom
	\|-		\|-
	\| 0x2C		\| 0x2C
Line 52:		Line 52:
	\| float		\| float
	\| {{unknown\|'''Unknown'''}}		\| {{unknown\|'''Unknown'''}}
	\|		\| Possibly unused
	\|-		\|-
	\| 0x34		\| 0x34
	\| byte		\| byte
	\| '''~~Quadratic Cutoff~~'''		\| {{unknown\|'''Unknown'''}}
	\|		\| Possibly unused
	\|-		\|-
	\| 0x35		\| 0x35
	\| float		\| float
	\| '''~~Light Factor~~'''		\| {{unknown\|'''Unknown'''}}
	\|		\| Possibly unused
	\|-		\|-
	\| 0x39		\| 0x39
	\| long		\| long
	~~\| {{unknown~~\|'''~~Unknown~~'''}}		\| '''Falloff Type'''
	\| ~~Modifies how attenuation is calculated.~~ Possible values ~~range from~~ 0-2.		\| Possible values: 0 - Constant; 1 - Linear; 2 - Quadratic
	\|-		\|-
	\| 0x3D		\| 0x3D
	\| float		\| float
	\| {{unknown\|'''Unknown'''}}		\| {{unknown\|'''Unknown'''}}
	\|		\| Possibly unused
	\|-		\|-
	\| 0x41		\| 0x41

>Aruki at 15:54, 9 March 2015

2015-03-09T15:54:30Z

← Older revision		Revision as of 15:54, 9 March 2015
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: 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.

	{{research\|3\|Need to research meaning behind remaining unknowns}}		{{research\|moderate\|Need to research meaning behind remaining unknowns}}

	__TOC__		__TOC__

>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

← Older revision		Revision as of 15:54, 9 March 2015
Line 98:		Line 98:
	\| Custom		\| Custom
	\|}		\|}

	The game doesn't actually track separate light types internally; rather, each light type is a preset that only draws from a couple of the possible parameters. The Custom type is not a preset, and allows further control over how the light is set up. Custom lights are commonly found under type 0x2, acting as point/omni lights.

	[[Category:File Formats]]		[[Category:File Formats]]