User Data PLG (RW Section) - Revision history

Aschratt at 12:25, 11 September 2020

2020-09-11T12:25:46Z

Aschratt at 12:25, 11 September 2020

2020-09-11T12:25:27Z

Aschratt: /* User Data Types */

2020-09-07T11:17:40Z

‎User Data Types

Aschratt at 11:10, 7 September 2020

2020-09-07T11:10:37Z

Muzzarino: User data needs to have documentation, so adding a page.

2020-05-14T13:07:38Z

User data needs to have documentation, so adding a page.

New page

{{RW Section|User Data PLG|0x011F}}
Custom data through the User Data extension (part of the Toolkit extensions) can be used to attach certain effects such as custom renderstates, morph data or other effects read by a function implemented into any of the GTA games..

== Structure ==
struct RpUserDataFormat
{
uint32 NumberOfSections;
uint32 StringLength;
string DataName;
uint32 Format;
uint32 NumberofElements;
void* Parameters;
};

== See also ==
* [[Atomic (RW Section)|Atomic]]
* [[Material (RW Section)|Material]]
* [[Reflection Material (RW Section)|Reflection Material]]
* [[Specular Material (RW Section)|Specular Material]]
* [[UV Animation PLG (RW Section)|UV Animation PLG]]
* [[Texture (RW Section)|Texture]]
* [[Geometry List (RW Section)|Geometry List]]
* [[RenderWare_binary_stream_file|RW file format specification]]

{{N|SA|VC}}
[[Category:GTA_3]]

@@ Line 38: / Line 38: @@
 b - DWORD     - String length (X)
   Xb - CHAR[X]   - String character field
 {{N|SA|VC|3}}

@@ Line 19: / Line 19: @@
 === User Data Types ===
-The data type identifies one of the following values:
+The data type is identified by one of the following values:
 x01 - Integer (signed 32 bit integer)

@@ Line 1: / Line 1: @@
-{{RW Section|User Data PLG|0x011F}}
+{{RW Section
 Custom data through the User Data extension (part of the Toolkit extensions) can be used to attach certain effects such as custom render states, morph data or other effects read by a function implemented into any of the GTA games. User data is organized as a dictionary, where a unique name maps to an array of objects.
@@ Line 33: / Line 40: @@
 == See also ==
 * [[Atomic (RW Section)|Atomic]]
 * [[Material (RW Section)|Material]]
@@ Line 40: / Line 48: @@
 * [[Texture (RW Section)|Texture]]
 * [[Geometry List (RW Section)|Geometry List]]
-{{N|SA|VC}}
+{{N|SA|VC|3}}

@@ Line 1: / Line 1: @@
 {{RW Section|User Data PLG|0x011F}}
-== Structure ==
+Custom data through the User Data extension (part of the Toolkit extensions) can be used to attach certain effects such as custom render states, morph data or other effects read by a function implemented into any of the GTA games. User data is organized as a dictionary, where a unique name maps to an array of objects.
-  struct RpUserDataFormat
+== Binary Layout ==
-     uint32 NumberOfSections;
-     uint32 StringLength;
+The first four bytes of the sections' content store the number of entries of the dictionary.
-    string DataName;
-    uint32 Format;
+b  - DWORD    - Number of dictionary entries
-    uint32 NumberofElements;
-     void* Parameters;
+This value is then followed by a set of structures, where each one stores one entry of the dictionary.
-  };
 == See also ==