BLP Converter

Summary

A command-line tool to convert BLP image files to PNG or TGA format. The BLP images are used by Blizzard games.

Supports the following BLP2 formats:

Uncompressed without alpha channel
Uncompressed with alpha channel (1-, 4-, and 8-bits)
Uncompressed raw BGRA (known as RAW3)
DXT1 without alpha channel
DXT1 with alpha channel (1-bit)
DXT3 with alpha channel (4- and 8-bits)
DXT5 with alpha channel (8-bit)

Works on Windows and Linux.

Compilation

xmake build
xmake install -o dist

The executable will be put in dist/bin.

Usage

(Copied from ./BLPConverter --help)

Convert BLP image files to PNG or TGA format
Usage: BLPConverter [OPTIONS] files...

Positionals:
  files TEXT ... REQUIRED     

Options:
  -h,--help                   Print this help message and exit
  -i,--infos                  Display informations about the BLP file(s) (no conversion)
  --rm                        Remove the original BLP file after conversion
  -o,--dest TEXT [./]         Folder where the converted image(s) must be written to
  -f,--format TEXT [png]      `png` or `tga`
  -m,--miplevel UINT [0]      The specific mip level to convert
  -j,--jobs UINT [...]        Number of parallel jobs

Dependencies

Dependencies are managed by xmake. xmake build will automatically download and install the dependencies.

License

BLPConverter is is made available under the MIT License. The text of the license is in the file LICENSE.

Under the MIT License you may use BLPConverter for any purpose you wish, without warranty, and modify it if you require, subject to one condition:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

In practice this means that whenever you distribute your application, whether as binary or as source code, you must include somewhere in your distribution the text in the file LICENSE. This might be in the printed documentation, as a file on delivered media, or even on the credits / acknowledgements of the runtime application itself; any of those would satisfy the requirement.

Even if the license doesn't require it, please consider to contribute your modifications back to the community.

CyanoHao / BLPConverter