GTAMods Wiki - User contributions [en]

RenderWare binary stream file

2012-08-04T20:53:03Z

Xepomaht007:

{{File-stub}}
{{TocRight}}
'''RenderWare binary stream files''' are hierarchically structured binary data files used by the [[Wikipedia:RenderWare|RenderWare]] 3.x graphics engine utilized by [[Wikipedia:Rockstar North|Rockstar North]] for their GTA III trilogy (only on PC, [[Wikipedia:PS2|PS2]] and [[Wikipedia:XBOX|XBOX]], not [[Wikipedia:PSP|PSP]]!) and related games (Manhunt, Bully).

GTA's [[model file]]s use the [[Wikipedia:file extension|file extension]] <code>.dff</code> and [[texture archive]]s use <code>.txd</code>. Other possible extensions, not used by the GTA games, are <code>.rws</code>, <code>.bsp</code> and <code>.dma</code>. GTA3 does use <code>.anm</code> for some of its cutscene animations, but it is the only GTA to do so.

==File Format==

RW streams are split up into sections. Each section has a 12 byte header and can either be empty, contain data or more child sections. Section content, especially of data sections, is determined by an ID in the header.

There is only one data structure common to all RW streams - the '''section header''':

4 byte - DWORD - section identifier
4 byte - DWORD - section size, including child sections and/or data
4 byte - DWORD - RW version ID

The RW version ID varies depending on the RW engine version used for exporting the files. It must be the same for all headers within one file. Backwards compatibility is very limited.

===Valid RW Section IDs===

See the [[list of RW section IDs]].

===Rockstar's Custom Section IDs===

Rockstar added several vendor specific RW plugins, which have their own ID range (0x0253F2F*).

* [[Pipeline Set (RW Section)|Pipeline Set]] ''(0x0253F2F3)''
* [[Specular Material (RW Section)|Specular Material]] ''(0x0253F2F6)''
* [[2dfx (RW Section)|2dfx]] ''(0x0253F2F8)''
* [[Night Vertex Colors (RW Section)|Night Vertex Colors]] ''(0x0253F2F9)''
* [[Collision Model (RW Section)|Collision Model]] ''(0x0253F2FA)''
* [[Reflection Material (RW Section)|Reflection Material]] ''(0x0253F2FC)''
* [[Mesh Extension (RW Section)|Mesh Extension]] ''(0x0253F2FD)''
* [[Frame (RW Section)|Frame]] ''(0x0253F2FE)''

===Common RW Version IDs===

The following is an (incomplete) list of plain text RW versions commonly used in GTA and their encoded equivalent:

3.0.0.0 - 0x00000310 - only for multi-dff and generic, from old versions GTA III.
3.2.0.0 - 0x0800FFFF - PS2 and PC GTA III
3.3.0.2 - 0x0C02FFFF - GTA VC
3.4.0.3 - 0x1003FFFF - X-BOX GTA III, GTA VC
3.5.0.0 - 0x1400FFFF - Android GTA III
3.6.0.3 - 0x1803FFFF - GTA SA, Manhunt

==Common File Structures==

===Model Files (DFF)===

