Difference between revisions of "RpMaterial"

From GTAMods Wiki
Jump to navigation Jump to search
m
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{RW Section|Material|0x0007}}
+
{{RW Section
 +
| NAME = Material
 +
| VENDORNAME = Criterion Games
 +
| MODULENAME = Core
 +
| MODULEID = 000000
 +
| IDENTIFIER = 07
 +
| PARENTS = [[Material List (RW Section)|Material List]]
 +
| CHILDREN = [[Struct (RW Section)|Struct]], [[Texture (RW Section)|Texture]]
 +
| EXTENSIONS = [[Right To Render (RW Section)|Right To Render]], [[User Data PLG (RW Section)|User Data PLG]], [[Material Effects PLG (RW Section)|Material Effects PLG]], [[UV Animation PLG (RW Section)|UV Animation PLG]], [[Reflection Material (RW Section)|Reflection Material]], [[Specular Material (RW Section)|Specular Material]]
 +
}}
  
'''Material''' is a container section used in [[model file|DFF files]] as child of a [[Material List (RW Section)|Material List]] section. The section itself does not store any data at all. All additional information get stored inside a [[Struct (RW Section)|struct section]] which directly follows this one as a child. A ''material'' section is used to hold one or more texture maps.
+
'''RpMaterial''' is a [[RenderWare]] structure that stores geometric data for 3D geometry.
  
 
== Structure ==
 
== Structure ==
  
The structure of the material section defines information about the amount and appearance of the texture maps.
+
When streamed in/out it is usually the child of a [[Material List (RW Section)|Material List]] chunk and parent of a [[Struct (RW Section)|Struct]], optional [[Texture (RW Section)|Texture]] and [[Extension (RW Section)|Extension]] chunk.
  
4b - DWORD  - Unknown (usually 0)
+
The format of the Material's Struct chunk is as follows:
4b - DWORD  - Color (as an <code>D3DCOLOR</code> value)
 
4b - DWORD  - Unknown (usually 1)
 
4b - DWORD  - Number of textures
 
4b - FLOAT  - Unknown
 
4b - FLOAT  - Unknown
 
4b - FLOAT  - Unknown
 
  
== Child sections ==
+
int32        flags (unused)
 +
RwRGBA      color    (RwRGBA: uint8 r, g, b, a)
 +
int32        unused
 +
bool32      isTextured
 +
#if version > 0x30400
 +
  surface properties:
 +
    float32  ambient
 +
    float32  specular
 +
    float32  diffuse
 +
#endif
  
The number of textures defined above represents the number of child sections.
+
If the material is defined as textured above, a [[Texture (RW Section)|Texture]] chunk will follow the Struct.
  
* [[Texture (RW Section)|Texture]]
+
== See also ==
  
=== Extension ===
 
 
Additionally each ''material'' can hold an extension. This extension holds the following sections in the order they are listed in here.
 
 
* [[Material Effects PLG (RW Section)|Material Effects PLG]]
 
* [[Reflection Material (RW Section)|Reflection Material]]
 
* [[Specular Material (RW Section)|Specular Material]]
 
* [[UV Animation PLG (RW Section)|UV Animation PLG]]
 
 
== See also ==
 
 
* [[Geometry List (RW Section)|Geometry List]]
 
* [[Geometry List (RW Section)|Geometry List]]
* [[RenderWare_binary_stream_file|RW file format specification]]
 
  
{{N|SA|VC}}
+
{{N|SA|VC|3}}
[[Category:GTA_3]]
 

Latest revision as of 10:57, 14 September 2020

Material
RenderWare Stream Section
Vendor Criterion Games
Module Core
Module ID 0x000000
Identifier 0x07
Chunk ID 0x00000007
Versions All
Hierarchy
Parents:
Material List
Children:
Struct, Texture
Extensions:
Right To Render, User Data PLG, Material Effects PLG, UV Animation PLG, Reflection Material, Specular Material
File Format

RpMaterial is a RenderWare structure that stores geometric data for 3D geometry.

Structure

When streamed in/out it is usually the child of a Material List chunk and parent of a Struct, optional Texture and Extension chunk.

The format of the Material's Struct chunk is as follows:

int32        flags (unused)
RwRGBA       color    (RwRGBA: uint8 r, g, b, a)
int32        unused
bool32       isTextured
#if version > 0x30400
  surface properties:
    float32  ambient
    float32  specular
    float32  diffuse
#endif

If the material is defined as textured above, a Texture chunk will follow the Struct.

See also