Packfile Explorer 3.9

Created by Czud. Mirrored here for archival purposes.

NO WARRANTY
===========

Because the program is licensed free of charge, there is no warranty for the program,
to the extent permitted by applicable law. Except when otherwise stated in writing
the copyright holders and/or other parties provide the program "as is"
without warranty of any kind, either expressed or implied, including, but not limited to,
the implied warranties of merchantability and fitness for a particular purpose.

The entire risk as to the quality and performance of the program is with you.
Should the program prove defective, you assume the cost of all necessary servicing,
repair or correction.

In no event unless required by applicable law or agreed to in writing will any copyright
holder, or any other party who may redistribute the program as permitted above, be liable
to you for damages, including any general, special, incidental or consequential damages
arising out of the use or inability to use the program (including but not limited to loss
of data or data being rendered inaccurate or losses sustained by you or third parties or
a failure of the program to operate with any other programs), even if such holder or
other party has been advised of the possibility of such damages.

CREDITS
=======

This program uses :
ZLib - Jean-loup Gailly and Mark Adler.
LibPNG - Glenn Randers-Pehrson.
LibJPEG - Thomas G. Lane.

Special thanks for file format documentation by :
Rof - Source Engine BSP format.
Ryan Gregg - Steam GCF file format.
Nico Bendlin - Gothic3 PAK file format specs.
Antonio Cordero Balcazar - Unreal engine package format.

CURRENT STATUS
==============

Game Textures Maps Rigid Mesh Skinned Mesh Animation Audio

BloodRayne 2 75% 0% 0% 0% 0% 75%
Dark Messiah 90% 50% 0% 0% 0% 90%
Doom3 90% 0% 50% 75% 90% 0%
Fury 0% 0% 0% 0% 0% 0%
Gears Of War 0% 0% 0% 0% 0% 0%
Gothic 3 90% 0% 0% 0% 0% 0%
Half Life 2 90% 33% 0% 0% 0% 90%
HL2 Episode 1 90% 50% 0% 0% 0% 90%
HL2 Episode 2 90% 50% 0% 0% 0% 90%
Legend Hand Of God 95% 0% 0% 0% 0% 90%
Lost Coast 90% 50% 0% 0% 0% 90%
Never Winter II 90% 0% 0% 0% 0% 0%
Mass Effect 0% 0% 0% 0% 0% 0%
Oblivion 90% 0% 0% 0% 0% 75%
Portal 90% 50% 0% 0% 0% 90%
Prey 90% 0% 50% 85% 90% 25%
Quake4 90% 0% 50% 75% 90% 0%
Team Fortress 2 90% 50% 0% 0% 0% 90%
The Witcher 90% 0% 0% 0% 0% 50%
Unreal Tournament 3 0% 0% 0% 0% 0% 0%
VTM Bloodlines 90% 85% 90% 85% 75% 90%
VTM Redemption 95% 0% 90% 33% 0% 90%

Image Supported Formats

BMP - 4 Bit Palette, 8 Bit Palette, 16 Bit 555, 16 Bit 565, 16 Bit 4444, 24 Bit 888, 32 Bit 8888.
DDS - DXT 1 to 5, BC 1 to 5, 8 Bit Mono
JPG - 24 Bit 888, 32 Bit CMYK.
PNG - Interlaced / NonInterlaced
TEX - BloodRayne 8 Bit Palette, 8 Bit Palette plus alpha, 32 Bit 8888.
TGA - 8 Bit Mono, 16 Bit 565, 24 Bit 888, 32 Bit 8888.
TTH - Bloodlines Format 0, 3, 12, 13, 15, 22, 23
VTF - Source Format 0, 3, 12, 13, 15, 22, 23, 24
XIMG - Gothic 3 DXT 1 to 5.

Audio Supported Formats

WAV - PCM, ADPCM

HELP
====

TODO: Write real help stuff here...

Temporary pack files are copied to 'C:\Temp\PackfileExplorer'
Thumbnail images are stored in 'C:\Documents and Settings\All Users\Application Data\PackfileExplorer'

