v2.5.0

Summary

Another long awaited release has arrived! This update brings a lot of new features, improvements and bugfixes. For more information, read the changelog below, thank you.

State of the project

Before I start, I want to clear up some things. The latest official release on this repository was last year by Mawrak. So, how did we go from CLI Beta to v2.5.0?

I, iMrShadow, had started reworking the project on my fork from March, 2024. I mostly uploaded my work and posted the releases there, because I did not have access to the original repository. From time to time, I did some pull requests so that the project stays somewhat up-do-date and to make people aware that there is an actual working converter. However, this created some confusion to some people, because of the redirecting links, especially those who are unaware of what forks are. I am not even mentioning the wikipedia and the releases.

Fortunately the owner was kind enough to give me direct access, so these issue are gone. The wiki is already updated to the latest version too. Unfortunately, this also marks the last main release by me. You can find the reasons in the v2.5.0 release notes on my fork.

On the brighter side of things, my future efforts will focus on a new upcoming project: Telltale Script Editor 3, for which I hope to integrate this tool with its missing features. Stay tuned!

Help

The wikipedia is now fully implemented to the main repo.

Changelog

The converter is now known as Telltale Texture Tool (or for short - TTT)! D3DTX-DDS Converter sounded too technical and it is no longer valid.

New GUI:

Before	After

Main Window

• New top-bar menu
  • Moved the old top left buttons
  • Merged the help and about button in one menu button
• There are now 3 resizeable columns.
  • Left column is the standard file explorer with some minor tweaks. Additionally, the Date Modified column field is minimized by default. You can resize it.
  • Middle column is the Image Preview with mip and face sliders.
  • Right column contains expanders about image properties, advanced editing options, debug output and conversion menu.

Image Preview

• Added Pan and Zoom feature. Use the scroll wheel to zoom in/out and the left mouse button to drag the image.
• Added mip and face sliders. They automatically hide if there are no mips or faces presented, respectively. Very useful for cubemaps, arraymaps and volumemaps.

Right Column

Image Properties

• A couple of new fields were added, most notably texture layout and colour space.
• Removed channel count field. It did not always work. For compressed formats, it would be better to search them up in the documentation.
• Has Alpha has been renamed to Has Transparency.

Advanced Options

It contains:

• Combobox containing all games before and including The Walking Dead Season 1. It is used for legacy formats only.
• Legacy Console - if checked, older console textures can be read. The actual texture may be not be read.
• Auto Compression - if checked, the converter picks the suitable compression method based on
• Auto Normal Maps - if checked, the converter picks the suitable compression and effects to make normal maps work for Telltale Tool Engine.
• Enable Mipmaps - if checked, there will be 2 options: automatic and manual.
  • Automatic will generate the appropriate amount of mips
  • Manual - you can select the number of mips that will be generated.
• Enable Swizzling - if checked, there will be a combobox containing different platforms with 2 radio buttons - Swizzle and Deswizzle. These are used for textures from different platforms like PS3, PS4, Xbox 360 and Nintendo Switch.
• Enable Effects - if checked, there will be a combobox containing some effects, useful for normal maps.
• Create Normal Map - if checked, the texture will be converted to a normal map. Note: The quality is not good at the moment - it might be tweaked in the future.

Warning

These options apply only in the conversion process. They are not applied to the image itself!

Debug Information

• The contents from Debug Info button has been moved there. It makes it more consistent and more accessible.

Conversion Panel

• The Conversion Options has been split into 2 parts - From and To. It's more flexible and makes bulk conversion easier and more accessible.

Converter:

• Added Linux and (potentially) MacOS support.
• Added support for reading and writing for every single Telltale game.
• Added support for reading and writing console textures (PS3, PS4, Nintendo Switch, Xbox 360).
• Added support for reading mobile textures for newer games (iOS and Android).
• Added HDR and TGA support.
• Added support for direct conversion from D3DTX to PNG, JPEG, TGA, HDR, BMP and TIFF, and vice versa.
• Added a new message box which indicates if a bulk conversion was successful or not. (Thanks Mawrak!)
• JSON files now contain GameID and PlatformType fields. ConversionType field is no longer used, but left out for backwards compatibility. v2.3.0 JSON files are no longer supported, v2.4.0 JSON files could potentially break in some cases. Please report any issues!
• Removed the option from other file formats to DDS, the advanced options replace that functionality.

Bugfixes:

Warning

Because a lot of the UI has changed, bugs are expected.

Technical Improvements:

• Replaced DirectXTexNet with Hexa.NET.DirectXTex. (Thanks Juna Meinhold, main developer of Hexa Engine!)
• Removed Texconv dependency.
• Added DrSwizzler library, allowing support for console platforms.
• Added BCnEncoder.Net, allowing support for Android.
• Reorganized the whole project for better readability.
• Refactored a lot of classes and functions.
• Removed or archived a lot of unused code and files. The project should be a lot cleaner with less code.
• Bumped all dependencies to their latest versions.
• Removed ImageSharp, Pfim and LibTiff.Net libraries. They are replaced by SkiaSharp and DirectXTex/Hexa.NET.DirectxXTex.

All commits can be found here: iMrShadow/DDS-D3DTX-Converter@2.4.0...2.5.0

Installation

Download the respective zip file to your desired location. Extract the contents, open the folder, and run the file (it is a single executable). You require .NET 8.0 to run the application.

Note

Your computer's antivirus might detect the software as malware. This is a false-positive, as the software requires read/write access.

D3DTX Converter CLI Beta 2.0.1

Program has been updated to the latest version that fully supports D3DTX conversions without restrictions, with a command line interface. This is a beta release, as more versions of D3DTX will be supported, along with a proper UI that will be constructed in the future.

2.0.1 version: fixed missing framework issue

.NET 5.0.17 is required to run this program. Install "dotnet-runtime-5.0.17-win-x64.exe" before running the program.

Please check readme.txt before converting for additional information.

Please report any issues you find with this program.

DOWNLOAD ONLY "DDS-D3DTX-Converter-beta-UI-2.0.1.zip" and "dotnet-runtime-5.0.17-win-x64.exe", NOT THE SOURCE CODE.

D3DTX Converter CLI Beta

Program has been updated to the latest version that fully supports D3DTX conversions without restrictions, with a command line interface. This is a beta release, as more versions of D3DTX will be supported, along with a proper UI that will be constructed in the future.

Please check readme.txt before converting for additional information.

DOWNLOAD ONLY "DDS-D3DTX-Converter-beta-UI.zip", NOT THE SOURCE CODE.

First Release

Summary

First public release of the Texture Mod Tool application. This is an early build, so there a decent chance bugs/issues might be encountered. However, as of testing it I can't seem to run into any issues and it's rather stable.

Help

If you need any help with the application you can go here. If you want a tutorial you can go here. If you do happen to come across any bugs/issues please read this and it will guide you on how to report an issue to us.

Changelog

• First Release

Installation

Once it's installed, just simply drag the texmodtoolV100 to your desired location. Open the folder and run the TextureMod_GUI.exe.

DOWNLOAD ONLY "texmodtoolV100.zip", NOT THE SOURCE CODE.