  ***************************************************************************
  ********                                                           ********
  ********   DOKUMENTATION ZU: ESQape(V1.5G) ENSONIQ-ESQ-1-Utility   ********
  ********                    - Deutsche Version -                   ********
  ***************************************************************************

  *** HINWEIS: ***

   'ESQape1.5G' ist ein MIDI-Utility für alle ENSONIQ-ESQ-1 Synthesizer,
   wobei es auch keine Probleme geben dürfte, die Expander-Version ESQ-M
   anzusteuern (konnte ich nicht testen !).

   Man kann allerdings mit ESQape1.5 auch MIDI-SysEx-Daten beliebiger
   anderer Synthesizer(o.ä.)-Hersteller empfangen (unbegrenzte Länge !), 
   speichern und (nur durch einen 'Doppelklick' auf ein Icon !) wieder
   senden, was dieses Programm universell einsetzbar macht.(Punkt)

   Will man nur diese Funktion verwenden, so kann man nun unter den Punkten
   3.2.X) / 3.2.XI) / 3.2.IX) weiterlesen.



                          1.) BENöTIGTE HARDWARE:


      Ein CommodoreAMIGA, Modell 500/1000/2000/2500/3000 mit mindestens
      Kickstart 1.2 (2.0) im ROM.

      Ein MIDI-Interface am seriellen Port.





                          2.)    INSTALLATION:


      Folgende Files müßen sich auf der Boot-Diskette befinden:


           a) Im 'devs:' - Directory:
              - 'serial.device'


           b) Im 'libs:' - Directory der BOOT-Diskette (nicht nötig bei
              KICKSTART und WORKBENCH 2.0 !) :

              -  Die 'arp.library', sofern man in der startup.sequence
                 ARP-Befehle benutzt (wie auf dieser Diskette geschehen).
              -  'midi.library' - siehe Copyright-Vermerk am Ende.
              -  'req.library'  - siehe Copyright-Vermerk am Ende.
              -  'icon.library'.
              -  'info.library'.


           c) In RAM: oder RAD: oder VD0: muß das Directory 'T:' existieren.
              In der 'startup.sequence' muß also folgende Zeile stehen:

                       ASSIGN T: RAM:T ; oder RAD:T oder VD0:T


           d) Damit die Icon-Funktionen korrekt funktionieren sollten sich
              noch folgende Files in den entsprechenden Directories
              befinden, sofern diese Directories vorhanden sind oder
              benutzt werden :

              -  Directory SEQUENCES : Das File 'SequenceToESQ'
              -  Directory BANKS     : Das File 'BankToESQ'
              -  Directory SYSEX     : Das File 'SysExToMIDI'


           e) EINSTELLUNG AM ESQ-1 :
            
               Bitte die MIDI-Page anwählen un ENABLE=KEYS+CTRL+...+SX
               zum Empfang von SYSEX-Daten einstellen!
               Der MIDI-Kanal muß natürlich auch mit dem von ESQape1.5G
               übereinstimmen.

               Und daß mir ja keiner vergißt, die MIDI-Verbindungen zu
               stecken, wozu man natürlich ein MIDI-Interface braucht !


           f) Zur Bedienung von ESQape1.5 setze ich voraus, daß man sich
              halbwegs mit dem AMIGA vertraut gemacht hat:
               
              Man sollte wissen,
              - was 'Gadgets'und 'Icons' sind
              - wo sich die linke und die rechte Maustaste befindet
              - was das CLI ist
              - was mit 'Workbench' gemeint ist
              - den Unterschied zwischen 'Menu' und 'Bohnensuppe' kennen
              - daß 'MIDI' keine neue Rocklänge zwischen Mini und Maxi ist
              - mindestens bis achtzig/halbe zählen können
              - daß mit 'Laufwerk' nicht der Teil unter dem Beckenbereich
                gemeint ist
              - die größte und die kleinste Primzahl ausrechnen können,
                wobei als Hilfsmittel nur eine Heino-Schallplatte zur
                Verfügung steht.


              Glaubt man obige Forderungen guten Gewissens erfüllen zu können,
              so kann ich nur sagen : " Doll, wat ein schlauet Kind !" 







                                3.)   DAS PROGRAMM:



                          3.1)  - EINE KURZE EINFüHRUNG -


      Zum Start von ESQape1.5G einfach das Icon auf der Workbench doppelklicken
      oder vom CLI einfach : 'ESQape1.5G' + RETURN eingeben.

      Nun erscheint die 'Hauptseite' des Programms mit folgenden Gadgets:


      - SOUNDNAME -

        (Hier kann man für den gerade angewählten Sound einen neuen Namen
         eingeben und somit auf einfache Weise umbenennen)


      - S -

         Klickt man dieses Gadget an, so wählt man den aktuellen Betriebsmodus
         von ESQape1.5G:

            voreingestellt ist S für 'SENDEN' (aktuellen Sound senden),
            möglich sind auch A für 'AUSTAUSCHEN' (zwei Sounds austauschen),
            L für 'LÖSCHEN' (aktuellen Sound löschen) und K für 'KOPIEREN'
            (um einen Sound an einen anderen Platz zu kopieren) .
            Der Mauszeiger wechselt hierbei immer sein Aussehen, um zu ver-
            deutlichen, in welchem Modus man sich gerade befindet.
        

      - ICONS -

         Dies ist ein Gadget mit dem die Erzeugung von Icons für das jeweilige
         File beim Abspeichern unterbinden oder erlauben kann.
         Voreingestellt ist: 'erlauben'.


      - MIDI -

         Hier kann man den aktuellen MIDI-Kanal für Senden UND Empfangen
         eingeben - per Hand oder mit den zwei Pfeil-Gadgets rechts daneben,
         da, wo der Daumen links ist !


      Auf der rechten Seite des Windows befinden sich noch :


      - 5 MODIFY-Gadgets -

         Mit diesen kann man beim generieren von Zufalls-Sounds eine
         Maske für die Parameter erzeugen, die per Zufall verändert
         werden sollen.
         Voreingestellt ist hier : 'alle Parameter verändern'
   

      - SEQUENZEN EMPFANGEN -

         Hiermit kann der gesamte Sequenzen-Speicher am ESQ-1 angefordert
         und abgespeichert werden.
         Je nach Speichererweiterung am ESQ-1 sind dies MAXIMAL etwa 16 
         oder 64 oder 128 KiloByte an Daten, die dann empfangen werden.  


      - SEQUENZEN SENDEN -

         Hiermit kann ein abgespeichertes Sequenzen-File an den ESQ-1 
         zurückgesendet werden.
   

      - BANK SPEICHERN -

         Speichert die gerade geladene SoundBank als File wieder ab.
   

      - BANK  LADEN -

         Wenn Du schön aufgepasst hast, dann weißt Du die Lösung.
         Schick' sie mir auf einer Postkarte und Du kriegst sofort einen
         Leuchtkeks - kannste sogar nachts essen !
         (Mann, war der alt !) 


      - RANDOM BANK -

         Generiert eine komplette SoundBank, oder nur einen Teil davon,
         mithilfe der oben eingestellten Zufalls-Maske per Zufall - WOW!


      - ENDE -

         Sollten diejenigen sofort anwählen, die bis hierher nur 
         @¾»\°©®þ£]#£ verstanden haben.




      
                     3.2)  - NUN DAS GANZE ETWAS GENAUER -





                                       I
                     -------------------------------------
                       EINE SOUNDBANK VOM ESQ-1 EMPFANGEN
                     -------------------------------------
      
         Bitte einfach die rechte Maustaste drücken, während sich der Maus-
         zeiger innerhalb des ESQape1.5G-Fensters befindet und dieses auch
         aktiviert ist.

         Den nun folgenden Requester entsprechend mit 'OK' (oder auch nicht)
         bestätigen.

         Es wird jetzt ein DUMP-REQUEST an den ESQ-1 gesendet und auf die
         aktuelle ( INTERNAL- ) SoundBank des ESQ-1 gewartet; Die Titelleiste
         des Fensters ändert sich auf 'Warten ...' .

         Falls Daten empfangen, werden merkt man dies sofort daran, daß man den
         Mauszeiger nicht mehr bewegen kann (die 'midi.library' hat hier nun
         höchste Priorität).
         (Pro SoundBank überträgt der ESQ-1 übrigens 8166 Bytes !)

         Sollte dies nicht der Fall sein und auch nach einigen Sekunden nichts
         angezeigt werden, so ist offensichtlich etwas shief gegangen.
         Nun bitte den GANZEN VORGANG EINFACH DURCH DRüCKEN EINER MAUSTASTE 
         ABBRECHEN, die Einstellungen am ESQ-1 und auf ESQape1.5G überprüfen 
         und das Ganze noch einmal probieren.

         Ist alles in Ordnung, so werden die 40 SoundNamen nach einigen
         Sekunden angezeigt.


         >>> !!! HINWEIS !!! <<<
         >>> 
         >>> Es wird übrigens im folgenden Fall eine Fehlermeldung ausgegeben:
         >>>
         >>> 
         >>> Falls ein DUMP-Request an den ESQ-1 gesendet wird und die MIDI-
         >>> Kanäle nicht übereinstimmen, so befindet sich ESQape1.5G in einer
         >>> Warteschleife.
         >>>
         >>> Nun ist es möglich einen manuellen Dump am ESQ-1 (siehe ESQ-1-
         >>> Bedienungsanleitung !) auszulösen und somit dennoch die Daten
         >>> zu senden.
         >>>
         >>> Hat der ESQ-1 seine Übertragung abgeschlossen, so ist nun die
         >>> linke Maustaste zu drücken, um den Empfangsvorgang abzubrechen.
         >>> In einem Requester erscheint nun eine STATISTIK, wieviele MIDI-
         >>> Daten empfangen wurden.
         >>>
         >>> Sollte dort eine Zahl von 1em Paket mit 8166 Bytes stehen, so
         >>> sind die richtigen Daten empfangen worden - man kann nun mit
         >>> 'OK' die SoundBank gleich abspeichern.
         >>> Allerdings wird jetzt auch - entspr. dem ICONS - Gadget - evtl.
         >>> auch ein SysEx-ICON mit abgespeichert, was in diesem Fall nicht
         >>> wünschenswert ist.
         >>> Dies kann man mit 'CANCEL' verhindern und die SoundBank später
         >>> mit 'SAVE BANK' normal abspeichern.
         >>>
         >>> Der nachfolgende Requester fragt nun auch ab, ob man diese
         >>> 'falschen' Daten in den aktuellen BankBuffer kopieren möchte.
         >>> Mit 'OK' werden nun auch die 40 SoundNamen angezeigt und man
         >>> kann nun normal weiterarbeiten.
         >>> 
         >>> Dies ist übrigens die Methode, um SysEx-Daten beliebiger
         >>> Länge von fremden MIDI-Geräten zu empfangen und mit einem
         >>> Sende-SysEx-ICON zu versehen !





                                       II
                     -------------------------------------
                               EINE SOUNDBANK LADEN
                     -------------------------------------
      
         Hierzu ist bitte das entsprechende Gadget vonESQape1.5G zu betätigen.

         In dem nun erscheinenden FileRequester aus dem richtigen Verzeichnis 
         bitte eine SoundBank aussuchen und 'OK' betätigen.

         Falsche/fehlerhafte Daten werden mit einer Fehlermeldung quittiert
         und logischerweise nicht geladen.

         Auf der Originaldiskette befinden sich übrigens zahlreiche SoundBänke
         im Verzeichnis 'Banks' .





                                      III
                     -------------------------------------
                            EINE SOUNDBANK SPEICHERN
                     -------------------------------------
      
         Hierzu ist bitte das entsprechende Gadget vonESQape1.5G zu betätigen.

         In dem nun erscheinenden FileRequester das gewünschte Verzeichnis 
         anwählen/eingeben sowie einen Namen, unter welchem der aktuelle
         BankPuffer gespeichert werden soll und 'OK' betätigen.

         Hierzu sollte sich logischerweise eine SoundBank im BankPuffer 
         befinden, also entweder gerade über MIDI empfangen oder von 
         Diskette/HardDisk geladen worden sein !

         Entsprechend dem ICONS - Gadget - wird evtl. auch ein 'Bank-ICON' 
         mit abgespeichert, das man später nur noch 2mal anzuklicken braucht,
         um die SoundBank an den ESQ-1 zurückzusenden.





                                      IV
                     -------------------------------------
                        EINE SOUNDBANK ZUM ESQ-1 SENDEN
                     -------------------------------------
      
         Hierzu ist bitte das entsprechende Gadget vonESQape1.5G zu betätigen.

         Es erscheint nun ein Requester, der abfragt, ob man wirklich den ak-
         tuellen BankPuffer, bzw. irgend ein beliebiges MIDI-SysEx-File senden
         möchte.
         Bitte nun 'Ja' betätigen, um die Übertragung zu starten; Hierzu
         sollte sich logischerweise eine SoundBank im BankPuffer befinden, 
         also entweder gerade über MIDI empfangen oder von Diskette/HardDisk
         geladen worden sein !





                                       V
                     --------------------------------------
                       EINE SOUNDBANK PER ZUFALL ERZEUGEN
                     --------------------------------------

         >>> !!! HINWEIS !!! <<<
         >>> 
         >>> Die Zufalls-Funktion in der aktuellen Version ist nicht dazu 
         >>> gedacht, eine komplette Bank 'aus dem Nichts' zu erzeugen - 
         >>> obwohl man dies durchaus probieren kann, aber um eine gründliche
         >>> Nachbearbeitung der Sounds am ESQ-1 nicht umhin kommt, da sehr
         >>> oft hierdurch 'stumme Sounds' erzeugt werden (dies ist so beab-
         >>> sichtigt, ...glaube ich).
         >>> 
         >>> Diese Funktion ist vielmehr dazu gedacht, bestehende SoundBänke
         >>> mithilfe einer Zufalls-Maske mehr oder weniger gezielt zu ver-
         >>> fremden.

         Getreu obigem Hinweis bietet es sich also an, erst einmal eine
         Bank zu laden/empfangen und dann eine Zufalls-Maske zu erstellen.
         Hierzu bitte die fünf 'MODIFY-GADGETS' entsprechend variieren.

         Folgende Tips sollte man beachten:

         ' MODIFY OSC'S '
         verändert Wellenform und Tonhöhen-Modulation (MOD#1,MOD#2,MODAM#1,
         MODAM#2), aber NICHT die OCT-Einstellung !
         Dies sollte man anwählen, um leierwummerfunnypitchexperimental-
         Sounds zu erzeugen.

         ' MODIFY DCA'S '
         verändert alle Parameter in allen DCA's - hierbei kann es oft
         vorkommen, daß man hinterher überhaupt nichts hört, da alle
         DCA'S stummgeschaltet bzw. zu leise sein können !

         ' MODIFY FILTER '
         verändert FILTER-FREQ, FILTER-RESONANCE, FILTER-MOD 1+2, 
         FILTER-MOD 1+2-AMOUNT, FILTER-KEYFOLLOW + ENV-RESET.
         Habe hiermit sehr gute Ergebnisse erzielt.

         ' MODIFY LFO'S '
         verändert alle LFO-Parameter.
         Je nachdem wie die LFO'S geroutet sind, erhält man sehr gute,
         lustige, frequenzändernde, tonhöhenändernde, alles zusammen oder
         einfach Scheißergebnisse.

         ' MODIFY ENV'S '
         verändert L1-L3 sowie T1-T4.
         
         Alles in allem muß ich sagen, daß ich mit ' MODIFY ENV'S ' sehr
         brauchbare Variationen bestehender Sounds erhalten habe.
         Schaltet man ' MODIFY FILTER ' hinzu, so sind die Verfremdungen
         stärker, fallen aber auch sehr interessant aus.
         ' MODIFY DCA'S ' rate ich im Moment gar nicht oder nur selten zu
         benutzen (ich glaube im nächsten Update: V2.0 werde ich hier ei-
         niges ändern).
         ' MODIFY OSC'S ' und ' MODIFY LFO'S ' fallen unter Umständen eher
         in die Experimental-Sparte, was mir teilweise recht außergewöhnliche
         Effekte eingebracht hat.

         Ich rate euch, einfach einmal alle Variationen durchzutesten - das
         ist die beste Methode herauszufinden, womit man die für sich besten
         Ergebnisse erzielen kann.

         Hat man nun endlich eine Zufalls-Maske erstellt, so ist einfach
         'RANDOM BANK' zu betätigen ('ERZEUGE EINE BANK PER ZUFALL' hat
         leider nicht ganz in das Gadget hineingepaßt).

         Im nachfolgenden Requester kann man auswählen, ob man eine ganze
         SoundBank oder nur einen Teil davon erzeugen möchte.

         Betätigt man 'Ganze Bank' so ist nur noch ein StartWert einzugeben
         (-32000 bis +32000) und fertig.

         Betätigt man 'Einen Teil der Bank' so ist die untere und obere 
         Grenze (0 bis 40)  und danach wieder der StartWert einzugeben
         (-32000 bis +32000), fertig.





                                       VI
                     --------------------------------------
                             EINE SOUNDBANK EDITIEREN
                     --------------------------------------


         Hat man eine SoundBank geladen/empfangen, so stehen in ESQape1.5G
         folgende Bearbeitungs-Funktionen zur Verfügung:


         Einen Sound kann man durch einen Mausklick (linke Taste !) über
         seinen Namen direkt anwählen.
         Solange die Maustaste gedrückt ist, wird der Name invertiert
         dargestellt.
         Läßt man die Maustaste los, so erscheint immer die entsprechende
         Soundnummer invertiert, um anzuzeigen, wo man sich gerade befindet.

         Der Name des angewählten Sounds wird in dem 'SOUNDNAME' - String-
         Gadget angezeigt.
         Nun kann man hier immer einen neuen Namen eingeben (+ RETURN
         drücken!), um so auf einfachste Weise einen Sound umzubenennen.
         Beachten sollte man allerdings hierbei, daß der ESQ-1 nur 6-Zeichen
         lange Namen zuläßt (wird von ESQape1.5G automatisch abgefragt), die
         zudem alle groß geschrieben sein müßen (wird von ESQape1.5G automa-
         tisch konvertiert, man kann also alles auch klein schreiben !).
         Weiterhin kann das Display des ESQ-1 nicht alle ASCII- (Sonder-)
         Zeichen darstellen.
         Hier sollte man ein bischen herumexperimentieren.



         >>> WEITERE OPTIONEN:

         
         >S> 'SOUND SENDEN' **************************************************

         Zwischen dem 'ICONS'- und dem 'SOUNDNAME'- Gadget befindet sich
         ebenfalls ein Gadget, welches zu Anfang mit 'S' für SENDEN
         beschriftet ist.
         
         Dies heißt nichts anderes, als daß ein angewählter Sound automatisch
         an den EDIT-Puffer des ESQ-1 gesendet wird - der vorherige EDIT-Puffer
         wird allerdings gelöscht !
         Der Sound kann nun am ESQ-1 weiter bearbeitet werden.
         Um das andauernde Senden zu verhindern, sollte man auf ESQape1.5G
         einfach einen anderen MIDI-Kanal, als am ESQ-1 anwählen.


         >A> 'SOUND AUSTAUSCHEN' *********************************************

         Drückt man nun einmal auf dieses Gadget, so steht dort nun 'A' für
         AUSTAUSCHEN und der Mauszeiger wechselt sein Aussehen auf 'EX' für
         EXCHANGE (engl. für AUSTAUSCHEN).
         Nun kann man zwei beliebige Sounds innerhalb der SoundBank
         gegeneinander austauschen indem man irgeneinen Namen anwählt
         (der Mauszeiger jetzt sein Aussehen auf 'TO' für deutsch WOHIN)
         und danach einen zweiten Namen anwählt.
         Diese zwei Sounds werden also in ihren Positionen innerhalb der Bank
         ausgetauscht.
         Tauscht man einen Sound mit sich selbst aus, so passiert im Endeffekt
         nichts - dies ist eine Möglichkeit, um einen Austauschvorgang
         abzubrechen, falls man aus Versehen einen Namen angewählt hat !
 

         >L> 'SOUND LÖSCHEN' ++++*********************************************

         Drückt man noch einmal auf dieses Gadget, so steht dort nun 'L' für
         LÖSCHEN und der Mauszeiger wechselt sein Aussehen.
         Man kann nun leicht irgendeinen Sound innerhalb der SoundBank
         löschen, indem man einfach den betreffenden Namen anwählt.
         Der gelöschte Sound erhält den Namen : '*DEL* ' für DELETED (engl.
         für gelöscht).


         >K> 'SOUND KOPIEREN' ************************************************

         Drückt man noch einmal auf dieses Gadget, so steht dort nun 'K' für
         KOPIEREN und der Mauszeiger wechselt wieder sein Aussehen.
         Der Vorgang funkioniert ähnlich wie beim Austauschen:
         Sound, den man kopieren möchte anwählen (der Mauszeiger ändert sich
         wieder, uff !), danach Position/Sound anwählen, wohin dieser erste
         Sound kopiert werden soll, fertig.
         Kopiert man einen Sound zu sich selbst , so passiert im Endeffekt
         nichts - dies ist eine Möglichkeit, um einen Kopiervorgang
         abzubrechen, falls man aus Versehen einen Namen angewählt hat !





                                      VII
                     -------------------------------------
                       ALLE SEQUENZEN VOM ESQ-1 EMPFANGEN
                     -------------------------------------

         Hierzu ist bitte das entsprechende Gadget vonESQape1.5G zu betätigen.

         Es wird jetzt ein DUMP-REQUEST an den ESQ-1 gesendet und auf die
         Antwort vom ESQ-1 gewartet, daß dieser bereit ist, die Daten zu
         senden.

         Falls Daten empfangen werden, merkt man dies sofort daran, daß man den
         Mauszeiger nicht mehr bewegen kann (die 'midi.library' hat hier nun
         höchste Priorität).
         (Je nach Größe und Auslastung des Sequenzen-Speichers am ESQ-1 kann
         der Empfangs-Vorgang u.U einige Zeit dauern !)

         Die empfangenen Daten werden in einer Datei Namens 'T:ESQape.temp'
         o.ä, ZWISCHENGESPEICHERT.

         Ist alles in Ordnung, so wird eine SATISTIK über die Anzahl der em-
         pfangenen MIDI-Bytes angezeigt. 
         Der ESQ-1 überträgt hier übrigens eine GERADE Anzahl von MIDI-Bytes
         VARIABLER Länge.
         Sollte im Requester etwas anderes stehen, so kanns'te das  Ganze
         haken und alles noch einmal probieren.
         
         Andernfalls ist der darauf folgende FileRequester zu benutzen.
         Nun bitte einen Namen eingeben, unter dem die Sequenzen abgespeichert
         werden sollen und dann mit 'OK' betätigen.
         Je nach Stellung des 'ICONS' - Gadgets wird nun auch ein
         entsprechendes Icon für die Sequenzen mit abgespeichert, welches man
         dann einfach nur 2mal anzuklicken braucht, um die Sequenzen wieder zu
         senden.
         (Es hat keinen Sinn inkorrekte Sequenzer-Daten abzuspeichern !) 

         Ein Fehler ist aufgetreten, falls sich nach einiger Zeit nichts tut,
         oder der Mauszeiger beim Bewegen ruckelt, oder die STATISTIK nicht 
         automatisch von selbst erscheint.

         Nun bitte den GANZEN VORGANG EINFACH DURCH DRüCKEN EINER MAUSTASTE 
         ABBRECHEN, die Einstellungen am ESQ-1 und auf ESQape1.5G überprüfen
         und das Ganze noch einmal probieren.

         >>> !!! HINWEIS !! <<<
         >>>
         >>> Ich empfehle, den gesamten Vorgang zweimal zu machen, um sicher 
         >>> zu sein, daß immer eine gleiche Anzahl von MIDI-Bytes empfangen
         >>> wird !





                                      VIII
                     -------------------------------------
                        ALLE SEQUENZEN ZUM ESQ-1 SENDEN
                     -------------------------------------

         Hierzu ist bitte das entsprechende Gadget vonESQape1.5G zu betätigen.

         Nun erscheint wieder der File-Requester; hiermit ist jetzt die ent-
         sprechende Sequenzen-Datei auszusuchen, welche man an den ESQ-1
         senden möchte und danach 'OK' zu betätigen.

         ESQape1.5G ermittelt die Größe der Datei und sendet nun einen
         Request darüber an den ESQ-1, wieviele MIDI-Bytes übertragen werden.

         Da die Größe des Sequenzen-Speichers des ESQ-1 je nach Speicherer-
         weiterung sehr variieren kann, sendet dieser eine Meldung zurück, ob
         die Sequenzen-Daten auch wirklich in den internen Speicher passen.

         Falls ESQape1.5G eine positive Meldung erhalten hat, wird der
         Übertragungsvorgang nun gestartet.

         Sollte eine negative Meldung eintreffen, so meldet ESQape1.5G in
         einem Requester, daß der ESQ-1 nicht genug Speicher zum Empfang der
         Daten hat und bricht den Vorgang ab.

         Sollte überhaupt keine Antwort seitens des ESQ-1 eintreffen, so wird
         die ganze Prozedur abgebrochen, worüber wieder ein Requester
         Aufschluß gibt.
         In diesem Falle empfehle ich, alle MIDI-Verbindungen/Kanäle noch
         einmal zu überprüfen und - ich kann es nicht oft genug betonen -
         nachzusehen, ob der ESQ-1 für den Empfang System-Exklusiver Daten
         eingestellt ist (bitte Punkt: 2.e) INSTALLATION nachlesen !).
         Diesen Fehler habe ich selbst sehr oft gemacht, obwohl ich das Programm
         am besten kennen sollte !
         
         >>> !!! HINWEIS !!! <<<
         >>>
         >>> Wählt man eine Datei an, die keine Sequenzen-Daten enthält,
         >>> so wird ein Request an den ESQ-1 über die Größe der Datei
         >>> gesendet und je nach der erhaltenen Antwort werden die Daten 
         >>> auch Übertragen.
         >>> 
         >>> MAN MUß ALSO SELBST DARAUF ACHTEN, DAß MAN DIE RICHTIGEN
         >>> SEQUENZER-DATEN ÜBERTRÄGT !!!





                                       IX
                     -------------------------------------
                               DIE ICON-FUNKTIONEN
                     -------------------------------------

         Falls das ICON-Gadget aktiviert ist, werden bei jedem
         Abspeichervorgang auch ICONS für die jeweilige Datei mit
         abgespeichert, die jedoch nicht ohne Funktion sind !

         Beim Abspeichern von SoundBänken wird ein 'BANK-ICON' abgespeichert,
         bei Sequenzen entsprechend ein'SEQUENCE-ICON' und bei
         System-Exklusiv-Daten anderer MIDI-Geräte (kommt noch) ein
         'SysEx-ICON'.

         Diese ICONS haben den Vorteil, daß man sie nur noch 2mal anzuklicken
         braucht, um die entsprechenden Daten über MIDI zu senden.
         Man muß also, z.B, nicht extra ESQape1.5G hochfahren, nur um eine
         abgespeicherte SoundBank an den ESQ-1 zurückzusenden.
         Entsprechend gilt dies also auch für Sequenzen und SysEx-Daten.

         Das Senden der verschiedenen Daten wird durch drei auf dieser
         Diskette mitgelieferte Hilfs-Programme bewerkstelligt.

         Im Einzelnen handelt es sich hierbei um:

         - BankToESQ     ; sendet eine SoundBank zum ESQ-1.

         - SequenceToESQ ; sendet eine Sequenzen-Datei zum ESQ-1.

         - SysExToMIDI   ; sendet eine beliebige System-Exklusiv-Datei über
                           MIDI an das angeschlossene Gerät.
         

         Im DEFAULT-TOOL des 'BANK-ICONS' steht folglich : BankToESQ
         Im DEFAULT-TOOL des 'SEQUENCE-ICONS' steht      : SequenceToESQ
         Im DEFAULT-TOOL des 'SysEx-ICONS' steht         : SysExToMIDI

         Beim 'BANK-ICON' und beim 'SEQUENCE-ICON' kann man unter TOOL-TYPES
         noch den MIDI-Kanal einstellen.
         Dazu bitte das entsprechende ICON einmal anklicken und sodann aus dem
         Workbench-Menü den Menüpunkt 'Info' anwählen.

         Unter TOOL-TYPES sollte hier nun stehen : MIDICHANNEL=1
         Dies ist die Voreinstellung, kann aber mit 'DEL' aus dem 'Info' -
         Fenster auch gelöscht werden - es wird dann alles über den MIDI-KANAL
         1 gesendet.

         Möchte man einen anderen MIDI-Kanal einstellen, so muß man nur :

                                     MIDICHANNEL=x
                          (x steht für eine Zahl von 1..16 !)
         eingeben.
         
         Zum Abspeichern dieser Einstellung bitte 'SAVE' aus dem 'Info' - 
         Fenster anwählen!

         Beim 'SysEx-ICON' hat TOOL-TYPES keine Bedeutung !

         Die drei Hilfsprogramme können aber auch aus dem CLI heraus
         aufgerufen werden - können sich z.B im C-Verzeichnis der
         Boot-Diskette befinden:


         -  BankToESQ  Dateiname  [MIDI-Kanal] -

            Die Angabe des MIDI-Kanals kann auch entfallen, es wird dann alles
            über Kanal 1 gesendet .
            
            >>> BEISPIEL :  BankToESQ df0:Banks/ESQ.INIT_BANK 10
            >>>
            >>>             Sendet die SoundBank 'df0:Banks/ESQ.INIT_BANK' über
            >>>             MIDI-Kanal 10 zum ESQ-1 .


         -  SequenceToESQ  Dateiname  [MIDI-Kanal] -

            Die Angabe des MIDI-Kanals kann auch entfallen, es wird dann alles
            über Kanal 1 gesendet .
            
            >>> BEISPIEL :  SequenceToESQ df0:Sequences/ESQ.MySeq_1 2
            >>>
            >>>             Sendet die Sequenzen 'df0:Sequences/ESQ.MySeq_1'
            >>>             über MIDI-Kanal 2 zum ESQ-1 .


         -  SysExTOMIDI  Dateiname -

            >>> BEISPIEL :  SysExTOMIDI df0:SysEx/D110.SND_1
            >>>
            >>>             Sendet die SysEx-Daten 'df0:SysEx/D110.SND_1'
            >>>             über MIDI zum ROLAND D-110/D-10/D-20/D-5 und zwar
            >>>             stets so, wie die Daten auch empfangen wurden .


         Alle Programme brauchen, um korrekt zu funktionieren:

         a) Im 'devs:' - Directory:
        
            - 'serial.device'

         a.1) Am seriellen Port : EIN MIDI-INTERFACE !!!

         b) Im 'libs:' - Directory:

           -  'midi.library' - siehe Copyright-Vermerk am Ende.
           -  'req.library'  - siehe Copyright-Vermerk am Ende.
           -  'icon.library'.


         Damit alles richtig funktioniert, sollten sich die Daten, die durch
         die ICON-Programme über MIDI gesendet werden im GLEICHEN VERZEICHNIS
         befinden, wie die ICON-Programme selbst.
         (Engefleischte JUHSÄ wissen dies leicht zu ändern).

         Zum Beispiel befinden sich auf dieser Diskette im Verzeichnis 'BANKS'
         die Daten verschiedener SoundBänke, als auch das Programm 'BankToESQ'
         selbst, welches die Daten beim Doppelklicken durch das ICON sendet !
         

         Ein 'BUG' sollte nicht verschwiegen werden:

         Befindet sich z.B. eine SoundBank namens: "ESQ.Bank" in einem
         beliebigen Verzeichnis, z.B. "DF0:Banks", das Sende-Programm :
         'BankToESQ' aber in einem beliebigen anderen Verzeichnis, z.B "DF0:C,
         so muß man im DEFAULT-TOOL von ESQ.Bank.info : "DF0:C/BankToESQ"
         eintragen.

         Klickt man nun 2mal auf das ICON von "ESQ.Bank", so wird zwar die
         Datei, die übertragen werden soll richtig übergeben - die Einstellung
         des MIDI-Kanals unter TOOL-Types aber nicht !!!

         Falls mir jemand sagen kann, woran das liegt, wäre ich sehr dankbar !
         Befindet sich nämlich beides im selben Verzeichnis - wie auf dieser
         Diskette - so treten diese Probleme nicht auf !

         Entsprechendes gilt auch für das Senden von Sequenzen über ICONS !






                                      X
                     -------------------------------------
                      EMPFANG VON SYSTEM-EXKLUSIVEN DATEN
                     -------------------------------------

         Wie bereits im Hinweis am Anfang angedeutet, können mit ESQape1.5G
         auch System-Exklusiv-Daten anderer MIDI-Geräte von beliebiger Länge
         empfangen, gespeichert und auch wieder zurückgesendet werden.
         Voraussetzung hierfür ist, daß das MIDI-Gerät von sich selbst aus
         seine SysEx-Daten abwerfen kann, also über einen manuellen MIDI-Dump
         verfügt - bitte in der Bedienungsanleitung des jeweiligen MIDI-Geräts
         nachsehen !

         Der Empfang geschieht folgendermaßen:

         Zuerst bitte das entsprechende Gerät über MIDI mit dem am AMIGA
         eingesteckten MIDI-Interface vebinden ( MIDI-OUT des Synthies mit
         MIDI-IN des Interfaces, die andere Verbindung ist hierbei nicht
         notwendig !).
         Nun am selben Gerät MIDI-Kanal 1 einstellen.

         Nun einfach die rechte Maustaste drücken, während sich der Maus-
         zeiger innerhalb des ESQape1.5G-Fensters befindet und dieses auch
         aktiviert ist.

         Den nun folgenden Requester entsprechend mit 'OK' (oder auch nicht)
         bestätigen.

         Es wird jetzt ein DUMP-REQUEST an den ESQ-1 gesendet und Daten des
         ESQ-1 gewartet; die Titelleiste des Fensters ändert sich auf 'Warten'.

         Es ist aber jetzt kein ESQ-1 angeschlossen, bzw. die Verbindung :
         MIDI-OUT (Interface) mit MIDI-IN (Synthi) nicht gesteckt.

         Es werden also keine ESQ-1-Daten empfangen - ESQape1.5G befindet sich
         nun in einer Warteschleife, um sämtliche über MIDI eintreffende Daten
         aufzunehmen, bis auf dem ESQape1.5G-Fenster eine Maustaste gedrückt
         wird, um den gesamten Vorgang abzubrechen/beenden .

         Bitte jetzt an dem angeschlossenen MIDI-Gerät einen SysEx-Dump
         manuell auslösen (wie, steht in der Bedienungsanleitung !).

         Falls Daten empfangen werden, merkt man dies sofort daran, daß man den
         Mauszeiger nicht mehr bewegen kann (die 'midi.library' hat hier nun
         höchste Priorität).

         Sollte dies nicht der Fall sein oder der Mauszeiger beim Bewegen
         stark ruckeln, so ist offensichtlich etwas shief gegangen.
         Nun bitte den GANZEN VORGANG EINFACH DURCH DRüCKEN EINER MAUSTASTE 
         ABBRECHEN, den nachfolgenden Requester mit 'Resume' bestätigen (was
         dort steht, ist im Moment irrelevant) und das Ganze noch einmal
         probieren.

         Der Übertragungs-Vorgang ist abgeschlossen, falls der Mauszeiger sich
         wieder normal verhält und/oder das angeschlossene MIDI-Gerät anzeigt,
         daß sein MIDI-SysEx-Dump zu Ende ist.

         In diesem Falle bitte den GANZEN VORGANG EINFACH DURCH DRüCKEN EINER
         MAUSTASTE BEENDEN !
         Es erscheint nun ein Requester, der eine STATISTIK über die
         empfangenen MIDI-Pakete, sowie über die Anzahl der gesamten Daten
         anzeigt.

         >>> !!! HINWEIS !!! <<<
         >>> 
         >>> SysEx-Daten haben ja zu ihrer Kennzeichnung als erstes Byte F0,
         >>> gefolgt von einigen Identifikations-Bytes für das jeweilige MIDI-
         >>> Gerät, danach kommen die Daten selbst (interne Sounds, Sequenzen,
         >>> andere Parameter) und als letztes Byte folgt F7.
         >>> 
         >>> Bei vielen Geräten wird dieser ganze Block in einem Rutsch
         >>> übertragen (z.B. ESQ-1, DX-7).
         >>> Folglich steht nun in der STATISTIK, daß EIN MIDI-Paket empfangen
         >>> wurde mit einer bestimmten Größe (z.B. ESQ-1 = 8166 Bytes, 
         >>> DX-7 = 4104 Bytes) .
         >>> 
         >>> Einige MIDI-Geräte (hier insbesondere die ROLAND-Geräte
         >>> übertragen ihre Daten jedoch immer in Blöcken (z.B 256 Bytes),
         >>> gefolgt von einer Pause (z.B. 20 millisekunden).
         >>> Jeder Block wird nun als einzelnes MIDI-Paket von ESQape1.5G
         >>> erkannt und dementsprechend in der STATISTIK ausgewiesen !
         >>> Beim Empfang von SysEx-Sound-Daten eines ROLAND D-110 erhielt
         >>> ich zum Beispiel 102 MIDI-Pakete mit insgesamt 26600 Bytes.
         >>> 
         >>> Ich empfehle dringend, diesen Sysex-Empfangs-Vorgang mindestens
         >>> zweimal zu machen, um sicherzugehen, daß jedesmal die gleiche 
         >>> Anzahl von MIDI-Paketen und -Bytes empfangen wird.
         >>> Natürlich immer nur beim gleichen MIDI-Gerät !!!


         Mit 'OK' können nun die emfangenen Sysex-Daten auch abgespeichert
         werden.
         In dem nachfolgenden Fielrequester bitte nun Verzeichnis und Namen
         eingeben, unter welchen man die Daten abspeichern möchte und danach
         das Gadget 'OK' im Filerequester betätigen.
         Allerdings wird jetzt auch - entspr. dem ICONS - Gadget - evtl.
         auch ein SysEx-ICON mit abgespeichert.
         Was es hiermit auf sich hat, steht in dem Kapitel :

                            IX  - DIE ICON-FUNKTIONEN

         Der nachfolgende Requester fragt nun auch ab, ob man diese
         'falschen' Daten in den aktuellen BankBuffer kopieren möchte.
         Bitte in diesem Fall 'Cancel' betätigen und man kann wieder normal
         weiterarbeiten.

         >>> !!! HINWEIS !!! <<<
         >>> 
         >>> Die SysEx-Daten werden immer so empfangen/gespeichert, wie sie
         >>> auch gesendet wurden, d.h die Einstellung des MIDI-Kanals auf
         >>> ESQape1.5 hat hierbei keine Bedeutung !
         >>> 
         >>> Möchte man die Daten nun zurücksenden, so ist es ratsam zu
         >>> wissen, mit welchem MIDI-Kanal man die Daten vorher denn gesendet
         >>> hat, da sonst vom angeschlossenen MIDI-Gerät nichts empfangen
         >>> wird !!!
         >>> Im schlimmsten Fall müßte man alle 16 MIDI-Kanäle ausprobieren -
         >>> viel Spaß !
         >>> 
         >>> Um dies zu vermeiden, empfehle ich dringend, alle SysEx-Dumps
         >>> auf MIDI-Kanal 1 zu vollziehen.
         >>> So können wir auf einfache Weise im AMIGA-Public-Domain-Bereich 
         >>> Sounds und andere SysEx-daten autauschen !!!






                                      XI
                     -------------------------------------
                       SENDEN VON SYSTEM-EXKLUSIVEN DATEN
                     -------------------------------------

         Hierzu bitte einfach das Gadget 'BANK SENDEN' betätigen.
         
         Der nachfolgende Requester fragt nun ab, ob man wirklich die aktuelle
         Bank senden möchte, bzw. eine andere (in diesem Falle SysEx-) Datei.

         Im Requester also bitte 'Nein, andere Datei senden'  anwählen.
         Nun erscheint der allseits beliebte Filerequester mit dessen Hilfe
         man die Datei aussucht, welche über MIDI gesendet werden soll.
         Nach Betätigung von 'OK' wird der Übertragungsvorgang gestartet.

         Diese Funktion ist eigentlich nur dazu gedacht, SysEx-Daten anderer
         MIDI-Geräte zu senden.
         Für ESQ-1-Daten ist es ratsamer, die dafür vorgesehenen Funktionen zu
         aktivieren.

         Eine andere Möglichkeit, auf einfache Weise SysEx-Daten zu senden ist
         in dem Kapitel :
                            IX  - DIE ICON-FUNKTIONEN
         beschrieben.

         >>> !!! HINWEIS !!!
         >>>
         >>> Die für den Empfang von SysEx-Daten notwendigen Einstellungen
         >>> sind an dem jeweils angeschlossenen MIDI-Gerät vorzunehmen;
         >>> z.B. MIDI-Kanal, Empfangs-Status usw... !
         >>>
         >>> ESQape1.5G sendet fremde Daten immer so, wie sie auch empfangen
         >>> wurden - Manipulationen sind nicht möglich, außer man schreibt
         >>> sich eigens ein Programm hierfür - viel Spaß ! (harr, harr)





                                     XII
                     -------------------------------------
                              DAS PROGRAMM BEENDEN
                     -------------------------------------


         Bitte das Gadget 'ENDE' betätigen, wonach SOFORT ESQape1.5G verlassen
         wird.

         Also daran denken, alle wichtigen Daten auch abzuspeichern, was man
         sowieso immer tun sollte - oder gehörst Du zu denjenigen Verrückten,
         die an die Unfehlbarkeit ihres Computers oder eines Computerprogramms
         glauben ??? 











                                4.) BUGS

         Ja !

         Um die Bugs zu beseitigen tue folgendes:

         Sende mir 2000 DM.- in kleinen Scheinen, damit fahre ich erstmal in
         Urlaub.
         Nach meiner kreativen Schaffenspause schicke ich Dir dafür den Quell-
         code, aber nur, falls Du KEIN C beherrscht.

         Solltest Du nach 1 1/2 Jahren soweit sein, den Programmtext, der
         keinerlei Kommentare enthält, zu verstehen, so kannst Du ja die Bugs
         selbst beseitigen.

         Schick' mir bitte dann den korrigierten Quellcode - ich werde das
         Programm sodann als Update veröffentlichen, Dich in guter Erinnerung
         behalten und Dir als Dank die Badehose von meinem Kaninchen zusenden.









                               5.) Thanks


      Mein besonderer Dank gilt Jürgen Kraus für die guten Tips und
      die vielen inspirativen Ideen, von denen einige in diesem Programm 
      ihren Niederschlag gefunden haben.

      Auch möchte ich Bill Barton danken, der die ausgezeichnete 
      'midi.library' für den AMIGA programmiert hat.

      Danke zu guter Letzt auch an C.W. Fox und Bruce Dawson, die 
      mit der 'req.library' ein unheimlich leicht zu handhabendes
      Benutzer-Interface geschaffen haben.









                                4.) BUGS

      Jetzt 'mal im Ernst:

      Bei der Übertragung von langen Sequenzer-Dateien zum ESQ-1 (über 16
      KiloByte) gehen einige Bytes manchmal verloren und der ESQ-1 erkennt die
      Daten nicht mehr an !

      Dies kann unter Umständen durch ein qualitativ hochwertiges
      MIDI-Interface (ich habe kein solches !) behoben werden.
      Auf der anderen Seite steht das 'SerialDevice' des AMIGA in dem
      schlechten Ruf für MIDI-Anwendunden nicht schnell genug zu sein und,
      gerade bei langen Blockübertragungen, einige Bytes zu verschlucken.
      Hoffentlich hat man beim neuen Betriebssystem etwas geändert !

      Ich empfehle gerade bei Sequenzen nicht immer den Speicher des ESQ-1
      vollzuhauen und dannn erst zu sichern, sondern dies Songweise zu tun,
      da hierdurch u.U eine geringere Anzahl von Daten anfällt, die auch
      problemlos übertragen werden.

      Was den Empfang von SysEx-Daten angeht, so hatte ich kürzlich ein
      seeeehhhr komisches Problem :

      Obwohl ROLAND D-110 und ROLAND D-20 das gleiche Übertragungsformat
      besitzen, konnten SysEx-Dumps vom D-20 nicht korrekt und vollständig
      empfangen werden !

      D-110-Dumps und YAMAHA DX-7-Dumps funktionierten einwandfrei !!!

      Falls jemand noch andere Fehler entdeckt, so bitte ich dringend darum,
      mir das mitzuteilen; ich bin darüber sehr dankbar !

      Weiterhin würde ich gerne erfahren, ob die SysEx-Dump-Funktion auch nit
      sämtlichen anderen MIDI-Geräten läuft.
      Also bitte eifrig testen ... und mir nach Möglichkeit mitteilen !!!









                              6.) COPYRIGHT
      
                     'ESQape1.5G' ©1990 Ilias Vassiliou.
               Nix PublicDomain, nix FreeWare, but ShährWähr !






                              7.) ShärWähr

      Falls irgendjemand, außer demjenigen, der jetzt meinen ESQ-1 hat, das 
      Programm benutzt (hallo MiBo !), so bitte ich um eine kleine Spende für
      einen kleinen Informatik-Griechen.

      Ich dachte so an DM 20.- für ESQape1.5G - ich gebe mich auch mit weniger
      zufrieden (vielleicht zwei Freikarten für's Kino).

      Für DM 20.- kriegst Du aber ein Update zu ESQape1.5G und die Quellcodes
      von den ICON-Programmen, sowie die endgültige Version von 'VirtKey1.2pre'.

      Falls Du eine Version ESQape2.0G (Demo auf dieser Diskette) mit
      integriertem ENVELOPE-Editor haben möchtest, so frag bitte zuerst an,
      wann sie fertiggestellt sein wird.








                        8.) AMIGA-PD-MIDI-SOUNDPOOL / CLUB

      Ich fände es wirklich ok, wenn sich mehrere AMIGA-MIDI-Juhsä daran
      beteiligen würden, Sounds/Samples und andere SysEx-Daten allen
      Interessenten im PD-POOL zugänglich zu machen.

      Dazu kann man bei ESQape1.5G die SysEx-Funktionen benutzen.

      Bei der riesigen Fülle von Sounds/Samples, die es für fast alle Synthies
      auf dem Markt gibt, wird es wohl nicht so schwer sein, einige - vielleicht
      selbstprogrammierte ? - Sounds/Samples auf PD-Basis zu veröffentlichen .

      Nochmal : Ich meine NICHT die für mich erbärmlichen AMIGA-Sounds,
                sondern solche für MIDI-Synthies/Sampler, oder auch
                Drum-Pattern für Rhythm-Machines als auch Begleit-Arrangements
                für einige Keyboards !

      Ich trage mich weiterhin mit dem Gedanken, einen AMIGA-MIDI-Club zu
      gründen, der allen AMIGA-MIDI-Usern (richtig !) als Anlaufstelle dienen
      soll, was Infos/Erfahrungsaustausch betrifft, bei dem man Sounds/Samples
      usw. tauschen kann und bei dem man Hinweise, Hilfe und Tips zur
      MIDI-Programmierung erhält.

      Sollte jemand hieran interesiert sein, und/oder mitarbeiten wollen, so
      möge er/sie mir das bitte mitteilen und auch, was er/sie weiterhin von
      solch einem AMIGA-MIDI-CLUB alles erwartet !

      Das Gründen/Gelingen einer solchen Interessensgemeinschaft hängt nun
      ganz stark von Eurer Beteiligung ab, es lohnt nicht, alles nur für 5
      bis 10 Leute zu veranstalten.

      Also nicht herumsitzen und abwarten, sondern einfach 'mal eine Postkarte
      schreiben (Frankfurter Adresse !) und sich einen ablabern !!!
      Los ! Auf! Jetzt sofort !








                               9.) CONTACT

                              Ilias Vassiliou
                              Frankfurter Str. 22
                              6092 Kelsterbach/Main

                                 oder eher:
                              Ilias Vassiliou
                              c/o Ch. Lehmann
                              Zeißelstraße 5
                              6000 Frankfurt/Main 1






  =========================================================================

  COPYRIGHT AND DISTRIBUTIONS
  --------- --- -------------

  The MIDI Library is Copyright (c) 1987, 1988, Pregnant Badger Music.
  All rights reserved.  The MIDI Library may be used in and included with 
  commercial products with the following provisos:

    1. Pregnant Badger Music should be kept informed of your intent to 
       release products that make use of the MIDI Library so that we may 
       keep you informed of changes, updates, etc.

    2. The above copyright notice should be included somewhere in the 
       documentation accompanying any such commercial products.

  Bill Barton
  Pregnant Badger Music
  1111 El Sur Way
  Sacramento, CA  95864
  (916) 487-9472

  Bix:  peabody
  PLink:  peabody


  ==========================================================================

  RequesterLibrary/Req.library

  Official release of version 1.2, October '89


  Req.library  is Copyright ©1989, 1990 by C.W.  Fox and Bruce Dawson.
  It is freely  distributable.  No charge may be made for it's distribution,
  except for a nominal media fee.

  Feel free to distribute and use this library with your programs, along
  with a notice that the library is 'FreeWare'.

  ==========================================================================
