  ***************************************************************************
  ********                                                           ********
  ********             DOKUMENTATION ZU: MIDI-PANIC(V1.2)            ********
  ********                                                           ********
  ***************************************************************************


                          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 !) :

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




                             3.) Das Programm :

      MIDI-Panic ist ein Programm mit dem man gezielt MIDI-Nachrichten senden
      kann, um 'abgestürzte' MIDI-Instrumente wieder zu regenerieren.
      Viel mehr gibt es hierzu nicht zu sagen, da die Bedieneroberfläche
      selbsterklärend ist.

      Mit dem MIDI-Gadget (und den Pfeilen rechts daneben) bitte den aktuellen 
      MIDI-Kanal einstellen.

      In dem Gadget darunter kann man einstellen ob die nachfolgenden
      MIDI-Nachrichten immer auf dem gerade angewählten MIDI-Kanal (CURRENT)
      oder aber ungeachtet dessen auf allen MIDI-Kanälen (ALL) gesendet werden.
      Beim Anklicken dieses Gadgets 'kippt' der Zustand jeweils.

      'ALL NOTES OFF'
      sendet den entsprechenden MIDI-Befehl um an den angeschlossenen MIDI - 
      Geräten sämtliche Noten stummzuschalten.
      Einsatzgebiet: Die berühmten MIDI-Notenhänger.

      'ALL NOTES OFF PER NOTE'
      - es gibt zahlreiche ältere MIDI-Instrumente, die den ALL NOTES OFF -
      Befehl nicht implementiert haben.
      Hierbei wird nun jede einzelne MIDI-Note (0 - 127) durch das Senden von
      Anschlagdynamik (Velocity, auf deutsch) gleich null (0) 'manuell'
      stummgeschaltet.

      'RESET ALL CONTROLLERS'
      sendet den entsprechenden MIDI-Befehl um an den angeschlossenen MIDI - 
      Geräten sämtliche Controller zurückzusetzen.
      Hierzu gehören z.B. PitchBend, Modulation, Panorama, Expression, usw.
      Einsatzgebiet: 'Controller-Hänger' .

      'RESET EACH CONTROLLER'
      - es gibt zahlreiche ältere MIDI-Instrumente, die den obigen Befehl 
      nicht implementiert haben.
      Hierbei wird nun jeder einzelne MIDI-Controller auf seinen Initialwert
      gesetz ( meist 0, PitchBend und Panorama erhalten den Mittelwert 64). 

      'SYSTEM RESET'
      sendet den entsprechenden MIDI-Befehl um die angeschlossenen MIDI - 
      Geräte zu Initialisieren, sie in den Zustand nach dem Einschalten zu
      bringen.
      Zahlreiche Geräte haben diesen Befehl noch nicht implementiert !
      Einsatzgebiet: MIDI-Viren (harr, harr).

      'MEGAPANIC'
      sendet alle obigen MIDI-Nachrichten auf sämtlichen MIDI-Kanälen
      ungeachtet der Einstellung 'CURRENT' oder 'ALL'.
      Einsatzgebiet: Totales Chaos -> Total Recall.


      Die nachfolgenden MIDI-Befehle sind sog. SystemRealtime-Messages und
      werden nicht nach dem MIDI-Kanal unterschieden, sondern haben immer bei
      allen angeschlossenen MIDI-Geräten Wirkung (sofern sie erkannt werden).


      'TUNE REQUEST'
      veranlaßt bei allen angeschlossenen MIDI-Instrumenten (Synthis) ein
      Auto-Tuning - meist wird hier der globale Stimmungs-Wert auf den
      ursrünglichen ab Werk eingestellt.
      Zahlreiche Geräte haben diesen Befehl noch nicht implementiert !
      Einsatzgebiet: Totale Verstimmung.

      'SEQUENCER START/STOP/CONTINUE'
      ich glaube hierüber muß ich keine weiteren Worte verlieren.
      Hinweis:
      Manche Sequencer (gerade, die in manchen 'WÜrgstations') peilen diese
      Befehle nur, falls sie sich in der Synchronisations-Einstellung MIDI
      befinden (z.B. ROLAND D-20).
      Dann erwarten diese jedoch ebenfalls die entsprechenden MIDI-Clock-
      Impulse, um sich auf das richtige Tempo einzustellen und sich zu
      synchronisieren.
      Da von MIDI-Panic keine Clock-Impulse gesendet werden, passiert hier bei
      den entsprechenden Sequencern rein gar nichts.

      
      Extras:

      'ICONIFY'
      öffnet links oben auf den Workbench-Screen ein Mini-MIDI-Panic-Window.
      Einmal anklicken und schon ist alles wieder da.
      Man kann allerdings durch das Close-Gadget des Mini-Windows das Programm
      auch ganz verlassen.

      Bei Einstellung 'ALL' (siehe oben) wird in der Titelleiste des Windows
      angezeigt, auf welchem MIDI-Kanal gerade gesendet wird.
      Dieser Sende-Vorgang kann jederzeit durch Betätigung der rechten
      Maustaste unterbrochen werden.





                              4.) COPYRIGHT
      
                 'MIDI-Panic(V1.2)' ©1990 Ilias Vassiliou.
                           This is PublicDomain !




                               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




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

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

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