TILECONV

This tool allows you to compress or decompress TIS and MOS files provided by Infinity Engine games such as Baldur's Gate or Icewind Dale. The tool uses modern compression algorithms to achieve great compression ratios without noticeable degradation in quality.

Supported conversions:

• TIS files will be automatically compressed into the TBC format.
• TBC files will be automatically decompressed into the TIS format.
• MOS files will be automatically compressed into the MBC format.
• MBC files will be automatically decompressed into the MOS format.
• MOZ files will be automatically decompressed into the MOS format.
• TIZ files will be automatically decompressed into the TIS format.

A detailed description of the TBC and MBC formats can be found in FORMATS.

USAGE

Usage: tileconv [options] infile [infile2 [...]]

Options:
  -e          Do not halt on errors.
  -s          Be silent.
  -v          Be verbose.
  -t type     Select pixel encoding type.
              Supported types:
                0: No pixel encoding
                1: BC1/DXT1 (Default)
                2: BC2/DXT3
                3: BC3/DXT5
  -u          Do not apply tile compression.
  -o output   Select output file or folder.
              (Note: Output file works only with single input file!)
  -z          Decode MBC/MOZ into compressed MOS (MOSC).
  -q Dec[Enc] Set quality levels for decoding and, optionally, encoding.
              Supported levels: 0..9 (Defaults: 4 for decoding, 9 for encoding)
              (0=fast and lower quality, 9=slow and higher quality)
              Specify both levels as a single argument. First digit indicates
              decoding quality and second digit indicates encoding quality.
              Specify '-' as placeholder for default levels.
              Example 1: -q 27 (decoding level: 2, encoding level: 7)
              Example 2: -q -7 (default decoding level, encoding level: 7)
              Example 3: -q 2  (decoding level: 2, default encoding level)
              Applied level-dependent features for encoding (DXTn only):
                  Iterative cluster fit:   levels 7 to 9
                  Single cluster fit:      levels 3 to 6
                  Range fit:               levels 0 to 2
                  Weight color by alpha:   levels 5 to 9
              Applied level-dependent features for decoding:
                  Dithering:               levels 5 to 9
                  Posterization:           levels 0 to 2
                  Additional techniques:   levels 4 to 9
  -j num      Number of parallel jobs to speed up the conversion process.
              Valid numbers: 0 (autodetect), 1..256 (Default: 0)
  -T          Treat unrecognized input files as headerless TIS.
  -I          Show file information and exit.
  -V          Print version number and exit.

Supported input file types: TIS, MOS, TBC, MBC, TIZ, MOZ
Note: You can mix and match input files of each supported type.

LICENSE

tileconv is distributed under the terms and conditions of the MIT license. This license is specified at the top of each source file and must be preserved in its entirety.

BUILDING TILECONV

Dependencies:

• zlib (http://www.zlib.net/)
• libsquish (https://code.google.com/p/libsquish/)
• pngquant (https://github.com/pornel/pngquant/)
• libjpeg-turbo (http://libjpeg-turbo.virtualgl.org/)

External libraries and include files are assumed to be located in the subfolders "zlib", "squish", "pngquant" and "jpeg-turbo". The libraries are providing their own instructions how to compile them. libjpeg-turbo has to be compiled with the v8 API/ABI. Afterwards call "make" to build tileconv. Note: You'll need a compiler that supports the C++11 standard.

If you want to change paths for the external libraries or include files, you can do so by modifying the file "config.mk" by hand.

CONTACT

If you have questions or comments please post them on Spellhold Studios or contact me (Argent77) by private message on the same forum.