RSE-Model/README.md

2.0 KiB

RogueSquadron Extractor - MODEL 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 'MODEL' module.

Build Status

MODEL MODULE

It's extract 3D rendering datas from Rogue Squadron 3D (PC) game models files (HOB).

This module can do:

  • Extract objects inside HOB files to Wavefront OBJ format,
  • Extract automatically inside subfolder (usefull when you have multiples objects to extract),
  • Multiple inputs files.

TODO

  • Add textures to models.
  • Discover all unknowns fields, animations, bones mesh, etc.

Using

RSEModel [options] <hob files...> or you can simply drag&drop HOB files on it.

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

Options

  • -h Print this message
  • -v,-vv Activate verbose/debug output mode respectively
  • -no-subdir Extract textures directly inside current folder
  • -mtl Export materials datas with OBJ model

Dependencies

Compiling

You can compile on both Windows (MinGW) or native Linux system thanks to CMake.

To compile, just clone (don't forget git submodules) and launch cmake:

cmake .
make
make install

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 \
	..
cmake --build .