About This File
texconv is a utility for creating textures for the SEGA Dreamcast hardware.
Requires Qt 5.2 or newer.
Supports all image formats supported by Qt.
At the time I'm writing this, these formats are supported:
Format Description Qt's support
BMP Windows Bitmap Read/write
GIF Graphic Interchange Format (optional) Read
JPG Joint Photographic Experts Group Read/write
JPEG Joint Photographic Experts Group Read/write
PNG Portable Network Graphics Read/write
PBM Portable Bitmap Read
PGM Portable Graymap Read
PPM Portable Pixmap Read/write
XBM X11 Bitmap Read/write
XPM X11 Pixmap Read/write
USAGE
=====
texconv --in <filename> --out <filename> --format <pixelformat> [flags...]
EXAMPLES
========
texconv --in img.jpg --out a.tex --format RGB565
Creates an RGB565 texture called 'a.tex' using 'img.jpg' as input.
texconv --in img.jpg --out a.tex --format PAL8BPP
Creates an 8-bit paletted texture called 'a.tex' using 'img.jpg' as input.
A palette file 'a.tex.pal' will also be created.
texconv --in img.jpg --out a.tex --format YUV422 --compress --mipmap
Creates a compressed, mipmapped YUV texture 'a.tex' using 'img.jpg' as
input.
texconv --in img1.jpg --in img2.png --format RGB565 --mipmap
Also assuming "img1.jpg" is 64x64 and 'img2.png' is 16x16, creates a
mipmapped RGB565 texture with mipmap levels like this:
64x64 - 'img1.jpg'
32x32 - 'img1.jpg' (downscaled)
16x16 - 'img2.png'
8x8 - 'img2.png' (downscaled)
4x4 - 'img2.png' (downscaled)
2x2 - 'img2.png' (downscaled)
1x1 - 'img2.png' (downscaled)
texconv --in img.jpg --out a.tex --format PAL4BPP --compress
--preview preview.png --vqcodeusage usage.png
Creates a compressed 4-bit paletted texture 'a.tex' using 'img.jpg' as
input. A palette file 'a.tex.pal' will also be created. A preview file
'preview.png' showing what the texture looks is generated as well as
an image 'usage.png' that visualizes codebook usage for 'a.tex'.