Retro Modding Wiki

Materials (Metroid Prime 3): Difference between revisions

Page Discussion

Materials (Metroid Prime 3) (view source)

Revision as of 06:57, 18 February 2016

4,106 bytes added ,  18 February 2016
m
→‎Subsections
VisualWikitext
>Aruki
>Aruki
 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
The format for '''materials''' saw a dramatic overhaul in Metroid Prime 3. The format is seen in both the CMDL and MREA formats and is identical in both. This particular material format appears in Metroid Prime 3: Corruption and Donkey Kong Country Returns.
The format for '''materials''' saw a dramatic overhaul in Metroid Prime 3. The format is seen in both the CMDL and MREA formats and is identical in both. This particular material format appears in Metroid Prime 3: Corruption and Donkey Kong Country Returns.


{{research|moderate|Need to find TEV values for each subsection type}}
{{research|moderate|There are a ton of unknowns in this format}}


__TOC__
__TOC__
Line 7: Line 7:
== Material Set Format ==
== Material Set Format ==


Materials come as part of a set; although most files will only have one set, some CMDLs will have more, as indicated by a count value in the header. The set format is merely a 32-bit count value followed by that number of materials.
Materials come as part of a set; although most files will only have one set, some CMDLs will have more, as indicated by a count value in the header. The set format is merely a 32-bit count value followed by that number of materials. In Metroid Prime 3, each material set will be in its own CMDL/MREA section, but in DKCR each set will be in the same section.


== Material Format ==
== Material Format ==
Line 97: Line 97:
| 3
| 3
| 0x8
| 0x8
| Enable punchthrough alpha
| Enable alpha blending
|-
|-
| 4
| 4
| 0x10
| 0x10
| {{unknown|Unknown}}
| Enable punchthrough alpha. The alpha channel of the texture on the <code>CLR </code> pass will be sampled. Bloom passes will be disabled. The alpha compare function is <code>alpha <= 0.75</code>.
|-
|-
| 5
| 5
Line 130: Line 130:
| 0x800
| 0x800
| {{unknown|Unknown}}
| {{unknown|Unknown}}
|-
| 12
| 0x1000
| {{unknown|Unknown}}
|-
| 13
| 0x2000
| {{unknown|Unknown}}
|-
| 14
| 0x4000
| {{unknown|Unknown}}
|-
| 15
| 0x8000
| {{unknown|Unknown}}
|-
| 16
| 0x10000
| {{unknown|Unknown}}
|-
| 17
| 0x20000
| {{unknown|Unknown; DKCR only}}
|-
| 18
| 0x40000
| {{unknown|Unknown; DKCR only}}
|-
| 19
| 0x80000
| Render with white ambient color. This is used on world geometry that doesn't have lightmaps. DKCR only.
|-
| 20
| -
| Unused in MP3; possibly used in DKCR
|}
==== Vertex Attribute Flags ====
These flags are generally toggled in pairs, with each pair corresponding to a vertex attribute; if a pair is set, then vertices using this material will have the corresponding attribute. This is vital for reading geometry. Each pair is used to indicate the size of the attribute indices in the geometry data, with 3 meaning a 16-bit index and 2 meaning an 8-bit index. (This isn't actually used, though; the original game data always uses 16-bit indices.)
GX supports up to 8 texture coords per vertex, but the game doesn't seem to allow you to assign more than 7 (though this could do with some double-checking).
These are the possible attributes:
{| class="wikitable"
! Bit pair
! Attribute
|-
| 0x3
| Position
|-
| 0xC
| Normal
|-
| 0x30
| Color 0
|-
| 0xC0
| Color 1
|-
| 0x300
| Tex 0
|-
| 0xC00
| Tex 1
|-
| 0x3000
| Tex 2
|-
| 0xC000
| Tex 3
|-
| 0x30000
| Tex 4
|-
| 0xC0000
| Tex 5
|-
| 0x300000
| Tex 6
|}
The top byte is structured differently; unlike the other flags, the bits in the top byte Are not set in pairs. Each individual bit indicates the presence of a different attribute. The indices in the geometry data are always 8 bits.
{| class="wikitable"
! Bit
! Attribute
|-
| 0x1
| Position Matrix Index
|-
| 0x2
| Tex0 Matrix Index
|-
| 0x4
| Tex1 Matrix Index
|-
| 0x8
| Tex2 Matrix Index
|-
| 0x10
| Tex3 Matrix Index
|-
| 0x20
| Tex4 Matrix Index
|-
| 0x40
| Tex5 Matrix Index
|-
| 0x80
| Tex6 Matrix Index
|}
|}


=== Subsections ===
=== Subsections ===


The rest of the material data is made up of a number of subsections. These subsections generally set different texture slots, as well as other parameters like Konst colors and material opacity. There's no count for the number of subsections; it needs to be read in using a while loop. The "END " section denotes the end of the material.
The rest of the material data is made up of a number of subsections. These subsections generally set different texture slots, as well as other parameters like Konst colors and material opacity. There's no count for the number of subsections; it needs to be read in using a while loop. The <code>END </code> section denotes the end of the material.


The order of the subsections doesn't matter. One material can only have one of each type of subsection; if there's any additional ones, they will overwrite the previous ones.
The order of the subsections doesn't matter. One material can only have one of each type of subsection; if there's any additional ones, they will overwrite the previous ones.


There are three subsection types (aside from END): PASS, CLR, and INT. Each of these types has a number of subtypes.
There are three subsection types (aside from <code>END </code>): <code>PASS</code>, <code>CLR </code>, and <code>INT </code>. Each of these types has a number of subtypes.


