Difference between revisions of "TxdGen"

From GTAMods Wiki
Jump to navigation Jump to search
(new TxdGen version)
m (added release information and some media.)
Line 12: Line 12:
  
 
[http://www.gtagarage.com/mods/show.php?id=26916 Release Page on GTAGarage].
 
[http://www.gtagarage.com/mods/show.php?id=26916 Release Page on GTAGarage].
 +
 +
[http://gtaforums.com/topic/764498-relopensrc-txdgen-rw-texture-converter/ GTAForums thread].
  
 
==Features==
 
==Features==
Line 26: Line 28:
 
==Tutorials==
 
==Tutorials==
 
* [[TxdGen/Converting_Textures_to_PS2_Format|Converting Textures to PS2 Format]]
 
* [[TxdGen/Converting_Textures_to_PS2_Format|Converting Textures to PS2 Format]]
 +
 +
==Media==
 +
* [https://www.youtube.com/watch?v=zkHkgO-lZio Video tutorial on how to generate PS2 textures]
 +
* [https://www.youtube.com/watch?v=YoBace396fs Showing off 'SanAndreas Retextured 3' on PS2 hardware]
  
 
==Configuration==
 
==Configuration==

Revision as of 18:49, 29 January 2015

TxdGen
Txdgen overview.png
Current version:0.8
Developed by:Martin Turski (The_GTA)
Type:Texture Dictionary generator

TxdGen is the RenderWare texture dictionary conversion tool. It supports all PC formats, has full support for many PS2 titles and has partial support for the XBOX titles. It scans for TXD files in a source directory and converts them into a desired format into a target directory.

The supported games are GTA III, Vice City and San Andreas.

Release Page on GTAGarage.

GTAForums thread.

Features

  • Supports all PC TXD formats
  • Supports all known raster formats (RGBA, RGB, DXTn, 1555, 565, 4444, etc)
  • Outputs TXD in actually working PS2, PC and XBOX format
  • Lossless conversion between formats!
  • User-friendly configuration file!
  • Texture compression on demand!
  • Debug output on common errors
  • Automatic processing of IMG archives (version 1 and 2)
  • DXTn compression!

Tutorials

Media

Configuration

The conversion parameters are specified in the txdgen.ini file. It can look like this...

[Main]
gameRoot=C:/Program Files (x86)/Rockstar Games/GTA San Andreas/
outputRoot=txdgen_out/
targetVersion=SA
targetPlatform=PS2
compressTextures=true
compressionQuality=0.5
palRuntimeType=PNGQUANT
dxtRuntimeType=SQUISH
warningLevel=1
reconstructIMGArchives=true
fixIncompatibleRasters=true
dxtPackedDecompression=false

Description

  • gameRoot: directory where the TXDs, that should be converted, are located (needs trailing slash!); make sure it exists
  • outputRoot: directory where the new TXDs should be put into (needs trailing slash!)
  • targetVersion: can be GTA3, VC or SA (self explanatory)
  • targetPlatform: can be PC, PS2 or (WIP) XBOX
  • compressTextures: decides whether textures should be compressed if they are not already (to save memory and disk space)
  • compressionQuality: floating point (0..1) that toggles the quality for compression/optimization (only effective if compressTextures=true)
  • palRuntimeType: decides the technique that should be used for palettization/compression; can be NATIVE or PNGQUANT
  • dxtRuntimeType: chooses between NATIVE or SQUISH S3TC compression algorithms
  • warningLevel: integer that toggles the warning throughput of the TXD parser (the higher the more warnings)
  • reconstructIMGArchives: boolean which decides whether IMG archives should be reconstructed in the target directory
  • fixIncompatibleRasters: if this parameter is true then TxdGen attempts to change raster parameters to prevent game engine crashes
  • dxtPackedDecompression: if true, then rwtools will pack decompressed DXT texels in a close approximate raster format to prefer small size over quality

TODO

  • Improve palettization rating function for better quality (PS2)
  • Fix some XBOX swizzling errors

Credits

The licenses (if present) should be bundled with the tool.

Source code

See the MTA:Eir repository for the source code.