/FasTC

A fast texture compressor for various formats

Primary LanguageC++Apache License 2.0Apache-2.0

FasTC Build Status

A Fast Texture Compressor for a variety of formats. This compressor supports multi-threading via native Win32 threads on Windows and pthreads on other operating systems. It has been tested on Windows, OS X, and Ubuntu Linux.


Licensing:

FasTC is licensed under the Apache 2.0 license. The full license can be found online. There are additional pieces of FasTC that have been incorporated and made available graciously by their authors. Each of the corresponding pieces has their license at the top of their respective source files. These pieces include:

  1. ETC1 compressor provided by Rich Geldreich, under a ZLIB license.

  2. DXT compressor provided by Sean Barrett, in the public domain.

  3. Targa reader by Joshua S. English, under their own license.

  4. GTest as a test framework, under their own license

Additionally, the original work for this repository was done as an internship project at Intel, released under a permissive MIT-like license.

Requirements:

CMake (3.1)
libpng (1.5.13)
zlib (1.2.5)

Installation:

FasTC uses CMake to generate build files. The best way to do so is to create a separate build directory for compilation:

mkdir FasTC
cd FasTC
git clone https://github.com/Mokosha/FasTC.git src
mkdir build
cd build
cmake ../src -DCMAKE_BUILD_TYPE=Release
make

Once you do this you will be able to run some examples.

Using Visual Studio on Windows

Due to the C/C++ runtime requirements in Visual Studio, you must have a compiled version of each library that you wish to link to. In order to save time, I have uploaded various versions of libpng, and zlib to a submodule in the source directory. Before running the steps above, make sure to instantiate the submodule in git:

cd FasTC/src
git submodule init
git submodule update

This will download all of the Release versions of the necessary libraries (which means there will be linker warnings during the build process under the Debug configuration). I have compiled versions for Visual Studio 2008, 2010, and 2012.

Testing:

Once the compressor is built, you may test it against any images you wish as long as their dimensions are supported by the compression format and they are in the png file format. If you'd like to convert from one format to another, I suggest taking a look at ImageMagick

The quickest test will be to simply run the compressor on a PNG image:

cd FasTC/build
make
CLTool/tc path/to/image.png

This will compress image.png into the BPTC (BC7) format using 50 steps of simulated annealing without multithreading.

Input file format supported: PNG, PVR, TGA, KTX, ASTC

There are various run-time options available:

  • -v: Enabled verbosity, which reports Entropy, Mean Local Entropy, and MSSIM in addition to compression time and PSNR.
  • -f <fmt>: Specifies the format use for compression. fmt can be any one of the following:
  • -d: Specifies the output file. Format supported PNG, KTX
    • Default: <filename>-<fmt>.png
  • -nd: Suppress decompressed output.
  • -t: Specifies the number of threads to use for compression.
    • Default: 1
    • Formats: BPTC, ETC1, DXT1, DXT5
  • -l: Save an output log of various statistics during compression. This is mostly only useful for debugging.
    • Formats: BPTC
  • -q <num>: Use num steps of simulated annealing during each endpoint compression. Default is 50. Available only for BPTC.
    • Default: 50
    • Formats: BPTC
  • -n <num>: Perform num compressions in a row. This is good for testing metrics.
    • Default: 1
    • Formats: All
  • -a: Use a parallel algorithm that uses Fetch-And-Add and Test-And-Set to perform mutual exclusion and avoid synchronization primitives. This algorithm is very useful when compressing a list of textures. Cannot be used with the -j option.
    • Formats: BPTC
  • -j <num>: This specifies the number of blocks that the compressor will request to crunch per thread. If this flag is not specified or set to zero, the image will be split up so that each thread compresses an equal share. However, for many images, certain blocks compress faster than others, and you might want a more fine grained control over how to switch between compressing different blocks.
    • Formats: BPTC, ETC1, DXT1, DXT5

As an example, if I wanted to test compressing a texture using no simulated annealing, 4 threads, and 32 blocks per job, I would invoke the following command:

CLTool/tc -q 0 -t 4 -j 32 path/to/image.png

If I wanted to compress a texture with the default amount of simulated annealing 100 times using the parallel algorithm with atomic synchronization primitives, I would invoke the following command:

CLTool/tc -n 100 -a path/to/image.png

If I wanted to compress a texture into PVRTC, I would invoke the following command:

CLTool/tc -f PVRTC -d path/to/image.ktx path/to/image.png

[1] Compression code courtesy of Rich Geldreich
[2] Compression code courtesy of Sean Barrett.