Custom Texture Tool PS v44.0

**Bighead** · (This post was last modified: 10-29-2019, 10:59 AM by Bighead.)

Description / Download

This is a PowerShell script for Windows with a GUI that makes use of the command line options of several external programs, that can perform a variety of functions for custom textures. It can be used to convert images between PNG and DDS, and supports a wide range of DDS formats: BC1-BC7, RGBA, ARGB, L8, A8, and LA8. It has automatic mipmap handling which can be manipulated or disabled, it auto-repairs many issues found in DDS headers, and can seamlessly rescale textures and apply advanced upscale filters. It was designed for Dolphin emulator texture packs, so many of the core features revolve around Dolphin. Over time it has become powerful enough to manage many types of texture packs, and also edit phyre textures from The Legend of Heroes: Trails of Cold Steel I & II games. The tool has a built-in help menu that covers everything it can do in detail.

Download - Mirror - Changelog - Archive - Programs Pack

Preview: (Show Spoiler)

Installation and Setup

ImageMagick is the only hard requirement to get it up and running. The script has built-in documentation, which can be accessed by pressing the "Help" button.

Basic Installation Method: (Show Spoiler)

Full Installation Method: (Show Spoiler)

Supported DDS Programs

• ImageMagick - Default. Can create DXT1, DXT5, and ARGB8. Creates very low quality DXT1/DXT5 DDS textures. Uses magick.exe.
• DirectX TexConv - Can create DXT1, DXT5, BC7, and ARGB8. Lower quality DXT1/DXT5 textures, high quality BC7 textures. Uses texconv.exe.
• Compressonator - Can create DXT1, DXT5, BC7, and ARGB8. Highest quality BC7 textures. Fails creating some textures. Uses CompressonatorCLI.exe.

Note: The latest version of Compressonator has issues with this script. You must use v3.0.3707 or earlier or Compressonator will not work!

TexConv is required to create BC7 textures, use the script's Image Viewer, and convert BC7 textures to other formats. Compressonator is capable of these tasks, but randomly fails with some images.
If confused on which program to use, I suggest all of them. If a program fails to create a texture, it will fall back to another one and continue to do so until the image is created.

Other Supported Programs

• Ishiiruka Tool - Required to work with material map textures, and create them from materials.
• OptiPNG - Attempts to reduce the file size of PNG images.
• xBRZ ScalerTest - Allows upscaling textures with the xBRZ filter.
• Waifu2x-Caffe - Allows upscaling textures with waifu2x filter (nvidia cards required for full speed).
• Waifu2x-CPP - Not as powerful as waifu2x-caffe, but supports OpenCL (faster than using CPU for AMD users).
• Python v3.6.X - Multi-platform scripting language. Required to use ESRGAN and SFTGAN upscaling filters.
• ESRGAN - Enhanced Super-Resolution Generative Adversarial Networks.
• SFTGAN - Recovering Realistic Texture in Image Super-resolution by Deep Spatial Feature Transform.
• Kiseki PKG Tool - Allows extracting PKG files in The Legend of Heroes: Trails of Cold Steel I and II.

None of these programs are required to use the script, but they are needed to unlock the features they support.
Python, ESRGAN, and SFTGAN have an automatic installer built into the script, found on the Options menu on the Miscellaneous tab. - Image

Features

• Generate Dolphin Resource Packs.
• Convert textures between PNG, DDS, and JPG formats.
• Rescale all textures at a fixed integer scale as PNG, DDS, or JPG.
• DDS can be created with DXT1, DXT5, BC7, or uncompressed ARGB8.
• Check textures for a variety of issues (scaling factors, aspect ratios, etc.).
• Copy textures identified with issues to a folder for manual fixing.
• Auto-repair most textures that are identified with issues.
• Missing mipmaps are automatically generated when repairing/converting.
• Custom mipmaps can be provided or the script can be forced to generate new ones.
• The type of DDS mipmaps generated (internal/external) can be configured.
• Create material maps from color, bump, spec, nrm, and lum textures (required Ishiiruka Tool).
• Rescale/Convert already combined material maps (the generated nrm texture).
• Existing material maps and/or materials are automatically handled when found.
• Optimize PNG file sizes using OptiPNG. Can be written "in-place" or optionally output files to a folder.
• Apply various upscaling filters to all textures including xBRZ and Waifu2x.
• And much much more! Refer to the built-in "Help" button for more information.

