  ***********************************************************************
  ********                                                       ********
  ********KURZDOKUMENTATION ZUR DEMO-VERSION DES ESQ-1/M-EDITORS.********
  ********                                                       ********
  ***********************************************************************



  1.) Benötigte Hardware:
      Ein CommodoreAMIGA, Modell 500/1000/2000/2500/3000 mit mindestens
      Kickstart 1.2(2.0) im ROM.

  2.) Installation:
      Folgende Files müßen sich auf der Boot-Diskette befinden:

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

           b) Im 'libs:' - Directory:
              -  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.

           c) Ein Verzeichnis 'Modules:' und darin das File 'ColorReq'.

           d) Im 's:' - Directory das File '.colors'.
              (Wird vom 'ColorReq'- Modul angelegt, falls nicht vorhanden,
               's:' muß aber vorhanden sein !).
   
           e) In RAM: oder RAD: oder VD0: muß das Directory 'T:' existieren.

           f) In der 'startup.sequence' müßen folgende Zeilen stehen:

                       c:SetPatch r >NIL:
                       STACK 16384
                       ASSIGN T: RAM:T ; oder RAD:T oder VD0:T
                       ASSIGN MODULES: SYS:Modules

              Es ist empfehlenswert, die vorhandene startup.sequence in
              groben Zügen zu übernehmen.

  3.) Das Programm:

      Zum Start des Demo-Programms nach dem Doppelklick des Icons auf
      der Workbench, oder aufruf vom cli, einfach mit der Maus auf das
      große 'O' des 'ATOMIC' - Logos klicken.

      Es erscheint nun die vorläufige Hauptseite des Editors, auf der 
      in der vorliegenden Version noch keine direkte Funktion implemen-
      tiert ist.

      Die bisher implementierten Funtionen werden im folgenden kurz be-
      sprochen und sind grundsätzlich über die Menü-Leiste und den 
      AMIGA-typischen Tastenkombinationen aufzurufen.

      Auf der MIDI-Seite voll Implementiert sind bisher:
        - Im EDIT-Menu : 'Editing Envelopes'
        - Im MIDI-Memu : 'Get Bank'
        - Im MISCELLANEOUS-Menu : 'SoundCheck - >VirtualKeyboard'

     Alle Werte-Veränderungen werden am ESQ-1/M in Echtzeit ausgeführt.
     Es ist darauf zu achten, daß am ESQ-1/M eine Parameter-Edit-Seite
     im Display zu sehen ist, z.B. ENV1 anwählen ! 
     Weiterhin muß in der MIDI-Page beim ESQ-1 'ENABLE' folgendes stehen :

                              'KEYS+CT+PC+SS+SX'   !!!
                              ------------------------

      Nun zu den einzelnen Menüs:

      a) PROJECT - (LOAD,SAVE,SAVE AS,DELETE,PRINT,INFO,QUIT)

         - Disketten I/O :
           Laden,
           Speichern,
           Löschen von SoundBanks oder anderen Files auf Diskette.

         - Drucken der ESQ1/M-Sound-Parameter, sowie MIDI-Hex-Dumps.

         - Information über die vorliegende Version und den noch
           verbleibenden Speicherplatz.

         - Verlassen des Programms.

     b) EDIT - (EDIT ENVELOPES,RANDOM MASK,MIX BUFFERS,COPY PARAMETERS,
                EDIT SOUNDBANKS)

         -  Start des EnvelopeEditors.

            Da die Hüllkurven beim ESQ-1/M eine der wichtigsten Einrich-
            tungen zur Soundgestaltung sind, wurde ihnen ein relativ
            umfangreicher Programmteil gewidmet. 

            Nach dem Start des Programmteils erscheint ein Fenster, das
            etwa den halben Bildschirm einnimmt.
            Die erste Hüllkurve, sowie die zugehörigen Parameter des
            aktuellen Sounds oder Sound-Puffers sind graphisch zu sehen.

            Die rechte TOOL-Leiste dient zur Anwahl der Hüllkurven-
            Funtionen.
   
            Das Editieren geschieht folgendermaßen:
            Der zu verändernde Parameter kann durch einen Klick auf den 
            entsprechenden Parameter-Namen (T1...T4,L1...L3,LV,T1V)
            angewählt werden - In der Titelleiste des Windows steht,
            welchen man gerade editiert.
            Man kann aber auch direkt einen Wert in die zugehörigen
            STRING-Gadgets schreiben, RETURN drücken und somit den
            Parameter anwählen und gleichzeitig ändern.
 
            Zum Verändern der Werte gibt es noch folgende Möglichkeiten:
            Zum Einen das PROPORTIONAL-Gadget am rechten Fensterrand,
            zum Anderen kann man 'MOUS' aus der TOOLBOX anwählen, was
            zur Folge hat, daß nun durch einen Klick der linken Maustaste
            im großen weißen Bereich der angewählte Parameter heraufge-
            zählt wird, während ein Klick auf die rechte Maustaste den 
            Wert verringert.

            Die vier Hüllkurven eines Sounds können durch die links
            unten im Fenster befindlichen PfeilGadgets angewählt werden.

            Zur TOOLBOX :

            SWAP    negiert die Level-Parameter (L1...L3).
            COPY    öffnet einen Requester, der es erlaubt, Hüllkurven
                    - auch von veschiedenen Puffern - hin und her zu
                    kopieren.
            RVRS    spiegelt die Hüllkurve symmetrisch in der Mitte
                    (genauer : an L2).
            RANDM   öffnet einen Requester, der es erlaubt, die gerade
                    aktuelle Hüllkurve per Zufall zu bestimmen, oder
                    - noch nicht implementiert - einen ZufallsMaske
                    zu verwenden; wird mit 'RANDOM MASK' erstellt.
            PRSET   öffnet einen Requester, der es erlaubt, Preset-
                    Hüllkurven auszuwählen und zu benutzen.
            C/E     steht für 'COMPRESS/EXPAND'; öffnet einen Requester,
                    der es erlaubt, die aktuelle Hüllkurve in der Zeit
                    oder in der Lautstärke zu dehnen und zu stauchen.
            MOUS    wurde schon besprochen.
            OVDB    öffnet einen Requester, der es erlaubt, alle vier
                    Hüllkurven graphisch übereinanderzulegen und so im
                    Verhältnis zueiander zu betrachten.
            UNDO    macht die letzte Werte-verändernde Aktion rückgägngig.

         -  Erstellen einer Zufalls-Maske.

         -  Mischen von Sound-Parametern.

         -  Kopieren von Parametern.

         -  Editieren verschiedener SoundBanks (BANKMANAGER).


     c) MIDI - (MIDI-CHANNEL,GET SOUND,SEND SOUND,GET BANK,SEND BANK
                GET SEQUENCE,SEND SEQUENCE,GET ALL SEQUENCES,
                SEND ALL SEQUENCES, MIDI-HEX-DUMP)

         -  Anwahl des Midi-Kanals.

         -  Empfangen und Senden des aktuellen Sounds.

         -  Empfangen und senden der aktuellen Bank.

         -  Empfangen und senden der aktuellen Sequenz.

         -  Empfangen und senden aller aktuellen Sequenzen.
 
         -  Empfangen und senden von beliebigen MIDI-Nachrichten.

         Implementiert ist 'Get Bank':

         Nach der Anwahl aus dem Menu erscheint ein Fenster auf der
         linken Seite des Bildschirms.
         Drückt man in diesem Fenster die rechte Maus-Taste, so wird
         nach einer Sicherheits-Abfrage ein Dump-Request gesendet
         und auf die Daten vom ESQ-1/M gewartet (Auf den gleichen
         MIDI-Kanal achten !); sollte irgendetwas schiefgelaufen sein,
         so kann man durch Drücken der linken Maustaste den Vorgang
         abbrechen.

         Werden alle Daten richtig empfangen, so werden alle vierzig
         Soundnamen angezeigt und die Bank kann mit 'SAVE BANK'
         abgespeichert werden.

         Man kann aber auch beliebige andere Daten empfangen:

         - rechte Maustaste drücken,
         - dann Requester mit 'OK' bestätigen,
         - an einem beliebigen MIDI-Gerät einen manuellen MIDI-Dump
           auslösen (sofern in dem Gerät implementiert !),
         - wenn in der Titel-Leiste des Windows 'Done.' steht und
           die Maus wieder bewegbar ist, die linke Maustaste drücken,
         - zum Abspeichern der Daten, den nun erscheinenden Requester
           mit 'OK' bestätigen,
         - im File-Requester Filenamen eingeben oder auswählen und 
           'SAVE' oder RETURN im File-STRING-Gadget drücken,
         - den nachfolgenden Requester nur dann mit 'OK' bestätigen,
           wenn man einen manuellen Bank-Dump am ESQ-1/M ausgelöst
           hat un die Daten in den Bank-Puffer schreiben will -
           ansonsten hat es ja keinen Sinn - es passiert aber auch
           nichts tragisches.


     c) MISCELLANEOUS - (SET COLORS,INIT SOUND,INIT BANK,RESET ESQ1,
                         DO PANIC,SOUNDCHECK,CARDRIDGE,WORKBENCH,
                         SAVE CONFIGURATION)

         - Farben des Editor-Bildschirms setzen - ist als eigener
           Prozess implementiert und kann sich die ganze Zeit auf
           dem Bildschirm befinden, ohne etwas zu beeinträchtigen -
           wird bei Verlassen des Programms automatisch entfernt.

         - Sound und Bank initialisieren.

         - ESQ-1/M booten (Total Reset).
         
         - ALL-NOTES-OFF senden.

         - Mit 'Soundcheck' kann ein virtuelles Keyboard als eigener
           Prozess gestartet werden und kann sich die ganze Zeit auf
           dem Bildschirm befinden, ohne etwas zu beeinträchtigen -
           wird bei Verlassen des Programms automatisch entfernt.

         - Cardridge-Funktionen des ESQ-1/M unterstützen.

         - WORKBENCH-Bildschirm an- und ausschalten; funktioniert
           nur, wenn auf dem Workbench-Screen kein anderes Fenster
           offen ist.

         - Abspeichern der vom Benutzer erstellten Arbeitsumgebung.


         >>> HINWEIS <<<
         >>> In dieser Demo-Version, die allerdings relativ alt (März '90) ist,
         >>> sind nicht alle MIDI-Funktionen implementiert.
         >>> Falls die Resonanz auf das Programm groß ist (und man dafür auch
         >>> etwas bezahlen will, z.B DM 60.-), werde ich es weiterentwickeln.
         >>> Falls nicht, so habe ich auch etwas besseres zu tun (harr, harr).


  4.) 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.



  5.) 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
      
  =========================================================================

  6.) COPYRIGHT AND DISTRIBUTIONS
      --------- --- -------------

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

  'ESQ-1/M-Editor.Demo' © 1989/1990 Ilias Vassiliou.
   Nix PublicDomain, nix ShareWare, nix FreeWare but frei kopierbar und 
   auch nix Kost !

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

  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'.

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