RogueSquadron Extractor - TEXTURE module

Inspired by the work of dpethes (https://github.com/dpethes/rerogue) 👏

This set of git repos are a compilation of tools coded in C to make RS modding far more than a dream! The collection consist of few independants modules, each of them deals with specific data like sound, textures, heightmaps, etc...

All modules are independants. This is the 'TEXTURE' module.

TEXTURE MODULE

It's extract texture datas from Rogue Squadron 3D (PC) game textures files (HMT).

This module can do:

• Extract textures inside HMT files to PNG format,
• Extract automatically inside subfolder (usefull when you have a lot of pictures to extract),
• Multiple inputs files,
• Manage transparent textures,
• Fixed some errored RGB color encoding.

TODO

• Discover all last unknowns fields, etc.

Using

RSETexture [options] <hmt files...> or you can simply drag&drop hmt files on it.

A futur main program can extract all HMT files directly from DAT file. Due to issue with copyrights, I can't provide samples... You need to extract HMT files yourself.

Options

• -h Print this message
• -v,-vv Activate verbose/debug output mode respectively
• -no-subdir Extract textures directly inside current folder

Dependencies

Necessary libs (provided only in windows release) for running and for compiling.

• libpng (1.6.37)

Compiling

You can compile on both Windows (MinGW) or native Linux system thanks to CMake, you only need to adjust your dependencies on Windows or use Conan packages manager (https://conan.io). libpng16-dev distrib package can be used on debian/ubuntu.

To compile, just clone and launch cmake:

cmake .
make
make install

On Windows system, I can suggest you to use Conan support to help you with dependencies:

mkdir build
cd build
conan install .. --build=libpng --build=zlib
cmake .. -G "MinGW Makefiles"
make

If you want to do it manually without Conan support, you will probably need to specify the dependency flags for CMake. Ex:

cmake.exe -D"ZLIB_INCLUDE_DIR=zlib/1.2.11/include" -D"ZLIB_LIBRARY=zlib/1.2.11/lib/libzlib.dll.a" -D"PNG_PNG_INCLUDE_DIR=libpng/1.6.37/include" -D"PNG_LIBRARY=libpng/1.6.37/lib/libpng.dll.a" . -G "MinGW Makefiles"

We can also use cross-compilation (after installing mingw64 and cmake packages on your distrib):

mkdir build && cd build
cmake -DGNU_HOST=x86_64-w64-mingw32 \
	-DCMAKE_TOOLCHAIN_FILE=../mingw_cross_toolchain.cmake \
	-D"ZLIB_INCLUDE_DIR=zlib/1.2.11/include" \
	-D"ZLIB_LIBRARY=zlib/1.2.11/lib/libzlib.dll.a" \
	-D"PNG_PNG_INCLUDE_DIR=libpng/1.6.37/include" \
	-D"PNG_LIBRARY=libpng/1.6.37/lib/libpng.dll.a" \
	..
cmake --build .