TexResizer - User Guide

 

Revision date: january the 24th, 2010

 

 

TexResizer is a standalone all-in-one .tex files editing tool.

 

 

The way it works

TexResizer needs from you to select a source GP4 .tex file (These files are mostly in .wad files and you will need a tool like WadUpdater or EasyWad to extract them). You can then change textures stored in this file and once you're ready, click on "Save .tex file" button to save your modified .tex file.

 

 

Interface Description

Top-left field let you browse on your hard drive for the .tex file you wish to edit.

 

Once a .tex file has been seleted, panel below will give you textures properties :

- Format : DXT Format. TexResizer only read and save DXT1 (opaque or semi transparency) and DXT5 (any transparency) formats.

- Transparency : DXT1 textures can use no transparency or semi (1bit) transparency when DXT5 can use all transparency settings as shown below :
Format Size Note
DXT1 - No transparency Smallest of all formats Best choice for full opaque textures (land, plain adverts)
DXT1 - Semi-transparency Smallest semi-transparent format Best choice for semi-opaque textures (avoid back to front objects caused by DXT5 full transparency but do not allow glasses effects)
DXT5 - No transparency 2 times bigger than DXT1 - No transp. rather use DXT1 - No transparency instead
DXT5 - Semi-transparency 2 times bigger than DXT1 - Semi-transp. ratehr use DXT1 - Semi-transparency instead
DXT5 - Full transparency Biggest of all formats Must be reserved to textures that really needs a full blend transparency. Could cause objects behind texture to be displayed in front of it.

 

As you can see, DXT1 textures should be privilegied choices for opaque or semi-transparent textures (each pixel is either fully opaque or fully transparent).

DXT5 textures are only needed for special uses to have full transparency support. Basically, DXT5 is used for fences as it gives a more smooth aspect when texture is seen from distant point than DXT1 that could glitter with distance.

As told in the notes, you should be careful with DXT5 - Full tranparent textures because when GP4 encounters 2 textures having this format one behind the other, it could result in weird vision effects where the texture behind the other become in front of it...

- Lods count displays the number of textures stored in the TEX file.

 

- Width and Height max sizes. These are sizes of the biggest texture stored in the .tex file. With TexResizer, loading a new tga file to replace biggest texture will automatically change these values but if you encounter a trouble, you can force a new size from these boxes. Note that textures must have power of two width and height sizes.

  

- Associate .tex files will register TexResizer as the application linked to .tex files. Once done, you can double-click on any .tex file and it will be opened with TexResizer. Note that you can remove this association if you click again on this button.

- "Save .tex file" button completes your edition saving the modified .tex file and the small panel below this button is simply a short status panel.

 

 

4 Textures Preview

4 square areas are there to display previews of the textures stored in the .tex files. If real texture is bigger than the area, you can see it in full size with a single click on one of the preview textures. Click again in the fullsize preview to close the preview window.

- Show Alpha layer switch between RGB and Alpha (transparency mask) layers display.

 

Context Menu

Right clicking on a texture preview gives you a ot of fonctionnalities :

- Downsample : quickly create 3 smallest textures from biggest one. New textures are filtered for best quality using Lanczos3 filter.

- Load from .tga lets you select a new .tga image to replace the current texture. If you replace biggest texture by a new texture having a different size, max width and height in texture properties will be automatically updated.

- Load all 4 .tga files replaces all 4 textures from 4 .tga files you previously made. The only rule is that names of the 4 textures should end with 0,1,2 and 3. For example, you can use tga named NewTex0.tga, NewTex1.tga, NewTex2.tga and NewTex3.tga. Once you clicked on this button, you just need to select the first file (ending with 0.tga) and all 4 files will be loaded.

- Save to .tga lets you save the choosen texture to a .tga file

- Save all 4 .tga files will simply save the 4 textures to .tga files

 

- Batch .tex to .tga will convert all .tex files that are in the same folder as your selected .tex file in .tga files. The browsing window ask you the name of the new folder to create that will store all the .tga files. Note: you can't convert files in an existing folder, you need to create a new folder each time (or delete old folder before).

- Batch .tga to .tex will update all .tex files that are in the same folder as the seleted .tex file from .tga files. After the warning message, you are asked to select a .tga file. Once done, TexResizer will compare names of the .tga files in the same folder as the selected single tga file with those of .tex files. If names match, TexResizer will load .tga image to replace biggest texture, will create lower textures (downsample) and will save .tex file over the original one for every .tex file.

Beware: Even if I believe I finally fixed this problem, I encountered several errors in my tests when batch converting tga to tex files. Tga files do not encounter any risk but tex files can, so to prevent any tex file corruption in case of error, it would be advisable to make a copy of the folder storing all tex files to update before anything. Sorry for the inconvenience.

 

 

Latest words

 

I tried to gather all the best of previous existing tools in TexResizer, so I hope it will fulfil all your .tex editing needs :)

 

Lo2k