Random Useful Links

This section links to certain pages or posts that explains some of the features of this script that have been added over time.

• Creating DDS textures with multiple compression types in a single run using compression flags.
• Error: no decode delegate for this image format 'PNG' (and the solution)
• Texture names used as watermarks to identify their location in-game.
• Creating Material Map textures for Dolphin Ishiiruka.
• Combining multiple images into a single image, or splitting an image.
• OptiPNG (and why it should only be used with this script for Dolphin textures).
• Down with the evil textures that have an indexed color palette.
• Weird Alpha in PNG Textures - And an option to manipulate it!
• Process Selected, the super secret option that nobody knows about.
• BC7 (BeCau7e why not?), auto-close xBRZ popups, +candy.
• The DDS Saga Part 1: I know almost nothing.
• The DDS Saga Part 2: Custom mipmaps for BC7!
• The DDS Saga Part 3: BC7 becomes a reality.
• The DDS Saga Part 4: Uncompressed DDS textures, hybrid DDS packs, and VRAM usage.
• Working with PHYRE images from The Legend of Heroes: Trails of Cold Steel I and II.

masterotaku · 03-25-2015, 10:51 PM #2

Thanks for this. I wanted to see how converting textures to DDS affects loading times, stuttering, quality and VRAM usage.

Gamedominator06 · (This post was last modified: 03-26-2015, 03:10 AM by Gamedominator06.)

I test converted some textures for Tales of Symphonia into DDS (testing the font to see if it improves the framerate) but it won't load up in the game. I tried isolating it and just loading the font textures and it still isn't working. Is there something I missed?

EDIT: Ignore this, just some pathing issues is all. I got it to work, but the textures are coming out with significantly reduced quality. Not sure if it's because of scaling or something else.

Spoiler: (Show Spoiler)

**StripTheSoul** · 03-26-2015, 03:22 AM #4

Nice, this might be used by all custom texture pack creators before releasing their pack.
Thanks for the hard work, BigHead!

Just one thing: Aren't internal mipmaps a problem when using Dolphin master?

**Bighead** · 03-26-2015, 04:52 AM #5

(03-26-2015, 02:19 AM)Gamedominator06 Wrote: EDIT: Ignore this, just some pathing issues is all. I got it to work, but the textures are coming out with significantly reduced quality. Not sure if it's because of scaling or something else.

This pack seems to use very small scaling values which is not something I took into consideration. An option to disable DDS auto-correct may help this. I'll look into it later tonight.

(03-26-2015, 03:22 AM)StripTheSoul Wrote: Just one thing: Aren't internal mipmaps a problem when using Dolphin master?

I don't think so as long as external maps are provided too. I tested the generated DDS textures for BrunoFBK's environments in both master and ishiiruka and the dynamic mipmaps were showing up. I think master just ignores the lower levels.

**frozenwings** · (This post was last modified: 03-26-2015, 04:58 AM by frozenwings.)

Edit: Lol, Bighead beat me to the punch. Oh well.

(03-26-2015, 02:19 AM)Gamedominator06 Wrote: EDIT: Ignore this, just some pathing issues is all. I got it to work, but the textures are coming out with significantly reduced quality. Not sure if it's because of scaling or something else.

It's because those retextures are very small. For example, the default sizes for the font are 24x24, and the retextures are 32x32. That's a 1.5x increase in resolution, where you normally want a 3-4x increase to maintain good quality at modern resolutions and to maintain whole integer scaling. As a result of this slight increase most of the scaling in the textures in the pack are bad (you would want the font textures to be 48x48 at least) and since theres is only a small increase in size, they are scaled to the closest non-broken scaling. Which just so happens to be the default size of the texture in many cases :p. Besides scaling, the DDS conversion also scales the texture so that it isn't broken in terms of DDS.