==== PASS ====
==== PASS ====
The PASS sections set up a single rendering pass, consisting of one TEV stage and potential other data to go with it (like a UV animation). One pass is 32 bytes (without the animation) and is structured as follows:


{| class="wikitable"
{| class="wikitable"
Line 164: Line 279:
| u32
| u32
| 4
| 4
| {{unknown|'''Unknown'''}}
| '''Pass Flags'''
| Only bottom 5 bits are valid
| Only bottom 5 bits are valid
|-
|-
Line 182: Line 297:
| u32
| u32
| 4
| 4
| '''UV animations size'''
| '''UV Animation Size'''
| Needs verification; only bottom 8 bits are valid
|
|}
|}


List of possible PASS subtypes:
If there's a UV anim, it is structured like this:


{| class="wikitable"
{| class="wikitable"
! Offset
! Type
! Type
! Size
! Description
! Description
|-
| 0x0
| u16
| 2
| {{unknown|'''Unknown'''}}
|-
| 0x2
| u16
| 2
| {{unknown|'''Unknown'''}}
|-
| 0x4
| u32
| 4
| '''[[UV_Animations#Animation_Modes|Animation Type]]'''
|}
List of possible PASS subtypes: (note: the pass types are also processed in this order)
{| class="wikitable"
! Type
! Description
! MP3
! DKCR
|-
|-
| <code>DIFF</code>
| <code>DIFF</code>
| Lightmap
| Lightmap
| {{check}}
| {{check}}
|-
| <code>RIML</code>
| Rim lighting map
| {{nocheck}}
| {{check}}
|-
|-
| <code>BLOL</code>
| <code>BLOL</code>
| Bloom lightmap
| Bloom lightmap
| {{check}}
| {{nocheck}}
|-
| <code>BLOD</code>
| Bloom diffuse map
| {{check}}
| {{nocheck}}
|-
|-
| <code>CLR </code>
| <code>CLR </code>
| Diffuse map
| Diffuse map
| {{check}}
| {{check}}
|-
|-
| <code>TRAN</code>
| <code>TRAN</code>
| Greyscale opacity map; white indicates transparent, black indicates opaque (Retro is backwards)
| Opacity map
| {{check}}
| {{check}}
|-
|-
| <code>INCA</code>
| <code>INCA</code>
| Emissive map
| Incandescence map
| {{check}}
| {{check}}
|-
|-
| <code>RFLV</code>
| <code>RFLV</code>
| Specular map
| Reflectivity map
| {{check}}
| {{check}}
|-
|-
| <code>RFLD</code>
| <code>RFLD</code>
| Reflection/sphere map
| Reflection map
| {{check}}
| {{check}}
|-
|-
| <code>LRLD</code>
| <code>LRLD</code>
| See RFLD
| {{unknown|Unknown}}
| {{check}}
| {{check}}
|-
|-
| <code>LURD</code>
| <code>LURD</code>
| See RFLV
| {{unknown|Unknown}}
|-
| {{check}}
| <code>BLOD</code>
| {{check}}
| See BLOL
|-
|-
| <code>BLOI</code>
| <code>BLOI</code>
| See BLOL
| Bloom incandescence map
| {{check}}
| {{nocheck}}
|-
|-
| <code>XRAY</code>
| <code>XRAY</code>
| Sphere map for X-Ray models; similar to RFLD
| Reflection map for X-Ray models; similar to <code>RFLD</code>
| {{check}}
| {{nocheck}}
|-
| <code>TOON</code>
| {{unknown|Unknown; unused}}
| {{nocheck}}
| {{check}}
|}
|}
===== Flags =====
Known flag settings:
{| class="wikitable"
! Bit
! Hex
! Description
|-
| 0
| 0x1
| {{unknown|Unknown}}
|-
| 1
| 0x2
| {{unknown|Unknown}}
|-
| 2
| 0x4
| On <code>INCA</code>, factors in the texture map as a bloom map as (0.25 * texture alpha)
|-
| 3
| 0x8
| {{unknown|Unknown}}
|-
| 4
| 0x10
| On <code>TRAN</code>, indicates that the texture map is inverted (ie. white is transparent, black is opaque).
|-
| 5+
| -
| Unused
|}
===== UV Animations =====
'' See [[UV Animations]]


==== CLR  ====
==== CLR  ====
Line 256: Line 469:
! Type
! Type
! Description
! Description
! MP3
! DKCR
|-
|-
| <code>CLR </code>
| <code>CLR </code>
|  
| {{unknown|Unknown}}
| {{check}}
| {{check}}
|-
|-
| <code>DIFB</code>
| <code>DIFB</code>
|  
| Lightmap multiplier color
| {{check}}
| {{check}}
|}
|}


Line 291: Line 510:
! Type
! Type
! Description
! Description
! MP3
! DKCR
|-
|-
| <code>OPAC</code>
| <code>OPAC</code>
| Sets the opacity of the entire material
| Sets the opacity of the entire material
| {{check}}
| {{check}}
|-
|-
| <code>BLOD</code>
| <code>BLOD</code>
|  
| {{unknown|Unknown; bloom-related?}}
| {{check}}
| {{nocheck}}
|-
|-
| <code>BLOI</code>
| <code>BLOI</code>
|  
| {{unknown|Unknown; bloom-related?}}
| {{check}}
| {{nocheck}}
|-
|-
| <code>BNIF</code>
| <code>BNIF</code>
|  
| {{unknown|Unknown}}
| {{check}}
| {{nocheck}}
|-
|-
| <code>XRBR</code>
| <code>XRBR</code>
|  
| {{unknown|Unknown; X-Ray related?}}
| {{check}}
| {{nocheck}}
|}
|}


Anonymous user
Retrieved from "https://wiki.axiodl.com/w/Special:MobileDiff/1708...1736"