GetTex Setup
For Client-Only Setups
In your game directory, create a folder called Data if it does not already exist. Inside this folder, create a folder called src, and inside that a folder called texture_library.
Place GetTex.exe in the game directory (next to ouroboros.exe), then either run it from the command line, or create a shortcut or batch file with the following command line:
GetTex.exe ./data/src/texture_library
For Bin Servers
In the bin server data directory (/data not /localdata or /serverdata), create a folder called src, and inside that a folder called texture_library.
Place GetTex.exe in the bin server directory (next to mapserver.exe), then either run it from the command line, or create a shortcut or batch file with the following command line:
GetTex.exe ./data/src/texture_library
Texture Filenames
Every texture file must have a unique filename. As far as the game is concerned, the directory structure doesn't matter, so data/texture_library/mytexture.texture and data/texture_library/coolstuff/mytexture.texture are considered to have the same filename - this will generate a duplicate texture error on game load. This is a non-fatal error, however the behaviour of the client in this situation is unknown, as it will load one or the other but not both.
Although the game doesn't use the directories, they *are* checked. A texture must not be moved or renamed after it is created, as the texture's location is stored inside the header, and will hard-kill the client on loading if it does not match. This is part of the texture library's built in validation checks. If you must move a texture, delete it, move the base TGA file (including removing it's cached DDS), and regenerate it, this ensures the integrity of the texture library is maintained.
Texture Options
These control how the texture is rendered. Certain texture options will be automatically set based on the filename, and others will be read from tricks.bin (or the loose files on a binserver). If you need to set specific texture options, you can make a trick file with them before converting.
Todo: explain the auto-options and how to set them manually in a trick
Converting Textures
Inside /data/src/texture_library, place your TGA file in the directory structure you wish it to reside in.
Run gettex, using either the command line or your batch file/shortcut. It will pop up a box which you can either click Accept, or let it time out. It will then proceed to process each TGA file and convert it into a .texture file. The texture files will be placed into /data/texture_library in the same directory structure as they were in /data/src/texture_library.
GetTex keeps track of which files it has converted, and will only process new or changed TGA files after the first run. If you delete a TGA file, GetTex may continue regenerating the texture file as it keeps a DDS cache.
Errors
Todo: explain how to fix the hundred and one errors GetTex normally spits out.