Giter Club home page Giter Club logo

telltale-modding-group / dds-d3dtx-converter Goto Github PK

View Code? Open in Web Editor NEW
10.0 3.0 2.0 147.31 MB

This is an application designed for converting .d3dtx textures (Telltale Tool Textures), to standard .dds (Direct Draw Surface). It can also convert a .dds back into a .d3dtx for texture mods for a Telltale Tool Game.

License: MIT License

C# 99.94% Smalltalk 0.06%
texture converting-images telltale modding modding-tools modding-games texture-generation c-sharp

dds-d3dtx-converter's Introduction

Telltale Texture Mod Tool

GitHub release (latest by date)

Newer (Fork) Versions: Github All Releases

Older Versions: Github All Releases

Description

This is an application designed to preview and convert Telltale textures (files with the .d3dtx extension) to a more accessible format like DDS (Direct Draw Surface) and vice versa. There is also support for converting DDS to other image formats and back, although this is not recommended due to potential data loss. It works only on Windows.

DOWNLOAD THE LATEST VERSION HERE

Screenshots

Main 1

Getting started

If you have issues or questions, redirect them to the discord server.

Supported Games

  • The Walking Dead
  • The Walking Dead: Season Two
  • The Walking Dead: Michonne
  • The Walking Dead: A New Frontier
  • The Walking Dead: The Final Season
  • The Walking Dead: The Telltale Definitive Series
  • The Walking Dead Collection
  • Minecraft: Story Mode
  • Minecraft: Story Mode โ€“ Season Two
  • The Wolf Among Us
  • Tales from the Borderlands
  • Batman: The Telltale Series
  • Batman: The Enemy Within
  • Guardians of the Galaxy: The Telltale Series
  • Game of Thrones
  • Jurassic Park
  • Poker Knight 2
  • Back to the Future: The Game

Supported Texture Layouts

  • 2D Textures
  • Volume Textures
  • Cube Textures
  • 2D Array Textures
  • Cube Array Textures

Notes and Limitations

  1. This is primarily aimed for PC-platform games. In the future we may add Android/iOS support, but it's not guaranteed. More information can be found in the wiki.
  2. If you want support on other legacy titles, please open an issue.
  3. Older games do not support some texture layouts such as volumemaps or cubemaps. Please be cautious.
  4. Linux/MacOS are not supported even with Wine due to DirectXTexNet's mixed mode assembly.

Developers

Only for modders/developers who plan on forking/modifying/downloading the project.

There are 3 projects in this repository:

  • DDS_D3DTX_Converter_GUI is the currently-maintained application with a GUI built with Avalonia UI. It has the latest features and improvements. It also has a Debug CLI.
  • D3DTX_TextureConverter is a CLI app. It's older than DDS_D3DTX_Converter_GUI, which is not recommended to use. It can be still used for some of the latest Telltale games.
  • TextureMod_GUI is the original GUI application built with WPF (Mahapps). It is not recommended to use as it's extremely outdated.

We utilize DirectXTexNet, a .NET wrapper around DirectXTex, allowing us to work better with DDS files.

If you want to use the console applications, you can open their relative solutions in Visual Studio. It would require you to change the code to set some parameters.

If you want to learn about the D3DTX file format we suggest you looking in the DDS_D3DTX_Converter_GUI project at TelltaleD3DTX folder. The classes there are well documented and describe the D3DTX format. Preferably, start with D3DTX_V9.cs and go upwards. Direct Surface Draw (.dds) is a Microsoft file format, which is described in detail here. You can also check out in this folder the following classes:

  • DDS_HEADER.cs
  • DDS_HEADER_DX10.cs
  • DDS_PIXELFORMAT.cs

Credits

  • Thanks to David Matos for his original work on the old converter and its wikipedia.
  • Thanks to Ivan Panayotov for creating the new GUI, adding support for more games and possibly all textures from Back to the Future: The Game (2010) and onwards.
  • Thanks to Mawrak for their work on the original GUI application and its wiki, testing the software and providing critical feedback.
  • Thanks to Lucas Saragosa for figuring out the Telltale formats and for his help for parsing the D3DTX correctly for all supported games. His TelltaleToolLib project served as a reference, which had a lot of influence in the conversion process.
  • Thanks to Arrizble for creating a tutorial, testing the software on Minecraft: Story mode series and providing critical feedback.
  • Thanks to Knollad Knolladious for testing the software on Minecraft: Story mode series. Array textures support was added due to his discoveries.
  • Thanks to the DirectXTexNet's authors for providing an amazing wrapper.
  • Thanks to SVG Repo for their amazing GUI icons.

Current Developer Note

Special thanks to David for introducing me to the Telltale Modding Community and modding as a whole, and for being a good mentor along the way. Special thanks to Lucas for helping me add support for older games and made me understand the Telltale Tool Engine better.

dds-d3dtx-converter's People

Contributors

frostbone25 avatar imrshadow avatar lucassaragosa avatar mawrak avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

dds-d3dtx-converter's Issues

Cant launch application after installing .NET Core

After trying to launch it once it told me to install .NET core, then attempted to send me to the install site but didnt. Then I searched it up and installed it and after restarting and trying to launch again I got the same message did I install the right thing and it doesn't work? or did I install the wrong thing and It wont tell me how to install the proper thing?

GIMP DDS not supported.

Opening the extracted .dds textures in GIMP yields an "EOF" error.

EOF meaning End of File, trying again will usually yield in the internal DDS plugin crashing in GIMP.

Worth noting that the same exact error is reproduced as well when opening an extracted .dds texture from Telltale Explorer as well.

Unfortunately, this is not the fault of Texture Mod Tool or Telltale Explorer, GIMP recently started supporting .DDS images natively however they don't have all of the formats supported, so therefore it cannot open them. You will need to switch to an alternative software like Paint.NET or Photoshop with the Intel Texture Works Plugin.

no preview and crash

when I load the d3dtx files of back to the future (pc) then the program can't preview the textures and crashes on conversion of them.
the only thing I can do is load the folder with the files in it.

convert button greyed out DDS DXT5

Hey

I exported a lot of textures in DXT5 without any mipmaps just like the original ones from BTTF but the "convert to d3dtx" button is greyed out, the preview works tho.

no idea how to otherwise convert dds files into d3dtx

Converting to DDS hangs or crashes

When i try to convert my d3dtx i got from using telltale explorer, it crashes or hangs till i close it. The game i'm trying to use is Poker Night at the Inventory. I know it's not utilized for Poker Night but I just wanted to put that out there because this project looks cool :)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.