Skip to content

FernandoS27/WhiteoutTex

Repository files navigation

WhiteoutTex

WhiteoutTex

A fast, lightweight texture viewer and converter for game assets — with optional AI upscaling.

Image Viewer

🖼️ More Screenshots

Texture Details


Batch Conversion


CASC Browser


Save Options


AI Upscaling


Features

  • Open & save textures: BLP, BMP, DDS, JPEG, PNG, TGA — plus read-only support for Blizzard TEX (Diablo III/IV).
  • Image viewer with zoom, pan, per-channel RGBA filtering, mip level selection, and auto-detection of normal maps and ORM textures.
  • Texture details — dimensions, pixel format, mip chain info, and automatic texture kind classification (Diffuse, Normal, ORM, etc.) with manual override.
  • Mipmap generation — one-click regeneration that respects texture kind (normal maps get renormalized, PBR textures keep correct properties).
  • Batch conversion — convert entire directories at once, multi-threaded, with per-format filters and per-kind DDS targeting.
  • CASC browser — open Blizzard game archives directly and browse/extract textures, including full Diablo IV TEX support.
  • Save options — format-specific settings (BLP encoding & dithering, DDS format, JPEG quality), mipmap generation on save, and preferences remembered across sessions.

AI Upscaling (Optional)

GPU-accelerated texture upscaling powered by Real-ESRGAN via Vulkan compute. Available models:

  • realesrgan-x4plus — general-purpose 4× upscale
  • realesrgan-x4plus-anime — anime/stylized 4× upscale
  • realesr-animevideov3 — 2×, 3×, or 4× upscale

Upscaling can be applied to individual textures or as part of a batch conversion pipeline. Requires building with WHITEOUT_ENABLE_UPSCALER=ON and a Vulkan SDK.


Building

Requires CMake and a C++23 compiler.

cmake -S . -B build
cmake --build build --config Release

For AI upscaling support (optional):

cmake -S . -B build -DWHITEOUT_ENABLE_UPSCALER=ON
cmake --build build --config Release

This requires the Vulkan SDK. Run scripts/download_models.ps1 to fetch the model files.


License

BSD 3-Clause — see LICENSE.md. An AI-Derived Works Notice applies to AI-generated code based on this software.

Third-Party Notices

Library License
Dear ImGui MIT
SDL3 zlib
WhiteoutLib See library license
CascLib MIT
Real-ESRGAN ncnn MIT (optional)

Full texts in THIRD_PARTY.md.

Disclaimer

This project is not affiliated with or endorsed by Blizzard Entertainment.

About

A simple tool for converting Blizzard Entertainment texture formats. Generates mipmaps and manages proper display and conversion.

Topics

Resources

License

BSD-3-Clause, Unknown licenses found

Licenses found

BSD-3-Clause
LICENSE.md
Unknown
LICENSE-AI.md

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages