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

ESX Wave Organizer v0.1.8

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

website: http://www.skratchdot.com/esxwaveorganizer/home.php
contact: jastek25@hotmail.com

---> This README file was last edited on 07-17-05 <---

INFO
-------

No Installation Required. Just unzip and run the .exe.

Known Bugs & Limitations

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

- Cannot edit the start, end, loop start, time slice and sample tune parameters.

- Some of these features will be added in future versions.... Check out the website
for more info.

Version History
-------------------

v0.1 --- Initial Release (May 6, 2004)

v0.1.1 --- Released On May 9, 2004

-- Fixed a bug that would ignore .wav files that had a 'smpl' chunk with the
"number of samples value=0"
-- Now when you double-click a sample in the list, it will simulate pressing the
"Play" button. You can
still only "Play" samples that originate on your computer.

v0.1.2 --- Released On May 13, 2004

-- Fixed a bug that would let you add a stereo sample when you shouldn't be able
to. This would cause
the available memory to be negative, which should never happen. Since stereo
samples take up twice
the memory that mono samples do, I was letting you add a stereo sample,
without checking if twice it's
size would fit. For example, if your memory left was: 4000, and the stereo
sample's memory size was 6000,
it would still be added, because 3000 is less than 4000. Your memory left
would be -2000 after adding it.
All this has been fixed, and hopefully no one ran into this problem....

v0.1.3 --- Released On October 29, 2004

-- Added AIFF support. The program will recognize 8 or 16 bit, mono or
stereo, .aif files.
-- Added Minimize and Maximize Buttons
 -- The Play and Loop buttons work for every sample now. If you press the Loop
button on a sample that is not a
loop, it will play the whole sample repeatedly.
-- Rearranged the main dialog. Now the mono and stereo lists are side by side
(displaying more samples at once).
-- Got rid of the "quick save" buttons, and added regular "Windows style" open
and save dialogs.
-- Added a "Remove All Samples" feature, which deletes all the samples from the
workspace, but leaves
the pattern and song data that is loaded.
-- Got rid of the file "esxwaveorganizer.data". Now you only need the .exe file
for the program to work.
-- Fixed the "Clear Pattern & Song Data". Previously, when you cleared all
pattern data, each part's
sample would be set to Mono Sample #000. Now, when you clear all pattern
data, and load an .esx file
into your sampler, each parts' sample will be set to NONE (not Mono Sample
#000).
-- Added a Menu with the options:
- File:
* Open/Add Files To Workspace
* Save As ESX File
* Extract All Waves
* Exit
- Functions:
* Clear All Pattern And Song Data
* Pattern Organizer
* Song Organizer
* Remove All Samples
- Help:
* About ESX Organizer
* Visit Website

v0.1.4 --- Released On November 17, 2004

-- You can now view if a sample has been time sliced or not.
-- You can now view and set the Play Level for each samples.
-- BUG FIX == Before, if the focus was on Mono Sample 001, and you clicked on a
"greyed" Stereo Sample 001, the
focus would still be on Mono Sample 001. This has been fixed. No matter what
sample you click on, it will
always become the focus...
-- BUG FIX == Before I accept an .esx file into the workspace, I do a few checks
on the file. It must contain
the values "KORG" in 2 places; it must contain the value 0x71 in two places;
and it must contain the value
"ESX" in one place. Previously, I was also making sure that it had the value
"BPS" in one place. This was not
needed, and it was not true for all .esx files. I found this out because
someone emailed me saying that the
program was not accepting their .esx file. Where I thought that the value
"BPS" was needed, it wasn't. The
.esx file in question, had the value "BPA" where I thought the value had to be
"BPS". If anyone else has a
problem loading an .esx file into the workspace, email me... It is probably
because one of the other checks
I do is unneccessary.

v0.1.5BETA --- Released On December 1, 2004

-- Added the "Pattern Editor" with limited functionality
v0.1.6 --- Released On June 17, 2005
-- Fixed major "SLICE" problem. Before, if you moved a sample that had been
sliced
on the ESX, it would not play back properly without being "re-sliced". This
has now been fixed.
-- Added "Set All Play Levels To" to the Functions menu. This will let you set
them
to either 0dB or +12dB.
-- Fixed typos:
* changed "Fuctions" to "Functions"
* changed "Exit Part Editor" to "Exit Pattern Editor"

