Skip to content

panzi/VTFLib

Repository files navigation

VTFLib

This is a Linux port of VTFLib.

Setup

git clone https://github.com/panzi/VTFLib.git
mkdir VTFLib/build
cd VTFLib/build
cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr
make -j`nproc`
sudo make install

You may use the cmake option -DUSE_LIBTXC_DXTN=ON/OFF to enable/disable support for writing S3TC compressed textures.

Missing Features

There are several features that aren't currently supported by the Linux version because they depend on a legacy Windows library (nvDXTLib). Such features are:

  • genratig mipmaps
  • resizing textures and generating thumbnails
  • generating normal maps/normal map conversion

However, all read-only features are supported.

Dependencies

  • libtxc_dxtn for writing S3TC compressed textures (optional).
Installation

From https://askubuntu.com/questions/1033209/libtxc-dxtn-libtxc-dxtni386-not-found-in-ppa-18-04-bionic#1047591

# required stuff
sudo apt-get install mesa-common-dev
# get source files
cd ~/
wget https://people.freedesktop.org/~cbrill/libtxc_dxtn/libtxc_dxtn-1.0.1.tar.gz
tar xvfz libtxc_dxtn-1.0.1.tar.gz
cd libtxc_dxtn-1.0.1
# start the job
./configure
make
sudo make install
# clean up sources (optional)
cd ..
rm -rf libtxc_dxtn-1.0.1 libtxc_dxtn-1.0.1.tar.gz

Documentation

Doxygen API Reference

Projects Using VTFLib for Linux

License

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.