TxdGen

From GTAMods Wiki
Revision as of 16:08, 1 January 2015 by The GTA (talk | contribs) (Configuration)
Jump to navigation Jump to search
TxdGen
Txdgen overview.png
Current version:0.7
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 all 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.

Features

  • Supports all PC TXD formats
  • Supports all known raster formats (RGBA, RGB, DXTn, 1555, 565, 4444, etc)
  • Outputs TXD in actually working PS2 and PC 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)

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
palRuntimeType=PNGQUANT
warningLevel=1

Description

  • gameRoot: directory where the TXDs, that should be converted, are located (needs trailing slash!)
  • 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)
  • palRuntimeType: decides the technique that should be used for palettization/compression; can be NATIVE or PNGQUANT
  • warningLevel: integer that toggles the warning throughput of the TXD parser (the higher the more warnings)

Credits

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

Source code

See the MTA:Eir repository for the source code.