* [[Clump (RW Section)|Clump]]
** [[Struct (RW Section)#Clump|Struct]]
** [[Frame List (RW Section)|Frame List]]
*** [[Struct (RW Section)#Frame_List|Struct]]
*** [[Extension (RW Section)|Extension]] *
**** [[Frame (RW Section)|Frame]]
**** [[HAnim PLG (RW Section)|HAnim PLG]]
** [[Geometry List (RW Section)|Geometry List]]
*** [[Struct (RW Section)#Geometry_List|Struct]]
*** [[Geometry (RW Section)|Geometry]] *
**** [[Struct (RW Section)#Geometry|Struct]]
**** [[Material List (RW Section)|Material List]]
***** [[Struct (RW Section)#Material_List|Struct]]
***** [[Material (RW Section)|Material]] *
****** [[Struct (RW Section)#Material|Struct]]
****** [[Texture (RW Section)|Texture]] - optional
******* [[Struct (RW Section)#Texture|Struct]]
******* [[String (RW Section)|String]] - diffuse texture name
******* [[String (RW Section)|String]] - alpha texture name
******* [[Extension (RW Section)|Extension]]
******** [[Sky Mipmap Val (RW Section)|Sky Mipmap Val]] **
****** [[Extension (RW Section)|Extension]]
******* [[Material Effects PLG (RW Section)|Material Effects PLG]] - optional
******** [[Texture (RW Section)|Texture]] - optional ''(See [[Material Effects PLG (RW Section)|Material Effects PLG]] for more information)''
********* [[Struct (RW Section)#Texture|Struct]]
********* [[String (RW Section)|String]] - environment map name
********* [[String (RW Section)|String]] - alpha texture name
********* [[Extension (RW Section)|Extension]]
********** [[Sky Mipmap Val (RW Section)|Sky Mipmap Val]] **
******* [[Reflection Material (RW Section)|Reflection Material]] - optional
******* [[Specular Material (RW Section)|Specular Material]] - optional
******* [[UV Animation PLG (RW Section)|UV Animation PLG]] - optional
**** [[Extension (RW Section)|Extension]]
***** [[Bin Mesh PLG (RW Section)|Bin Mesh PLG]]
***** [[Native Data PLG (RW Section)|Native Data PLG]] (on Xbox and PS2)
***** [[Skin PLG (RW Section)|Skin PLG]]
***** [[Mesh Extension (RW Section)|Mesh Extension]] - optional
***** [[Night Vertex Colors (RW Section)|Night Vertex Colors]] - optional (static objects only)
***** [[Morph PLG (RW Section)|Morph PLG]]
***** [[2dfx (RW Section)|2dfx]] - optional
** [[Atomic (RW Section)|Atomic]] *
*** [[Struct (RW Section)#Atomic|Struct]]
*** [[Extension (RW Section)|Extension]]
**** [[Right To Render (RW Section)|Right To Render]] - optional
**** [[Particles PLG (RW Section)|Particles PLG]] - optional
**** [[Material Effects PLG (RW Section)|Material Effects PLG]] - optional
**** [[Pipeline Set (RW Section)|Pipeline Set]] - optional
** [[Extension (RW Section)|Extension]]
*** [[Collision Model (RW Section)|Collision Model]] - vehicles only

===Texture Archives (TXD)===

* [[Texture Dictionary (RW Section)|Texture Dictionary]]
** [[Struct (RW Section)#Texture_Dictionary|Struct]] - 4 byte, 2x word, first one is the texture count
** [[Texture Native (RW Section)|Texture Native]] *
*** [[Struct (RW Section)#Texture_Native|Struct]] - header and actual image data
*** [[Extension (RW Section)|Extension]] - empty
** [[Extension (RW Section)|Extension]] - empty

===Texture Archives PS2 (TXD)===
* [[Texture Dictionary (RW Section)|Texture Dictionary]]
** [[Struct (RW Section)#Texture_Dictionary|Struct]] - 4b - Texture count
** [[Texture Native (RW Section)|Texture Native]] *
*** [[Struct (RW Section)#Texture_Native|Struct]] - 4b - Platform, 4b- Filter Flags
*** [[String (RW Section)|String]] - Texture name
*** [[String (RW Section)|String]] - Alpha name
*** [[Struct (RW Section)|Struct]]
**** [[Struct (RW Section)|Struct]] - 4b- Width, 4b - Height, 4b - Bits per pixel, 4b - Raster flags, unknown
**** [[Struct (RW Section)|Struct]] - 80 bytes unknown, pixels/indices (80 bytes unknown, palette)
*** [[Extension (RW Section)|Extension]]
**** [[Sky Mipmap Val (RW Section)]] - 4 bytes unknown
** [[Extension (RW Section)|Extension]] - empty

''* These sections (and their child sections) can appear multiple times.

''** Not always present, effect also unknown.

''*** Require [[Pipeline Set (RW Section)|Pipeline Set]] to work for static objects, by default only for vehicles.

A byte may contain two indices, if bpp == 4.

16 bit images are in 1555 ARGB format or 565 (used by VC only on ancient hardware such as Riva TNT2 when you choose 16 bit color mode and game builds non-dxt version of txd files on disk).

The indices are swizzled and saved in a PS2 friendly format (CLUT).

Note: There are slight differences between GTA: III and VC formats concerning the raster/image format.

==Tools & Scripts==

* [http://www.steve-m.com/downloads/tools/rwanalyze/ RW Analyze] – by {{U|steve-m}}
* various [[model file]] and [[texture archive]] related tools

==See also==
* {{GTAF|128451|RW Analyze discussion thread}}
* [http://www.chronetal.co.uk/gta/index.php?page=dff Original DFF format description] by KCow
* [http://www.renderware.com Official RenderWare Site]
* [http://wiki.multimedia.cx/index.php?title=TXD MultimediaWiki TXD]

{{SA-navi}}
[[Category:3D File Formats]]

Native Data PLG (RW Section)

2012-08-04T20:47:58Z

Xepomaht007:

{{RW Section|Native Data PLG|0x510}}

== Structure (X-Box GTA 3, RW version 3.4.0.3) ==

('''Section Header''')
4 bytes - int - 5
4 bytes - hex - VertexOffset
2 bytes - int - VertexUnknow
2 bytes - int - MaterialCount
4 bytes - int - 6
4 bytes - int - VertexCount
4 bytes - int - 32
4 bytes - hex - 0x164314

('''Material Header''')
4 bytes - int - 0
4 bytes - int - unknow1
4 bytes - int - unknow2

('''Material tristrips info''')
{ARRAY OF SIZE: MaterialCount*24 bytes}
4 bytes - int - MaterialCount.VertexCountStart
4 bytes - int - MaterialCount.VertexCountEnd
4 bytes - int - MaterialCount.TristripsCount
4 bytes - int - MaterialCount.UnknowCount
4 bytes - hex - Unknow3 (in fist = 0x17AB78)
4 bytes - hex - 0x19ED91
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: 16 - (12+MaterialCount*24 bytes) mod 16}
1 byte - hex - 0xCD
{END ARRAY}

('''Tristrips''')
{ARRAY OF SIZE: MaterialCount.TristripsCount*2 bytes}
2 bytes - int - Vertex
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: unknow}
1 byte - hex - 0xCD
{END ARRAY}

('''Verticles''')
{ARRAY OF SIZE: Vertex Count*(24 or 32) bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
1 byte - int - Color R
1 byte - int - Color G
1 byte - int - Color B
1 byte - int - Color Alpha
4 bytes - float - U
4 bytes - float - V
{IF Textured_2=1 in flags THEN}
4 bytes - float - U
4 bytes - float - V
{END IF}
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: unknow}
1 byte - hex - 0xCD
{END ARRAY}

('''Normals''')
{IF Normals=1 in Flags THEN}
{ARRAY OF SIZE: Vertex Count*12 bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
{END ARRAY}
{END IF}

('''Padding''')
{ARRAY OF SIZE: unknow}
1 byte - hex - 0xCD
{END ARRAY}

== See also ==
* [[RenderWare_binary_stream_file|RW file format specification]]

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

Native Data PLG (RW Section)

2012-08-04T20:42:51Z

Xepomaht007:

{{RW Section|Native Data PLG|0x510}}

== Structure ==

('''Section Header''')
4 bytes - int - 5
4 bytes - hex - VertexOffset
2 bytes - int - VertexUnknow
2 bytes - int - MaterialCount
4 bytes - int - 6
4 bytes - int - VertexCount
4 bytes - int - 32
4 bytes - hex - 0x164314

('''Material Header''')
4 bytes - int - 0
4 bytes - int - unknow1
4 bytes - int - unknow2

('''Material tristrips info''')
{ARRAY OF SIZE: MaterialCount*24 bytes}
4 bytes - int - MaterialCount.VertexCountStart
4 bytes - int - MaterialCount.VertexCountEnd
4 bytes - int - MaterialCount.TristripsCount
4 bytes - int - MaterialCount.UnknowCount
4 bytes - hex - Unknow3 (in fist = 0x17AB78)
4 bytes - hex - 0x19ED91
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: 16 - (12+MaterialCount*24 bytes) mod 16}
1 byte - hex - 0xCD
{END ARRAY}

('''Tristrips''')
{ARRAY OF SIZE: MaterialCount.TristripsCount*2 bytes}
2 bytes - int - Vertex
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: unknow}
1 byte - hex - 0xCD
{END ARRAY}

('''Verticles''')
{ARRAY OF SIZE: Vertex Count*(24 or 32) bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
1 byte - int - Color R
1 byte - int - Color G
1 byte - int - Color B
1 byte - int - Color Alpha
4 bytes - float - U
4 bytes - float - V
{IF Textured_2=1 in flags THEN}
4 bytes - float - U
4 bytes - float - V
{END IF}
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: unknow}
1 byte - hex - 0xCD
{END ARRAY}

('''Normals''')
{IF Normals=1 in Flags THEN}
{ARRAY OF SIZE: Vertex Count*12 bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
{END ARRAY}
{END IF}

('''Padding''')
{ARRAY OF SIZE: unknow}
1 byte - hex - 0xCD
{END ARRAY}

== See also ==
* [[RenderWare_binary_stream_file|RW file format specification]]

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

Native Data PLG (RW Section)

2012-08-04T20:41:03Z

Xepomaht007:

{{RW Section|Native Data PLG|0x510}}

== Structure ==

('''Section Header''')
4 bytes - int - 5
4 bytes - hex - VertexOffset
2 bytes - int - VertexUnknow
2 bytes - int - MaterialCount
4 bytes - int - 6
4 bytes - int - VertexCount
4 bytes - int - 32
4 bytes - hex - 0x164314

('''Material Header''')
4 bytes - int - 0
4 bytes - int - unknow1
4 bytes - int - unknow2

('''Material tristrips info''')
{ARRAY OF SIZE: MaterialCount*24 bytes}
4 bytes - int - MaterialCount.VertexCountStart
4 bytes - int - MaterialCount.VertexCountEnd
4 bytes - int - MaterialCount.TristripsCount
4 bytes - int - MaterialCount.UnknowCount
4 bytes - hex - Unknow3 (in fist = 0x17AB78)
4 bytes - hex - 0x19ED91
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: 16 - (12+MaterialCount*24 bytes) mod 16}
4 bytes - hex - 0xCD
{END ARRAY}

('''Tristrips''')
{ARRAY OF SIZE: MaterialCount.TristripsCount*2 bytes}
2 bytes - int - Vertex
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: unknow}
4 bytes - hex - 0xCD
{END ARRAY}

('''Verticles''')
{ARRAY OF SIZE: Vertex Count*(24 or 32) bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
1 byte - int - Color R
1 byte - int - Color G
1 byte - int - Color B
1 byte - int - Color Alpha
4 bytes - float - U
4 bytes - float - V
{IF Textured_2=1 in flags THEN}
4 bytes - float - U
4 bytes - float - V
{END IF}
{END ARRAY}

('''Padding''')
{ARRAY OF SIZE: unknow}
4 bytes - hex - 0xCD
{END ARRAY}

('''Normals''')
{IF Normals=1 in Flags THEN}
{ARRAY OF SIZE: Vertex Count*12 bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
{END ARRAY}
{END IF}

('''Padding''')
{ARRAY OF SIZE: unknow}
4 bytes - hex - 0xCD
{END ARRAY}

== See also ==
* [[RenderWare_binary_stream_file|RW file format specification]]

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

Native Data PLG (RW Section)

2012-08-04T20:39:22Z

Xepomaht007: Created page with "{{RW Section|Native Data PLG|0x510}} == Structure == ('''Section Header''') 4 bytes - int - 5 4 bytes - hex - VertexOffset 2 bytes - int - Vertex..."

{{RW Section|Native Data PLG|0x510}}

== Structure ==

('''Section Header''')
4 bytes - int - 5
4 bytes - hex - VertexOffset
2 bytes - int - VertexUnknow
2 bytes - int - MaterialCount
4 bytes - int - 6
4 bytes - int - VertexCount
4 bytes - int - 32
4 bytes - hex - 0x164314

('''Material Header''')
4 bytes - int - 0
4 bytes - int - unknow1
4 bytes - int - unknow2

('''Material tristrips info''')
{ARRAY OF SIZE: MaterialCount*24 bytes}
4 bytes - int - MaterialCount.VertexCountStart
4 bytes - int - MaterialCount.VertexCountEnd
4 bytes - int - MaterialCount.TristripsCount
4 bytes - int - MaterialCount.UnknowCount
4 bytes - hex - Unknow3 (in fist = 0x17AB78)
4 bytes - hex - 0x19ED91
{END ARRAY}

('''????????????''')
{ARRAY OF SIZE: 16 - (12+MaterialCount*24 bytes) mod 16}
4 bytes - hex - 0xFFFFFFFF
{END ARRAY}

('''Tristrips''')
{ARRAY OF SIZE: MaterialCount.TristripsCount*2 bytes}
2 bytes - int - Vertex
{END ARRAY}

('''????????????''')
{ARRAY OF SIZE: unknow}
4 bytes - hex - 0xFFFFFFFF
{END ARRAY}

('''Verticles''')
{ARRAY OF SIZE: Vertex Count*(24 or 32) bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
1 byte - int - Color R
1 byte - int - Color G
1 byte - int - Color B
1 byte - int - Color Alpha
4 bytes - float - U
4 bytes - float - V
{IF Textured_2=1 in flags THEN}
4 bytes - float - U
4 bytes - float - V
{END IF}
{END ARRAY}

('''????????????''')
{ARRAY OF SIZE: unknow}
4 bytes - hex - 0xFFFFFFFF
{END ARRAY}

('''Normals''')
{IF Normals=1 in Flags THEN}
{ARRAY OF SIZE: Vertex Count*12 bytes}
4 bytes - float - Coordinate X
4 bytes - float - Coordinate Y
4 bytes - float - Coordinate Z
{END ARRAY}
{END IF}

('''????????????''')
{ARRAY OF SIZE: unknow}
4 bytes - hex - 0xFFFFFFFF
{END ARRAY}

== See also ==
* [[RenderWare_binary_stream_file|RW file format specification]]

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