Geometry (RW Section)
|RW Stream Section|
Geometry is a container section used in DFF files as child of a Geometry List section. The section itself does not store any data at all. All additional information get stored inside a struct section which directly follows this one as a child. Geometry is one of the most important sections inside a
.dff model file. It stores geometry information for models (like the mesh and the texture maps).
The structure differs for most files, but it always gets introduced by the following set of values:
2b - WORD - Flags (See below) 1b - BYTE - Number of UV coordinates (GTA default is 1) 1b - BYTE - Geometry native flags // 0x01 rpGEOMETRYNATIVE // 0x02 rpGEOMETRYNATIVEINSTANCE 4b - DWORD - Triangle count 4b - DWORD - Vertex count 4b - DWORD - Frame count
For all versions below 3.4 also some lightning color values are stored.
4b - DWORD - Ambient color (Represents an DirectX
D3DCOLORvalue ) 4b - DWORD - Diffuse color (Represents an DirectX
D3DCOLORvalue) 4b - DWORD - Specular color (Represents an DirectX
The following flags descripe the behaviour of the mesh during the rendering progress. Some of the flags indicate the existance of data inside the following file format.
||Is triangle strip (if disabled it will be an triangle list)|
||Vertex translation (|
||Texture coordinates 1 (|
||Vertex colors (|
||Store normals (|
||Dynamic vertex lightning (?)|
||Modulate material color|
||Texture coordinates 2 (|
All of those flags (except the first) are used to build up the flexible vertex format (FVF) .
If flag 8 is enabled vertex color information for each vertex get stored up next:
4b - DWORD - Vertex color (D3DCOLOR)
The default value is 0x00FFFFFF (representing non-transparent white).
With San Andreas Rockstar's engine is able to change the vertex colors for ingame nights. Therefor there is an custom section called Night Vertex Colors. This prevents the game from loading new models at different times and increments the performance of the engine. Previous games stored copies of the model with different prelightning information and defined it inside the TOBJ IDE section.
If flag 4 or 128 is set texture coordinates are following next. If both are set then the texture coordinates for the first texture of all vertices are listed before the texture coordinates for the second chanel of all vertices (By default no GTA game ever uses more than 1 UV coordinate at one time).
4b - FLOAT - Texture coordinate U 4b - FLOAT - Texture coordinate V
The following array holds indices and attributes for each triangle. The number of indices is represented by the third multiple of the triangle count value. So for each triangle the following format gets used:
2b - WORD - Index of first vertex 2b - WORD - Index of second vertex 2b - WORD - Attribute for line/triangle 2b - WORD - Index of third vertex
Attribute describes an index of a subset map of the geometry. Those maps are collectrions of faces with the same material stored inside the Bin Mesh PLG section.
The bounding information are used to check weather the mesh is visible for the camera, or not. It only exists once per geometry section.
4b - FLOAT - Center X 4b - FLOAT - Center Y 4b - FLOAT - Center Z 4b - FLOAT - Radius of bounding sphere 4b - DWORD - Has position 4b - DWORD - Has normals
The central vector (
D3DXVECTOR3) describes the center of the bounding sphere as an offset from the placement of the object inside the real world.
Vertex translation info
The number of vertices gets defined inside the geometry structure. If flag 2 is set the translation information gets stored for each vertex as a
4b - FLOAT - Position X 4b - FLOAT - Position Y 4b - FLOAT - Position Z
The position values are an offset relative to the mesh pivot.
In case flag 16 is set the normal vectors are the last part of the geometry data structure. They are also stored as a
D3DXVECTOR3 for each vertex:
4b - FLOAT - Direction X 4b - FLOAT - Direction Y 4b - FLOAT - Direction Z
The extension of an geometry usually holds the following sections in the order they are listed in here:
- Bin Mesh PLG
- Native Data PLG – (Only for consoles)
- Skin PLG
- Mesh Extension
- Night Vertex Colors
- Morph PLG
|Grand Theft Auto: San Andreas|
|File Formats||.col • .cfg • .cut • .dff • .dat • .fxp • .gxt • .ide • .ifp • .img • .ipl • nodes*.dat • .rep • .rrr • .scm • .set • .txd|
|Documentation||Audio • Cryptography • Cutscenes • Handling.cfg • Map Listing • Mission Packs • Opcodes • Paths • Replays • Saves • Scripts|
|Tools||CLEO • Collision File Editor II • ENBSeries • G-Tools • IMG Tool • Limit Adjuster • Map Editor • San Andreas Audio Toolkit • Sanny Builder • TXD Workshop|
|Tutorials||San Andreas v2.0 Modding • How to create a mission • How to create a thread • How to use Map Editor|
|Modifications||Design Your Own Mission • Gostown Paradise • GTA: United • Myriad Islands|