Skip to content
forked from GammaUNC/FasTC

A fast texture compressor for various formats

Notifications You must be signed in to change notification settings

iainmerrick/FasTC

 
 

Repository files navigation

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.


Requirements:

CMake (2.8.8)
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 SIMD optimization or multithreading.

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 decompressed output file.
    • 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 path/to/image.png

[1] Compression code courtesy of Rich Geldreich
[2] Compression code courtesy of Intel. The idea implemented in this compressor was originally designed by J. M. P. Van Waveren

About

A fast texture compressor for various formats

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 87.9%
  • Python 7.0%
  • CMake 2.5%
  • C 1.3%
  • M4 0.5%
  • Shell 0.4%
  • Makefile 0.4%