==================================================================
EWS 64 Midi Mixer v0.60.tt        build: 20.01.99		released: 22.01.99
==================================================================
Contents:

	1. What is a Midi Mixer ?
	
	2. How do I use it ?
	
	3. EWS64 Midi Controller Table.

	4. offical FAQ

	5. History / future plans

	6. Credits & Contact

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

1. What is a Midi Mixer ?
---------------------------

A Midi Mixer is a freeware program that sends simple Midi data (like controllers, program change) to control
different sound settings of your soundcard or external equipment. 
It is mostly used to configure a Midi setup.

I wrote this program because the EWS64 Control Panel isn`t able to save your midi settings.
This means that if you just made a cool song with much reverb and no chorus on Channel 1, the control
panel don`t load this Channel 1 setup if you load a mixer file. After you boot up your Computer 
or make another song with another configuration on Channel 1, your old settings are lost.
Just load your saved settings in Midi Mixer and your midi file will sound the same way as you`d created it.
If you have a midi sequencer, Midi Mixer will be much more handy and can be used to control such 
things like cutoff frequency in realtime.

See History for features -> 5


2. How do I use it ?
---------------------------

Midi Mixer is quite easy to use. Be shure to set up your Midi Play clients to more than 2 in the device manager!
BTW: You can also use Virtual Midi Devices to have realtime control for programs like Generator,Rebirth,SEQ303 or BUZZ.
Unzip it in the EWS64 directory or any other directory on your drive.

 1. Start up your sequencer or a midi file.
 2. Start up Midi Mixer and select 'EWS64 Midi Play' in the settings menu.
 3. Play your song and control the different midi channels in realtime by moving the faders in Midi Mixer.

Example: 

Fader use:

You have a Lead instrument playing in your sequencer on Channel 1 and a bassdrum on Channel 2.
Now, you can control the volume of that Lead instrument, by moving Fader 1 and the volume of the
bassdrum by moving Fader 2.
Now label your Channel 1 and 2. Right click your Fader 1 and click 'Set Label'. Type in 'Lead Volume'.
Do that with Channel 2 and use 'Bass Drum Volume'. 
When placing the mouse over these Faders you`ll see it`s description.
You can also edit the permanent labels on the bottom of each fader. Click on that 'Ch. 1' label and use your keyboard
to change it.
If you now want to control the cutoff frequency of the Lead instrument you`ll have to use controller 74.
Right click on Channel 3 and set it`s label to 'Lead Cutoff Frequency'. Right click again and click 'Set Controller'
in the 'Send Type' submenu. Enter 74 and click ok. Now you can move Fader 3 and asjust the Lead instrument`s
cutoff frequency. 

Knob use:
A more handy way to control the cutoff frequency is to use a knob. Just click the knob with the left mouse button
and move your mouse to adjust the value that is being send. You can configure the knobs as you like with a right click.
The default controller configuration for the knobs is: 74 - Cutoff 71 - Resonance 91 - Reverb amount 93 - Chorus amount.

Group:
All Faders within a group will move simultaniously.

Mute&Solo:
When you mute a button all futher adjustments are not send to the midi out device and the Volume is set to 0.
Solo just mutes all other channels than the currently selected.

You can also make further adjustments. For a controller table see -> 3.


3. EWS64 Midi controllers (build-in)
---------------------------
     
This list will help you to find the right controller numbers for the effects you want to use with 
the EWS 64 Midi Mixer. You can also find them by pressing F11 within Midi Mixer.

number    values              default value          description

00            0 - 127              0                            bank select. cc=64 reserved for ed!son.
01            0 - 127              0                            modulation wheel. rate and maximum depth can be set using sysex.
05            0 - 127              -                             portamento time
06            0 - 127              -                             data entry: provides data to rpn and nrpn.
07            0 - 127              100                        volume
10            0 - 63 - 127       63 (center)             pan (use the pan controls)
11            0 - 127              127                        expression
64            0 / 127              0                            sustain (damper pedal)
65            0 / 127              0                            portamento on / off
66            0 / 127              0                            sustenuto pedal
67            0 / 127              0                            soft pedal
71            0 - 127              -                             resonance (harmonic content)
74            0 - 127              -                             cutoff frequency (brightness)
80            0 - 7                  4                            reverb program

					0: room1			1: room2
					2: room3			3: hall1								4: hall2			5: plate
					6: delay (echo)		7: stereo delay

