Skip to content

ScanMountGoat/ultimate_tex

Repository files navigation

ultimate_tex GitHub release (latest by date including pre-releases)

Texture conversion utilities for Smash Ultimate. Report any bugs or request new features in issues.

ultimate_tex_tauri

image

A desktop application for batch converting texture files. Download the program in releases.

Drag files onto the application window or add them with File > Add File(s), select the export settings, select the export folder, and click the export button to convert. See the wiki for detailed usage instructions.

ultimate_tex_cli

A commandline program for converting a single texture file.

Examples

DDS:
cargo run -p ultimate_tex_cli --release -- cat.jpeg cat.dds --format BC1Srgb
cargo run -p ultimate_tex_cli --release -- cat.dds cat.tiff

Nutexb:
cargo run -p ultimate_tex_cli --release -- def_mario_001_col.nutexb img.dds
cargo run -p ultimate_tex_cli --release -- img.dds def_mario_001_col.nutexb --format BC7Srgb

Bntx:
cargo run -p ultimate_tex_cli --release -- chara_0_captain_01.bntx img.png
cargo run -p ultimate_tex_cli --release -- img.png chara_0_captain_01.bntx --format BC7Unorm --no-mipmaps

ultimate_tex

A library for conversion functionality shared between the GUI and CLI programs.

Building

With a newer version of the Rust toolchain installed, run cargo build --release. Don't forget the --release since debug builds in Rust will run slowly. The image_dds crate compiles C/C++ code for the encoders and decoders and requires C/C++ tooling installed. image_dds uses precompiled kernels for some image encoding operations, so not all platforms and architectures are supported.

The ultimate_tex_tauri application requires additional tools to build and run. See the getting started guide for details. The guide also covers installing necessary packages on Linux. The frontend uses Javascript and requires installing a newer version of npm. Run npm install once from the ultimate_tex_tauri directory to install the necessary Javascript packages. The easiest way to run the app locally is to install the tauri CLI tools with cargo install tauri-cli and then run cargo tauri dev also from the ultimate_tex_tauri directory.

Credits