Basically, I don't think the tool was created with such a small scaling increase in mind. To get it to work with this pack, Bighead will have to make a couple changes and/or an option for converting to DDS without scaling. Mind you, the textures will still have bad aspect ratios unless he can figure out a way to only upscale instead of downscale. I've tested his script a ton while he's been working on it, so I'm pretty familiar with how it works. But obviously he would know best at what is possible and what isn't.

(03-26-2015, 03:22 AM)StripTheSoul Wrote: Just one thing: Aren't internal mipmaps a problem when using Dolphin master?

This is probably the thing that came up most while I was testing out Bighead's many (:p) incarnations of this script. Basically, there isn't really a problem as much as there are extra textures based on which Dolphin you're using. Ishiiruka should use the internal mipmaps and ignore external mipmaps, and master should ignore internal mipmaps and use external. I'm not sure if Bighead and I ever came to a conclusion about the excess files, but it's his script. From my understanding, this setup is future-proofing the tool against the possibility of master utilizing internal mipmaps. The end result is that the main mipmap file is around 25-30% larger in most cases due to the internal mipmap, and Dolphin should take care of the rest.

I'm not sure if it's possible (or efficient) to include an option to decide between internal or external mipmaps.

Gamedominator06 · (This post was last modified: 03-26-2015, 05:14 AM by Gamedominator06.)

Thanks for the responses. Part of my interest in trying DDS exclusively with the font is due to a game/emulation-specific issue that causes a ton of slowdown when using the font textures for Tales of Symphonia (at least when there's a lot of them). This also the reason why those textures are as small as they are. I'm curious to see if it can be improved to some degree before considering code-based problems. I figure the aspect ratio would play a part into it, but funny enough they were upscaled to 48x48 instead of downscaled (but it clearly wasn't friendly on the quality). I'd like to fix it but I don't currently have the means to do so and the thread isn't very active either. If disabling DDS auto-correct helps to a good degree, that would be excellent.

**frozenwings** · (This post was last modified: 03-26-2015, 05:35 AM by frozenwings.)

Interesting. I ran the conversion tool on the pack and it converted the fonts from 32x32 back to 24x24 (when converting PNG to DDS)

You can actually adjust the scaling by editing the tool, but DDS still converts them down in some cases. For example the controllers end up at 48x48 instead of 72x72.

Gamedominator06 · 03-26-2015, 06:06 AM #9

I was only able to view the converted images through ImageMagick (only tool I have on hand for that format) and I couldn't really find the dimensions that easily. I could be wrong and it was downscaling in the first place. Either way, the results aren't desirable and it may just be a core issue with the modified textures.

And that's curious. You're talking about the button textures right? They're at 64x64 in the pack.

**frozenwings** · (This post was last modified: 03-26-2015, 11:49 AM by frozenwings.)

The controller buttons are 64x64 in the pack, however the base textures are 24x24. That ends up being like a 2.66x scaling, and Dolphin works a lot better with whole integers. So ideally, we'd bump it up to 3x because 2x would lose quality. The texture tool is made with this in mind, and the repair function automatically adjusts the scaling of the textures to be whole. Basically, 64x64 is not a valid retexture size of 24x24, we would want 72x72.

Actually messing around with the tool, I was able to repair the textures to proper scaling and then in a (separate process) convert them to DDS without any funky scaling. Scaling the textures actually fixed some of the weird white glow effect outside of the text borders (a result of improper scaling, probably), you can see it in the compare shot below (check out the top of the e and o textures in the "PNG - Default Retextures" vs. "PNG - Scaling Fix"). But converting to DDS from the PNG actually does cause a little bit of quality loss in the text, even when the textures are all the same dimensions. I don't know why this happens, possibly because they are too small. I did not notice this loss in the Xenoblade pack text. It looks like the portraits and other textures are not nearly as effected as the text.

Spoiler: (Show Spoiler)

Anyway, if you're interested, here are the packs I used. IMO the rescaled PNG textures look a lot better. I manually converted the pound/hashtag texture since it doesn't use the new hash and the tool can't recognize it.

Download

Edit: Also, this screenshots were on my 1440p monitor so they might actually look better at 1080p.