Jesco Topp ( http://www.planetunreal.com/jtonline )
Andy Ford ( http://www.planetunreal.com/fordy )
Documentation (v2.2)
by Jesco Topp
I. Introduction
UTX-Viewer is a small program that enables you to generate previews of UT's textures and view them without having UnrealEd started or having to load the texture-packages into UnrealEd. It can also create .UTX packages.
It does this by reading the texture files directly without the need to extract to temporary locations. It also allows exporting of textures in JPEG or PCX or BMP formats and will display any selected texture tiled. AnimatedTextures are displayed in full animation. The full Delphi 3.0 source code is also included in the download.
This tool would not have been possible without the work of Antonio Cordero Balcazar, who cracked most parts of the Unreal-Package-Fileformat.
II. View Packages
You can change the preview folder by clicking on "Change Directory" (lower left) and selecting another folder.
The most left listbox shows all currently installed texture packages in the \Textures directory. Select one by left-clicking on it. The viewer now shows all textures in this package. You can scroll through them by using the scroll-bar on the right side of the previews. The listbox in the middle lets you select a specific internal group of the texture package.
You can search for texture packages using the Search option at the bottom of the window. Entering a text like "Nali" would bring up all packages with a Nali in their name, e.g. NaliCastle.utx and so on.
The package-info box shows the internal version number of the package (69 is the most current one, when using UnrealTournament), the number of internal groups (the [ALL] group is counted, too, although this group is not part of any package, this group is generated internally by the viewer), the total number of textures which can be previewed in this package and the size of the package.
By right-clicking on a specific texture you can
a) show a TiledPreview, so you can see if a texture is seamless or not,
b) show a fullsize preview of the texture (maximum preview size is 512*512, larger textures are scaled down),
c) export the texture to .BMP or .PCX or .JPG . (the textures will be exported to the default export-folder as specified in the "Preference"-Tab)
d) view detailed infos on the current texture (and full animation if it's an animated one) ny clicking on "Show Texture Details".
III. Texture Details
The "Texture Details"-Tab automatically shows the selected texture (from the "View"-Tab via right-click).
If you select an AnimatedTexture the app automatically shows the texture full-animated. Just make sure you select the first frame of the AnimatedTexture, otherwise you won't see the whole animation, but only a part of it. When available, the app uses the FrameRate settings from the texture, but if there's no such information it renders with 25 fps.
The preview window uses OpenGL to display the texture. If you experience significant slow-downs when previewing AnimatedTextures, this might be due to the fact that your video-card doesn't support OpenGL windowed-rendering. In this case the app uses the software emulation which is by nature slower than any hardware acceleration.
IV. Create Packages
On this tab you can create your own texture-packages without UnrealEd or even an Unreal Technology Game installed on your HD.
You'll first need to create an internal group, before you can add textures. so, just click on "Add Group" and enter or select a proper group-name. The package may contain up to 127 different groups. Each group may contain contain up to 127 textures ( = 161239 textures in the whole package ;-)
To add a texture, click on "Add Texture" and the following dialog will popup.
The texture you want to add MUST be a 8 bit palettized .PCX image. The size MUST be a power of two, e.g. 256*256 or 64*128. Otherwise, the app will produce an error. The dialog supports multi-select, so you can add more than one texture at once. Furthermore, you can decide whether to add a texture to the package without closing the dialog ("Add to package") or to close the dialog after adding the texture ("Add to package and close").
After closing the dialog, you can decide whether the texture should have mipmaps or not and whether it should be masked or not.
When you are satisfied with your package-selection, hit the "Save"-Button and specify a name for the new texture package. The UTX-Viewer displays a progress bar at the bottom of the window.
The "Reset"-Button resets all settings. In addition to this, you must hit the reset button after you've got an exception, for example because you've used an invalid texture.
IMPORTANT NOTICE
The package-writer is experimental. The textures created with the UTX-Viewer may differ from those created with UnrealEd from case to case. This is due to the fact that the package-file format is still undocumented in most parts.
USE THE PACKAGE-WRITER AT YOUR OWN RISK.
V. Misc
The viewer has been tested with Unreal1, UnrealTournament, Deus Ex and the RuneDemo. Other games are unsupported and therefore it can't be garantued that they will work, but they should work.
The package-reader, which is used to preview the texture-packages,
should work perfectly well with Unreal1, UnrealTournament, DeusEx and the RuneDemo.
Although other Unreal Technology Games are untested, they should work, too. Same applies to MODs.
At the current state of development, UTX-Viewer DOES NOT support FireTextures, ScriptedTextures, IceTextures, WetTextures and
WaveTextures. The compressed-textures from UT-CD #2 are unsupported, too. NormalTextures and NormalAnimatedTextures (read-only) are supported.
Some users reported problems when using Windows 2000 as Operating System. We can't check this, because neither Fordy not I have access to a Windows 2000 machine.
VI. Version History
Development of the UTX-Viewer started in August 2000.
2.2:
OpenGL-support
Full support for AnimatedTextures (via OpenGL), placed in the "Texture Details"-Tab
More detailed infos on textures
enhanced support for other Unreal Technology Games (no need for changing registry entries anymore)
2.0:
added a direct-package-writer, meaning that you can create texture-packages directly from within the app
added support for other Unreal Technology Games (Unreal1, DeusEx, RuneDemo)
optimized user-interface
1.0:
enhanced user-interface (search-option, help-text)
lots of bug-fixes
0.9b:
TiledPreview is working again
Full-Size preview of textures
much cleaner code & interfaces
bug-fixes (i.e. colour-bug)
0.9:
completely re-written
added a direct-package-reader, meaning that you don't need to pre-export the textures as the app can read the textures directly from within their packages. Scripted textures aren't supported at the moment, same applies to FireTextures and compressed textures. Animated textures are supported indirectly by previewing every keyframe like a single texture.
profile-support is broken in this version
TiledPreview is broken in this version
UTX-Viewer is .ZIP again (the filename of the .exe has changed, too, it's now UTPackage.exe)
0.7:
added 'TiledPreview'; helps you to check if a texture is seamless or not
added support for profiles; displays only those texture-packages which are in a specific profile, helps you to ensure that everybody has the packages to run your map
removed 'options.exe'; the app now detects if its started for the first time and displays a nice preference-dialog
slightly tweaked 1-click conversion
bug-fixing
0.6c:
re-designed User-Interface
added HTML-Preview
added 1-click conversion
0.6b:
fixed bugs where space in folder/filenames would cause ucc.exe to quit with an error
fixed "Update of Package List"; you don't need to specify the UTX-Viewer folder before the first start
Optimized size
UTX-Viewer is now UMOD
0.6:
first release
VII. Contact Information
Jesco Topp
initial idea
lead-coder, chief of the technical part
E-Mail: Jesco@planetunreal.com
Web: http://www.planetunreal.com/jtonline
Andy Ford
GUI coder
beta-tester
E-Mail: fordy@planetunreal.com
Web: http://www.planetunreal.com/fordy
UTX-Viewer 2.2 is (c) 2000-2001, Jesco Topp & Andy Ford
THIS PROGRAM IS PROVIDED UNDER THE GNU/GPL