History

drewcassidy f6201e87f2 Add option for normal map swizzling		2021-02-23 03:19:11 -08:00
..
color.py	DXT1 image parsing	2021-01-25 00:57:47 -08:00
dds.py	add DXT5 to DXT1 conversion tool	2021-01-25 21:17:59 -08:00
ddsck.py	add DXT5 to DXT1 conversion tool	2021-01-25 21:17:59 -08:00
ddscompress.py	Add option for normal map swizzling	2021-02-23 03:19:11 -08:00
ddsdecompress.py	more header parsing/writing work	2021-01-23 19:52:11 -08:00
dxt5to1.py	add DXT5 to DXT1 conversion tool	2021-01-25 21:17:59 -08:00
README.md	add more options for ddsck and ddscompress	2021-01-21 17:37:08 -08:00
s3tc.py	add DXT5 to DXT1 conversion tool	2021-01-25 21:17:59 -08:00

README.md

Scripts

Python scripts for interacting with files

Installation

All files require python3 to be installed.

ddscompress, ddsdecompress and ddsck require ImageMagick and Nvidia Texture Tools to be installed and available in your $PATH.

Usage

ddscompress.py

usage: ddscompress.py [-h] [--format {auto,DXT1,DXT5}] [--nomips] [--noflip] [--keep] [--convertcmd CMD] [--compresscmd CMD] [files ...]

Converts any number of files to .dds format, automatically choosing dxt1 or dxt5 depending on if the source image has anything in its alpha channel. Designed to be used with a glob, e.g: ddscompress.py *.png

positional arguments:

files: input texture files

optional arguments:

-h, --help : show this help message and exit
--format {auto,DXT1,DXT5}: output texture format (default: auto)
--nomips, -m: Do not generate mipmaps
--noflip, -f: Do not flip the image
--keep, -k: Do not delete originals
--convertcmd CMD: name of imagemagick's convert tool (default: convert)
--compresscmd CMD: name of the nvidia dds compress tool (default: nvcompress)

ddsdecompress.py

usage: ddsdecompress.py [-h] [--decompresscmd CMD] [files ...]

Converts any number of files to .tga from .dds. Designed to be used with a glob, e.g: ddsdecompress.py *.dds

positional arguments:

files: input dds files

optional arguments:

-h, --help: show this help message and exit
--decompresscmd CMD: name of the nvidia dds decompress tool (default: nvdecompress)

ddsck.py

usage: ddsck.py [-h] [--transparency | --format] [--convertcmd CMD] [--infocmd CMD] [files ...]

Checks any number of dds files for common issues, including formats not supported by KSP, and DXT5 textures that don't use the alpha channel. Designed to be used with a glob, e.g: ddsck.py *.dds

positional arguments:

files: input dds files

optional arguments:

-h, --help: show this help message and exit
--transparency, -t: Generate a list of files that fail the transparency check
--format, -f: Generate a list of files that fail the format check
--convertcmd CMD: name of imagemagick's convert tool (default: convert)
--infocmd CMD: name of the nvidia dds info tool (default: nvddsinfo)