Difference between revisions of "RenderWare"

From GTAMods Wiki
Jump to navigation Jump to search
m (PS2 TXD)
Line 134: Line 134:
** [[Extension (RW Section)|Extension]]
** [[Extension (RW Section)|Extension]]
====PS2 TXD====
====PS2/PSP TXD====
* [[Texture Dictionary (RW Section)|Texture Dictionary]]
* [[Texture Dictionary (RW Section)|Texture Dictionary]]
** [[Struct (RW Section)#Texture_Dictionary|Struct]]
** [[Struct (RW Section)#Texture_Dictionary|Struct]]

Revision as of 16:24, 26 December 2015

Renderware (RW for short) is the graphics engine used by GTA III, Vice City and San Andreas. For general information see [1] and for a list of games using it [2].


The versions of Renderware the games are linked against are the following:

III Vice City San Andreas

Binary Streams

RW streams are split up into chunks. Each section has a 12 byte header and can either be empty, contain data or more child chunks. The content depends on the type and parent chunks.

uint32 - type
uint32 - size, including child chunks and/or data
uint32 - library ID stamp

The library ID stamp contains the version and build number of the RW library that wrote the file.

The library version is a hexadecimal number and has the form 0xVJNBB where V (3 bits) is the Renderware version, J (4 bits) is the major revision, N (4 bits) is the minor revision and B (6 bits) is the binary revision. Version for instance would be encoded as 0x36003.

The library build is 0xFFFF in all versions used by GTA.

To make the library ID stamp, 0x30000 is subtracted from the version first and then packed as follows (where D is the 16 bit build number):


Version 0x36003 build 0xFFFF for instance is encoded as 0x1803FFFF.

Version and before had no binary revision and build number and the library ID stamp was just 0x00000VJN (no 0x30000 subtracted). Version for instance would be encoded as 0x00000310. Version (used in some GTA III files, build FFFF) on the other hand is encoded as 0x0401FFFF. To find out what version a file has when reading, RW checks the upper 16 bits and assumes the old format when they're zero.

These C example functions pack and unpack library ID stamps:

libraryIDPack(RwUInt32 version, RwUInt32 build)
	if(version <= 0x31000)
		return version>>8;
	return (version-0x30000 & 0x3FF00) << 14 | (version & 0x3F) << 16 |
	       (build & 0xFFFF);

libraryIDUnpackVersion(RwUInt32 libid)
	if(libid & 0xFFFF0000)
		return (libid>>14 & 0x3FF00) + 0x30000 |
		       (libid>>16 & 0x3F);
	return libid<<8;

libraryIDUnpackBuild(RwUInt32 libid)
	if(libid & 0xFFFF0000)
		return libid & 0xFFFF;
	return 0;

Basic structure

The basic structure of DFF and TXD files is given below. The Extensions are given as empty, their contents depend on the plugins and plugin data of the object they belong to. These are described elsewhere.




* These chunks can appear multiple times. The count is usually given in the parent's struct.

See RenderWare binary stream file for further information.