81            0 - 7                  2                            chorus program

					0: chorus1		1: chorus2
					2: chorus3		3: chorus4
					4: feedback		5: flanger
					6: short delay		7: feedback delay

91            0 - 127              40                          reverb send level
93            0 - 127              0                            chorus send level
94            0 - 127              -                             pan between out1 and out2[when reverb+chorus off in fxpanel]
120          0 / 127              -                             all sound off
121          0                       -                             reset all controllers
123          0                       -                             all notes off
126          0, 1 - 16            -                             mono on
127          0 / 127              127                        poly on


4. offical FAQ
---------------------------

As I wasn`t asked that much yet ;-) this FAQ is filled with questions you might have.
Expect a more realistic FAQ in future versions.

	- Why do I need this Midi Mixer ? I already have one in my midi-sequencer !

		It is more handy and compact than all midi mixiers I`ve seen in any sequencer software.
		It will also have more features than those and can be configured to almost any needs.

	- Does it only work on EWS64 Cards ?

		These first versions will work on every Computer with installed Midi Devices.
		As soon as I have managed to work with the EWS API it will use some extended EWS
		functions and therefore only run on EWS64 Cards. V.60.tt has some functions like
		FX Settings and SysInfo which only work with EWS Cards !

	- Your Application just crashed my Computer, burned up my house, eat my cat and my credit cards.
		
		You`re using this software for your own risk. I take no responsibility for this program.
		BTW: Software can`t eat neither burn your 
		House down ;-)
	
	- When will the final version be ready ?

		As this project is free, it`s finialization depends on my personal intention. But I can say that
		you all can expect a nearly completed version in january...

	- What do you use to write EWS64 Midi Mixer ?

		I am running a PII 400 Mhz with Delphi 2.01 and I am using some additional components.

	- How can i set up more than one 'midi play client' ? - or - I get a mmsystem error !

		Look in the Device Manager and click on Terratec Audio Devices. Click on Terratec EWS64 Synthesizer
		and then click on properties. Adjust the midi play clients two more than two in the settings tab.

	- Hey, I can`t press the OSC Buttons !

		Hey, this means that they don`t work right now ! The main code for the Midi Oscillators
		is quite buggy and instable. I will enable them when I have optimized the code.
		I can only tell you that they are VERY cool ! ;-)

	-> look in credits -> 6.


5. History / future plans
---------------------------
v0.60.tt - build: 20.01.99
needs a resolution of 1024x768 !
new features: 

	- Preliminary Load & Save functions (be aware!)
	- Displays current values of the controls.
	- saves hole configuration incl. FX Settings...
	- New Fader Controls!
	- 4 Knobs per channel
	- Small bugfixes

v0.50.a - build: 24.12.98
new features: 

	- Working Solo buttons 
	- Fader groups for simultanious movement of all faders within a group.
	- Some graphical changes
	- 1 Free assignable Midi Controller Knob
	- Control the FX Panel Chorus & Reverb settings
	- Permanent Labels for each channel
	- Midi Controller Help
	- EWS Driver Information
	- Font Bug solved
	- Many small bugfixes

v0.40.a - build: 29.10.98
new features: 

	- Mute,Solo buttons & channel numbers (solo buttons deactivated)
	- Panning per channel
	- Some graphical changes
	- Midi Reset and Panic
	- Midi Controller Help (not fully working yet)
	- Many small bugfixes

v0.10.a - build: 22.09.98
Features: 

	- 16 Channel (perhaps unlimited in later versions!) 
		with a Fader that can be assigned with any of the 127 Controllers
		or Program Change.
	- Label each Channel
	- Assign each Channel with the Midi Channel you need.

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

Future plans: 

1. 2 Modes: 

	- easy routing of every single channel to one of the 4 mono outputs (!!!) 
	  => for people that want to have inst. splited up on their (hardware) mixer. 
	or
	- Use Reverb & Chorus settings

2. support the EWS EQ 
3. adjust the Midi Reverb time in bpm
4. Selectable Midi Port for every channel
5. adjust the main Midi Volume and Panning
6. Help File
7. Midi Oscillators
8. Program Change and Bank Change Section

- --> PUT YOUR IDEA IN HERE <-- 

Known Bugs:

- The midi connection is lost. Midi Mixer doesn`t send any data.
  Solution: Just select the midi output again. Will try to fix that soon.

