--------
LEGAL:
--------
This program is for educational purposes only & should not to be used for bootlegging
copyrighted materials, such actions are not condoned by the author, 
said person is beyond reprimand and censure until the end of time.
This software is freeware & comes with no warranties of any kind.
This software may be freely distributed as long as it is not re-packaged.
By using this software you must accent to the following condition;
I as a human/humanoid/other agree to waiving all rights and or autonomies I have.


EkszBox-ABX: Copyright  2006 Kernel Master
----------------

Adx2wav: Copyright  2001 BERO
-------------------------------------------

############################################################################
[See end of file for help & tips]


--------------------------------
V1.3 FIXES &/OR UPDATES
------------------------------------------
+ 19 formats are now supported.
+ Map support (Halo & Stubbs).
+ (Beta) Msx support (Mortal Kombat Deception).
+ Support for xwb's from 'Blazing Angels Squadrons Of WWII' (Not fully tested).
+ Xwb file swap modified so it should support aforementioned game (as above).
+ Temporary hack written to support 'Lord Of The Rings The Two Towers' xwb's (as above).
+ Xsb code totally rewritten (Includes error checking/correcting) 
   [All Psychonauts xsb's are read perfectly now].
+ Xwb filename parsing improved (Fixes problems /w Counter-Strike xwb's).
+ SCX support for xwb's.
+ SCX buffer code rewritten.
+ Pcm & adpcm headers are written faster due to code optimization.
+ 8 bit headers were not created correctly -> fixed.
+ Adpcm headers had incorrect byte rates -> fixed.
+ Saving Xct ini name files was buggy -> fixed.
+ Updated my Xct app (Code cleaned up).
+ Load & save settings totally rewritten.
+ Save last used directory bug fixed.
+ Bug which caused settings file to be saved in strange places -> fixed.
+ settings.ini renamed to EkszBoxSettings.ini.
+ Added Xct database entries for 'Soul Calibur II' & 'Psyvariar 2 Extend Edition'.


^ Thanks to Xantium for the support & for hosting this app. (http://www.xbox-scene.com)

^ Thanks to robot2 for the 8 bit bug report, for supplying a relevant file & for 
    beta testing.

^ Thanks to Grenadiac, Dylan Barrie & Thomas Kaiser for their map file documentation 
  [see end of file for more info].



Halo Map Notes
--------------------
Decompressed maps are saved as *.mapU, these are safe to delete after you're done extracting.
To save time they may also be loaded directly.


Msx Notes
-------------
Some extracted files don't work, due to a lack of time/Msx files I was unable to do 
anything about this. 
(I might try to fix the problem for the next version [if there is one]).


SCX Notes
-------------
SCX Buffer sizes are now allocated based on available [non-virtual] memory.
Scanning multi GB files should be possible on any system now.
If you're scanning large files choosing a large buffer may not be a good idea.
Medium is not any slower alot of the time.


Xct Info
----------
The Xct format was designed with raw speed in mind.
Switching the Xct database off will not give much of a performance gain as scanning 
it for a match takes on average less than 0.01 secs.


Rws Format Info
--------------------
The first file in every Max Payne 2 rws is blank.
This is not an error with the way this app parses these files.


Operating System Info
----------------------------
Windows 9x users who wish to run the app using a shortcut need to follow these steps
to avoid anomalies:

- Make your shortcut
- Right click the shortcut
- Select properties
- Copy all of the text from the 'Target' textbox to the 'Start in' textbox
- Remove EkszBox-ABX v1.3.exe from the text you copied into the 'Start in' textbox 
  (Don't remove the " from the end)




-----------------------------------
V1.2 FIXES &/OR UPDATES
-----------------------------------
+ 17 formats are now supported.

+ Adx support (Always extracts to Pcm format).
+ Sxb/Vxb support ('Ford Racing 3').
+ Rez support (support for 'Mojo!' only).
   Note: Not all extracted audio works (sfx), however all of the music works fine.

+ Rcf file swap compatibility (Simpsons Hit & Run, Tetris Worlds).


Rcf Audio File Swap Info
----------------------------

^ Imported audio must be in pcm format (16bit, stereo or mono).

^ Tetris Worlds: Music can easily be swapped (Must be stereo & 24khz to play at correct speed) 

^ Simpsons Hit & Run: Car sounds can be changed, however there will be freeze-ups 
   if imported files don't have very similiar specs compared to the originals.
   Music is a pain to swap as the game seems very fussy about certain files 
   (Possibly the rms files contained in 'music01' have region &/or filesize info which needs to be changed to fix this).


+ Improved/Fixed Rcf support
   Note: Offsets & pertaining chunk sizes are now sorted by size to match with filenames.
   Pcm files as found in Simpsons Hit & Run now have all the padding removed from start, 
   (This padding caused clicks at the beginning of sounds).

+ Batch mode file processing support.
+ Beta stage X360 Xwb support.
+ Major engine changes.
+ Faster file extraction.
+ Updated gui.
+ Support for adding your own background bmp.
+ New folder browse feature.
+ Found some memory leaks -> fixed.
+ Noticed that rename files was broken -> fixed.
+ Fixed progress dialog position annoyance.
+ Gui wasn't updated if SCX didn't find any files -> fixed.
+ List now shows relevant icons for 16 different file types.
+ Xact wave bank (xwb) info now shows version number.
+ Filenames are now read from xwb's which contain thersuch.
+ Removed non audio format support from SCX.
+ Fixed a auto-buffer backtracking bug which caused SCX to miss certain files.
+ SCX refined & optimized (Better speed).
+ Rewritten & improved xwb compatibility.
+ Improved xwb file swap compatibility.
+ Many other code changes, optimizations & fixes.
+ Fixed San Andreas Xct database entries.
+ Added Xct database entries for Burnout Revenge, Madagascar & Mojo!.

-> Source code (C++Builder 2006) will be included in one of the next versions.

---------------------------------
V1.1 FIXES &/OR UPDATES
---------------------------------
() New Xwb audio file swap feature: Adpcm, pcm & wma files contained in xwb's may 
    now be swapped with your own.
  Interestingly, with some games this feature even allows you to use adpcm in place of 
    pcm or pcm in place of adpcm etc.. (Most of the time swapping wma for adpcm/pcm or 
    vice versa won't work).
    Note: For best compatibility only use audio files which are all in pcm, adpcm or wma format & 
    if your game crashes try to match the specs of the original sounds more closely, 
    Mixing & matching different formats within banks can cause problems with many games.
  This feature was only made possible because I finally managed to crack the pcm 
    magic numbers formula as well as the critical xwb file padding algorithm.
  Supports most streaming or in-memory version 1, 2 & 3 xwb's. (Many ver 1 xwb's should work, 
    albeit maybe not always as perfectly as most ver. 2 or 3 xbe's do).
  Tested & confirmed to work with xwb's from Burnout 3, Capcom Classics Collection, Egg Mania, 
    PGR2, Sims 2, Super Bubble Pop & Top Spin. (Had a load of fun swapping sounds & music from
    Street Fighter 2 in Capcom Classics as well as changing engine sounds in PGR2).

Xwb Audio File Swap Instructions
--------------------------------------

(1) Open an xwb.
(2) Make sure the file list is enabled.
(3) Check or uncheck appropriate files in the file list.
(4) Right click the file list & click on 'swap checked'.
(5) Figure out the rest on your own.

Note: If you click cancel on the open file dialog after having clicked 'swap checked' 
the original audio file from the opened xwb will be inserted in place of the file you were 
supposed to select.
Note: Edited Xwb's are given a .xwbX extension.

() Xwb Pcm info contained in magic numbers is now decoded with my own formula. 
    (much faster & more elegant than previous solution)
() Updated Sims 2 filename database entry.
() Removed: Rws debug info.
() Removed: Browse for folder support. (Temporary - when I get it working perfectly it 
    will be added again)
() Fixed: Wav headers were not being created for audio files extracted from Rfa's.
() Fixed: Auto-Clear CheckBox caption was static.
() Cleaned up some more bits of code.

---------------------------------
V1.01 FIXES &/OR UPDATES
---------------------------------
() New (tentative) support for Zwb (Thanks to Luigi Auriemma for the info - http://aluigi.org)
() Fixed a bug which caused extracted filenames to be messed up.
() Removed debug & partially supported formats code.
() Cleaned up a few small bits of code & fixed a few other minor bugs.

---------------------------
NEXT MINOR VERSION
---------------------------
?

--------------------------
NEXT MAJOR VERSION
--------------------------
?


#########################################################################

------------------------------------
EkszBox-ABX Main Features:
------------------------------------

() This program has the largest & best compatibility for extraction of audio files & 
    other formats from xbox games (Some pc games are also supported).

() 19 different formats are currently supported, many of these are exclusively supported 
    by this program and no others.

() Supported formats: Adx, Afs, Arc, Big, Gta5, Map, Msx, Piz, Rcf, Rez, Rfa, Rws, Sxb/Vxb, Sr, Wad, Xsb, Xwb, 
    Xwc & Zwb.

() Xact Wave Bank compatibility is more vast and robust than any other xwb 
    extraction programs.

() High quality & compatibility Xwb & Rcf audio file swap feature.

() Adx files can be extracted from Afs files to uncompressed Pcm wav format. 
    (Select pcm from format list box)

() Header-less Pcm & Adpcm wav's have headers automatically created upon extraction.

() Batch mode file processing.

() SCX allows you to scan & extract Ogg, Wav, Wma & Xwb files from any non-compressed 
    unencrypted formats, and does so in some cases over 60 times faster than *other programs, 
    includes auto-buffer backtracking so no files are missed. 

    * Dragon UnPACKer 5, Jaeder Naub & Game Audio Player.

() Tested & confirmed to work with archives over 1GB &/or containing over 10,000 files.

() Comes with a database containing filenames (Xct) for archives which don't even contain filenames 
    or ones which do.

() Supports File renaming & custom Xct database construction.

() Loaded extension-less supported files are auto-renamed with correct file extension.

() High performance & a resonably small memory footprint.

() No major known bugs

() No dll's, no registry entries & no .net runtime dependencies.

() Written in c & c++.

#########################################################################

---------------------------------------
COMPATIBLE XBOX GAMES (67) +
-------------------------------------------------
+ Many more games are likely to be compatible, this list 
   however contains only games which have been tested 
   & are claimed/conjectured/verified to be compatible by 
   the author or EkszBox-ABX users.


-----------------------------------------------------------
AfterShock Pool SX
Blazing Angels Squadrons Of WWII
Bloody Roar Extreme
Burnout 3 Takedown
Burnout Revenge
Castlevania: Curse Of Darkness
Capcom Classics Collection
Chronicles Of Riddick: Escape From Butcher Bay
Colin McRae Rally 2005
Conker: Live & Reloaded
Crazy Taxi 3
Deus Ex: Invisible War
Disney's Extreme Skate Adventure
Egg Mania
Ford Racing 3
Forza Motorsport
Full Spectrum Warrior
Fuzion Frenzy
Grabbed By The Ghoulies (Demo)
GTA: San Andreas
Halo
Hello Kitty: Mission Rescue
House Of The Dead 3
Igo
Jade Empire
Juiced
Karaoke Revolution
King of Fighters: Neowave [Claimed compatible by: Vlcice]
Land Of The Dead: Road to Fiddler's Green [Claimed compatible by: robot2]
Madagascar
Marvel Vs. Capcom 2
Max Payne 2
MechAssault 2: Lonewolf
Men Of Valor
Metal Slug 3
MicroMachines V4 
Mojo!
Mortal Kombat
Mortal Kombat 2
Mortal Kombat 3
Mortal Kombat Deception
Nickelodeon Party Blast
Oddworld: Strangers Wrath
Psychonauts
Pro Beach Soccer
Project Gotham Racing 2
RalliSport Challenge
RollerCoaster Tycoon
Sega Soccer Slam
Shadow Ops: Red Mercury
Simpsons Hit & Run, The
Sims 2, The
Sonic Heroes
Sonic Mega Collection Plus
Stubbs The Zombie: Rebel Without A Pulse
Sudeki
Super Bubble Pop
Super Monkey Ball Deluxe
Tetris Worlds
Top Spin
True Crime: New York City
Warriors, The
World Championship Poker
Xbox Music Mixer
XbomberBox
XbomberBox 2
Xlime


----------------------------------
COMPATIBLE PC GAMES (3) +
----------------------------------
+ see above
-------------

Far Cry
Richard Burns Rally
Thief, The Dark Project

#########################################################################

------
INFO
------

To convert xbox adpcm's use a program such as dBpowerAMP. 
You must first however, download & properly install the following codec:

http://dwl.xbox-scene.com/~xbox/xbox-scene/tools/drivers/xb_adpcm_codec.rar


To play adpcm, xwb, zwb, wba, xsd or xsh files with winamp try 
Luigi Auriemma's Xbox ADPCM plugin:

http://www.winamp.com/plugins/details.php?id=147392


------
HELP
------

Let's say you had 700 xwb's and you didn't want the contents of each put into a subfolder, 
you just wanted all audio files dumped into a single folder, well this can actually be done like this:

(1) Turn the List off [This is optional, but will offer better speed].
(2) Turn the Xct database off.
(3) Turn Auto-Clear off.
(4) Enter a name into the Folder name textbox.
(5) Click Open or SCX & select all the files you wish to batch process.

------------------------

Format, Channels & Sample Rate settings generally only change what info is written to the pcm or adpcm headers.
These settings should set to Auto for most situations, however for converting adx files contained in afs files into 
pcm format, the Format setting should be changed to PCM.

-----------------------

The % symbol can be used in the rename files textbox (Doesn't yet work with SCX).
Here is an example: Audio %%%%%%%%
Load a file & turn on the list to see how it functions.


------------------
KNOWN ISSUES
------------------

List fucks up if more than 5000 file details get loaded in, 
I fixed this problem by disabling the list if more than said amount of files are found in an 
archive & the list is enabled.
I will try to find a proper solution for the next major version.

-----------
CREDITS
-----------

Main Coder: 
- Kernel Master - (kmeksz@yahoo.com)

Adx2wav Code (2001 BERO): 
- BERO - (http://www.geocities.co.jp/Playtown/2004/)

Zlib decompression code (Copyright free - zpipe.c): 
- Mark Adler - (http://www.zlib.org)


EkszBox-ABX is coded with Borland C++Builder 2006 & makes use of the following:
-------------------------------------------------------------------------------------------------
Jedi Code Library - http://sourceforge.net/projects/jcl/
Jedi Visual Component Library - http://homepages.borland.com/jedi/jvcl/
Zlib Data Compression Library - http://www.zlib.org

PECompact2 - http://www.bitsum.com
Kenny icons: ?

--------------
THANKS TO
--------------

Xantium for the support & for hosting this app.
- http://www.xbox-scene.com

robot2 for the 8 bit bug report, for supplying a relevant file & also for beta testing.

Grenadiac, Dylan Barrie & Thomas Kaiser for their in-depth Halo map file documentation:
- http://wiki.fpsgamers.se/index.php?n=Halo.HomePage
- http://www.halomods.com/forums/viewtopic.php?t=5003
- http://www.halomods.com/forums/viewtopic.php?t=5436
- http://files.halomods.com/viewtopic.php?t=3088

Luigi Auriemma for advice, for the zwb info & for actually replying to my e-mails.
- http://aluigi.org

BERO for sharing his adx2wav c source code.
- http://www.geocities.co.jp/Playtown/2004/

Ben Gorman for his xwb documentation (Found in Psychonauts Explorer)
- http://quick.mixnmojo.com

#########################################################################


[<->GAME OVER<->]