v0.1.7 --- Released On July 10, 2005

-- Added a "first loading slot" feature. Previously, all samples would try to
load into slot #000. If that was
already in use, it would find the next available slot. Now, you can set the
first slot number to try. It will
then find the next available slot (looping around when it gets to the end).
-- Changed the "About Box". Now you can click on my email address to open your
default email client to email me,
or click on the program's webpage url to open your default webbrowser and
visit the homepage.
-- Removed the "Push Up" and "Push Down" buttons (which weren't implemented), and
replaced them with the "NEVER LOOP"
and "LOOP WHOLE" buttons.
-- The "NEVER LOOP" button sets the sample's "Loop Start" value equal to the
sample's "End" value. This means that
the sample will never loop when played as a keyboard part.
-- The "LOOP WHOLE" button sets the sample's "Loop Start" value equal to the
sample's "Start" value. This means that
the sample will loop completely when played as a keyboard part.
-- The "LOOP" button will only work for MONO samples that have a "Loop Start"
value. If a sample doesn't have a
"Loop start" value (and you want to hear it loop), you can press the "LOOP
WHOLE" button. Now you can press the
"LOOP" button.
-- Changed the "Extract All Waves" feature. Before it would rename files with
the sample name last. Now it renames
them with the sample name first. So,
BEFORE: "ESXextracted-MONO-140-M1PickBs.wav"
NOW: "M1PickBs-MONO-140-ESXextracted.wav"
-- Changed the button name "Remove The Selected Wave" to "Remove The Selected
Sample".
-- Changed the button name "Edit The Selected Wave" to "Edit The Selected
Sample".
-- Added a "Convert Selected Sample (MONO/ST)" button. This will convert a Mono
Sample to a Stereo Sample, or a
Stereo Sample to a Mono Sample (depending on what is selected, and how much
free space there is).
-- BUGFIX: Before I was only accepting files with the extensions (.esx, .wav,
and .aif). I was ignoring all other
files (including .aiff). Now I am accepting .aiff as well as .aif, so: (.esx,
.wav, .aif, and .aiff are all the
acceptable formats). Thanks to Jayzilla for reporting this.
-- Added a "Pattern List" Column in the Sample Organizers, which let you see what
Patterns a Sample is used in.
-- Added a "Remove All Samples Not Used In A Pattern" function. This lets you
free up space by removing any samples
 that aren't being used.
-- Added a "Mono Organizer" function. This opens up a new dialog window, which
will let you select multiple samples,
and move them around (by dragging them). Hold down the shift button to select
multiple samples. You can rename
multiple samples, and change their stretch step values. If you check the "Add
Number" box, then you can rename
multiple samples, and a unique number will be added to the end of the sample
name (for instance: if you type "bass",
your samples will be renamed "bass0", "bass1", "bass2", etc.).

v0.1.8 --- Released On July 17, 2005

-- BUGFIX: Fixed a bug that was ignoring certain .aif/.aiff files.
-- BUGFIX: Fixed a CPU Memory Leak that occured when using the "Remove All
Samples" Fuction. Previously, I was only freeing CPU memory when using the "Remove
Currently Selected Sample" or "Remove All Samples Not Used In A Pattern" Fuctions.
This could slow down your system (only while the program was running) if you
repeatedly used the "Remove All Samples" Fuction in a session.
-- BUGFIX: Fixed a bug that was not displaying the STEREO Sample Names in the
Pattern Organizer.
-- BUGFIX: Fixed another bug that was not always storing "SLICE" samples
correctly. Search the forums for more info about this bug.
-- Changed the name of the "Pattern Organizer" to "Pattern Editor".
-- Changed the name of the "Song Organizer" to "Song Editor".
-- The Song Editor works now.
-- Added Minimize/Maximize Buttons to the Pattern Editor and the Song Editor.

Notes
---------

Please visit the website at http://www.skratchdot.com/esxwaveorganizer/home.php

and sign up at the forum. Let me know what you think...