- An OleSystemError accours.
  Solution: Just start Midi Mixer again. Will fix that of course.

6. Credits & Contact
---------------------------

	coded by: Funky

	special thanks: Rogier Hofboer

	beta testing by: Sebastian R.

Please feel free to send ideas, donations, comments and bug reports to:

E-mail: underground@cyberdude.com
WWW: http://uemr.cjb.net/

german techno music: http://profipanic.cjb.net

I will only live my live for my one and only dream! Intelligent Underground Electronic Music.
_____________________

THE PROGRAM IS PROVIDED "AS IS" WITHOUT ANY WARRANTY OF ANY KIND.
I DO NOT MAKE ANY WARRANTY OF ANY KIND AS TO THE ACCURACY OR
COMPLETENESS OF THE SOFTWARE OR THE DOCUMENTATION OR THE 
RESULTS TO BE OBTAINED FROM USING THIS PROGRAM. I SHALL NOT
BE RESPONSIBLE FOR ANY CLAIM ATTRIBUTABLE TO ERRORS, OMISSIONS
OR OTHER INACCURACIES OF THE PROGRAM. THE ENTIRE RISK AS TO
THE RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED BY THE
USER. FURTHER I DO NOT MAKE ANY REPRESENTATIONS OR WARRANTIES,
EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THE PROGRAM OR THE
DOCUMENTATION NOT LIMITED TO, THE QUALITY, PERFORMANCE, 
MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT
SHALL I BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTIAL OR
CONSQUENCIAL DAMAGES ARISING OUT THE USE OF OR INABILITY TO
USE THE PROGRAM OR FOR ANY LOSS OR DAMAGE OF ANY NATURE
CAUSED TO ANY PERSON OR PROPERTY AS A RESULT OF THE USE OF THE
PROGRAM, EVEN IF I HAVE BEEN SPECIFICALLY ADVISED FOR THE
POSSIBILITY OF SUCH DAMAGES. I AM NOT RESPONSIBLE FOR ANY
COSTS INCLUDING, BUT NOT LIMITED TO, THIS INCURRED AS A RESULT
OF LOST PROFITS OR REVENUE, LOSS OF USE OF THE PROGRAM, LOSS OF
DATA, THE COSTS OF RECOVERING SOFTWARE OR DATA, OR THIRD PARTY
CLAIMS. IN NO EVENT MY LIABILITY FOR ANY DAMAGES TO YOU OR ANY
OTHER PARTY EVER EXCEED THE PURCHASE PRICE OF THIS PROGRAM.

YOU ARE NOT ALLOWED TO RESELL, REVERSE-ENGINEER OR OTHERWISE
MODIFY THE PROGRAM. DOING SO WILL VIOLATE COPYRIGHT AND WILL
BE PROSECUTED TO THE MAXIMUM EXTENT POSSIBLE UNDER LAW.

SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED
WARRANTIES OR LIMITATION OF LIABILITY FOR INCIDENTIAL OR
CONSEQUENCIAL DAMAGES, SO THE ABOVE LIMITATION OR EXCLUSION
MAY NOT APPLY TO YOU.

SLIDER CONTROLS Copyright (c) 1998 TerraTec Electronic GmbH