Controls have changed to free up right mouse button for context menu.
Left Mouse Button will rotate model in view window.
Shift & Left Mouse Button to pan model.
Ctrl & Left Mouse Button to scale.

REVISION HISTORY
================

Version 3.09 October 01 2008
Added audio support to Packfile Explorer.
Prey .md5's now load many of their base textures.
Added very basic support for .lwo LightWave models.
Fixed translation on AABB and bounding sphere of Bloodlines models.
Fixed bug causing missing files in Oblivion voice .bsa archives.
Fixed loading of 24 bit textures with mip maps.

Version 3.08 September 15 2008
Fixed crash when exporting models with only one bone.
Updated solution so I don't accidently package VampEd.exe again.

Version 3.07 August 26 2008
Added support for BloodRayne 2 POD3 packfiles.
Fixed possible crash if a packfile fails to open.
TTH and VTF files now load their entire mip map chain.
Added support for non power of two compressed textures.
Added a new validation type 'name must contain' to PackfileExplorer.xml
Wrote a new 2d box packer for Source engine lightmaps.
Added support for BloodRayne 2 .tex image files.
Added support for Legend Hand Of God packfiles.

Version 3.06 August 10 2008
Improved Bloodlines animation support.
Added support for multiple texture sets in models.
All animations now play at the authored frame rate.
Fixed a benign memory leak on application shut down.
Added menu option to select a models displayed texture set.
Fixed occasional problem acquiring thumb nail cache file path.
Fixed crash when attempting to play animation on a rigidly bound model.
Wrote a new Blender import script that works with both .x and .scene files.
Backdrop.bmp in the application directory is rendered behind the models again.
Fixed a long standing bug where models would sometimes display with the wrong textures.
Wireframe is automatically disabled when you enter texture view mode.
The texture preview quad is no longer rendered when displaying maps.
Fixed the last couple of redundant render state changes.
Fixed possible crash after failure to initialise.

Version 3.05 July 29 2008
Fixed missing polys on very large maps.
Displacement maps appear fully functional.
Most versions of Source Engine BSP's are now supported.
Increased the minimum hardware spec to vertex shader 3.0
Cleaned up all the file drivers I have been putting off for far too long.
Fixed The Witcher .bif archives broken a few versions ago.

Version 3.04 July 22 2008
Updated to DirectX June 2008.
Fixed crash when loading Dark Messiah maps.
Partial support for Bloodlines instanced geometry.
Improved rendering of transparent / alpha keyed geometry.
Partial support for Bloodlines Displacement maps.
Added support for Unreal Engine 3 .upk archives.
Tested file extraction from 'Mass Effect' & 'Gears Of War'
Moved file validation codes into PackfileExplorer.xml
New icon set for packfiles directory view.
Rewrote texture search routines.

Version 3.03 June 22 2008
Fixed Doom3 MD5 model rendering.
Added Bloodlines skeleton and vertex weighting.
Fixed bug causing Redemption textures to always use point sampling.
Actual Source Engine BSP normals are now used instead of being re-created from faces.
Source Engine BSP models are now located in their correct positions.
Started investigating Bloodlines animation format.

Version 3.02 June 03 2008
Fixed orientation of bloodlines static props.
Fixed incorrect filter state on nearly all vtf textures.
Save bsp as .x file now extracts all models used on the map.
Added python script to flatten .scene into a single .x file.
Hid the pile of BSP models rendered at the maps origin.
Added new context menu for map view.

Version 3.01 May 25 2008
Fixed slow down after opening many bsp files.
Extracted maps are no longer all named source_bsp.x
Many more bloodlines materials are now displaying in maps.
Static and dynamic models are now rendered in the map view.
Save as .x creates tga's again so as to retain the alpha channel.
Using older .x library as a hopeful quick fix for blender script problem.

Version 3.00 May 19 2008
Third total rewrite, cleaned history again as everything is new.

Version 2.00 Apr 12 2007
Second total rewrite

Version 1.00 Dec 20 2005
First total rewrite, changed name to Packfile Explorer.

Version 0.10 Jan 08 2005
VampEd is created.