Difference between revisions of "RpClump"

From GTAMods Wiki
Jump to navigation Jump to search
m
m
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{RW Section|Clump|0x0010}}
+
{{RW Section
 +
| NAME = Clump
 +
| VENDORNAME = Criterion Games
 +
| MODULENAME = Core
 +
| MODULEID = 000000
 +
| IDENTIFIER = 10
 +
| PARENTS = [[Material List (RW Section)|Material List]]
 +
| CHILDREN = [[Struct (RW Section)|Struct]], [[Frame List (RW Section)|Frame List]], [[Geometry List (RW Section)|Geometry List]], [[Atomic (RW Section)|Atomic]], [[Light (RW Section)|Light]], [[Camera (RW Section)|Camera]]
 +
| EXTENSIONS = [[Collision Model (RW Section)|Collision Model]]
 +
}}
  
'''Clump''' is usually the root section of [[model file|DFF files]]. It only contains child sections and no data. All additional data is stored inside a [[Struct_(RW_Section)|struct section]]. A clump section may appear multiple times inside one <code>.dff</code> files. There is no counting variable stored inside the file defining how many clumps are stored inside it.
+
A '''Clump''' is a container for a [[Frame List (RW Section)|Frame hierarchy]] to which [[Atomic (RW Section)|Atomics]], [[Light (RW Section)|Lights]] and [[Camera (RW Section)|Cameras]] are attached.
  
 +
== Structure ==
  
 +
In a binary stream a Clump's child chunks are a [[Struct (RW Section)|Struct]] (described below), a [[Frame List (RW Section)|Frame List]], a [[Geometry List (RW Section)|Geometry List]], a number of [[Atomic (RW Section)|Atomics]], optionally a number of Structs and [[Light (RW Section)|Lights]] and a number of Structs and [[Camera (RW Section)|Cameras]] (Cameras are unused in GTA).
 +
Actually a <code>.dff</code> file contains exactly one Clump by definition but R* stores more than one in some cases (III peds and SA player models).
  
== Structure ==
+
Cameras and Lights as part of Clumps were first introduced after version <code>0x33000</code>. Versions <code>0x33000</code> and below do not have them.
 
 
All additional information for the clump section is stored in a ''struct section'' which is the first child section of the clump. It stores the following information:
 
  
4b - DWORD  - Number of atomically linked objects, representing the number of [[Atomic_(RW_Section)|atomic sections]].
 
4b - DWORD  - Number of lights *
 
4b - DWORD  - Number of cameras *
 
  
''* GTA does not support dynamic lights and multiple cameras so those values are zero by default.
+
The Clump's Struct has the following format:
  
== Child sections ==
+
int32 - Number of Atomics
 +
int32 - Number of Lights - only present after version 0x33000
 +
int32 - Number of Cameras - only present after version 0x33000 but 0 in all GTA files
  
* [[Frame List (RW Section)|Frame List]]
+
Following the struct are a Frame List and a Geometry List.
* [[Geometry List (RW Section)|Geometry List]]
+
After that a number of Atomics as given by the atomic count.
* [[Atomic (RW Section)|Frame List]] &ndash; Can be present multiple times depending on the number of objects (see ''Structure''.)
+
If the Clump has lights or cameras, next come pairs of Structs and Lights and Structs and Cameras respectively. In both cases the Struct contains a 4 byte index into the Frame List for the [[Frame (RW Section)|Frame]] the Light or Camera should be attached to.
  
== See also ==
+
Before version 0x30400 (<code>loplyguy.dff</code> in GTA III, version <code>0x30200</code>) the structure is a little different. The Clump has no Geometry List and the Geometries are children of their respective Atomic chunks (and consequently the Atomic Struct is 4 bytes shorter for having no geometry index).
* [[RenderWare_binary_stream_file|RW file format specification]]
 
* [[Texture Dictionary (RW Section)]]
 
  
{{N|SA|VC}}
+
{{N|SA|VC|3}}
[[Category:GTA_3
 

Latest revision as of 10:58, 14 September 2020

Clump
RenderWare Stream Section
Vendor Criterion Games
Module Core
Module ID 0x000000
Identifier 0x10
Chunk ID 0x00000010
Versions All
Hierarchy
Parents:
Material List
Children:
Struct, Frame List, Geometry List, Atomic, Light, Camera
Extensions:
Collision Model
File Format

A Clump is a container for a Frame hierarchy to which Atomics, Lights and Cameras are attached.

Structure

In a binary stream a Clump's child chunks are a Struct (described below), a Frame List, a Geometry List, a number of Atomics, optionally a number of Structs and Lights and a number of Structs and Cameras (Cameras are unused in GTA). Actually a .dff file contains exactly one Clump by definition but R* stores more than one in some cases (III peds and SA player models).

Cameras and Lights as part of Clumps were first introduced after version 0x33000. Versions 0x33000 and below do not have them.


The Clump's Struct has the following format:

int32 - Number of Atomics
int32 - Number of Lights - only present after version 0x33000
int32 - Number of Cameras - only present after version 0x33000 but 0 in all GTA files

Following the struct are a Frame List and a Geometry List. After that a number of Atomics as given by the atomic count. If the Clump has lights or cameras, next come pairs of Structs and Lights and Structs and Cameras respectively. In both cases the Struct contains a 4 byte index into the Frame List for the Frame the Light or Camera should be attached to.

Before version 0x30400 (loplyguy.dff in GTA III, version 0x30200) the structure is a little different. The Clump has no Geometry List and the Geometries are children of their respective Atomic chunks (and consequently the Atomic Struct is 4 bytes shorter for having no geometry index).