KAWAI K4 EDITOR V1.0   (c) 1990 by Jan Saucke
---------------------------------------------

Kontaktadresse:   Jan Saucke
                  Hermannstal 112
                  2000 Hamburg 74
                  (West) Germany

Zunchst einige generelle Informationen:

         Dieses Programm ist Shareware, mit Zusendung eines 10 DM
         Scheines erwerbt Ihr das Nutzungsrecht (Namen nicht ver-
         gessen, damit ich wei, wer das Geld geschickt hat)

         Die Programmteile "MULTI-Editor" und "EFFECT-Editor" sind
         in Arbeit und fast fertig. Wer eine Programmversion mit
         SINGLE-MULTI-EFFECT-Editor haben mchte, kann sich an die
         oben genannte Kontaktadresse wenden. Er bekommt sie dann
         incl. Diskette und Sourcecode fr 25 DM per Nachnahme
         (Bitte keine Vorauskasse)

         Natrlich freue ich mich auch ber Feedback in Form von
         selbstgemachten KAWAI-K4-Sounds, Fehlermeldungen und Ver-
         besserungsvorschlgen. Schickt einfach alles an mich !

Nun einige Stichworte zur Programmumgebung:

         -die Verzeichnisstruktur auf der Diskette sollte nicht
          verndert werden
         -sie mu mindestens wie folgt aussehen:
                 devs (dir)
                     serial.device
                 libs (dir)
                     midi.library
                 Midi (dir)
                     All (dir)
                     SingleOne (dir)
                     KawaiEditor
                     KawaiEditor.info
                     KawaiEditor.txt
         -ein Beispiel fr eine Startup-Sequence ist:
                 setmap d
                 addbuffers df0: 30
                 cd midi
                 KawaiEditor
         -ein All-Dump bentigt auf der Diskette 15123 Bytes,
          ein Single-Dump 140 Bytes.
         -der KAWAI K4 sollte auf Receive-Ch 1 und Transmit-Ch 1
          stehen
         -im Programm wird die Kenntnis der KAWAI Begriffe voraus-
          gesetzt. Am besten legt Ihr beim herumprobieren das Hand-
          buch vom KAWAI-Keyboard in Reichweite, damit Ihr die
          Funktion einiger Parameter nachlesen knnt.
         -(Ach ja, der Editor ist leider noch nicht Multi-Tasking-fhig)

Und jetzt zum eigentlichen Programm:

         Es ist in verschiedene Programm-Ebenen unterteilt, von denen
         zur Zeit der All-Level und der Single-Level implementiert
         sind (Multi- und Effect-Level s.oben, Drum-Level folgt).

Der All-Level:

         Nach dem Start ist der Editor im All-Level, es stehen
         folgende Funktionen bereit:

         RECEIVE  ALL - veranlat das angeschlossene Keyboard, einen
                        All-Dump zu senden, den der AMIGA received und
                        zum verndern im RAM bereit hlt.
                        (Solange die Datenbertragung luft, erscheint
                        "BUSY" auf dem Bildschirm, danach "DUMP RE-
                        CEIVED bzw. bei ausgeschaltetem oder nicht
                        angeschlossenem Keyboard eine Fehlermeldung)
         TRANSMIT ALL - sendet einen All-Dump vom AMIGA zum KAWAI,
                        dieser All-Dump kann zuvor von Diskette
                        geladen oder vom KAWAI received und/oder
                        im AMIGA-Speicher verndert worden sein.
         LOAD ALL     - es wird ein All-Dump von Diskette geladen.
                        Dazu erscheint ein File-Requester mit einem
                        vorgegebenen File-Namen, dieser Name kann aber
                        auch beliebig verndert werden.(Ebenso der Pfad)
         SAVE ALL     - siehe LOAD, aber hier wird gespeichert.
         DELETE ALL   - hiermit kann ein All-Dump auf der Diskette
                        gelscht werden (Vorsicht! Weg ist weg...)
         GOTO SINGLE  - Wechsel der Programmebene in den Single-Level
         GOTO MULTI   - (in Vorbereitung)
         GOTO DRUM    - not yet
         GOTO EFFECT  - (in Vorbereitung)
         QUIT         - Editor verlassen (Vorsicht! Weil diese Funktion
                        auf dem Bildschirm eh schon so abseits liegt,
                        habe ich auf eine Sicherheitsabfrage verzichtet)

         Bevor man in den Single-Level geht, ist es sinnvoll, als Arbeits-
         grundlage einen All-Dump zu laden oder zu receiven.

Der Single-Bank-Level:

         Hier kann man eine Single-Bank aus 64 Single-Sounds zusammen-
         basteln und ausdrucken, damit man spter beim spielen die
         bersicht behlt.

         RECEIVE  BANK - (not yet)
         TRANSMIT BANK - (not yet)
         PRINT BANK    - die Single-Bank kann ausgedruckt werden (falls
                         doch nicht gedruckt werden soll, kann man durch
                         anklicken von "CANCEL" abbrechen. Wenn wirklich
                         gedruckt werden soll, auf "DRUCKEN" klicken)
                         (Der Platzbedarf ist etwa 1/2 DIN-A 4 Seite)
         LOAD BANK     - (not yet)
         SAVE BANK     - (not yet)
         DELETE BANK   - (not yet)
         COPY SINGLE   - zum kopieren eines Single-Sounds mu dieser
                         zunchst einmal kurz angeklickt werden, damit
                         er selectiert ist. Dann "COPY SINGLE" anklicken
                         und danach die Position anklicken, an der die
                         Kopie abgelegt werden soll.
         SWAP SINGLE   - um zwei Single-Sounds zu tauschen, wird erstmal
                         einer selectiert (einmal kurz angeklickt), dann
                         "SWAP SINGLE" angewhlt, danach ein zweiter
                         Single-Sound angeklickt, fertig !
         LOAD SINGLE   - hiermit wird an die Stelle eines selectierten
                         Single-Sounds einer von Diskette geladen.
         MENU BACK     - zurck zum All-Level

         Die fehlenden LOAD/SAVE etc. Funktionen knnen umgangen werden,
         indem man nach vollzogener nderung einen Level zurck in den
         All-Level geht und die gewnschte Funktion hier anwhlt (dann
         wird eben nicht nur die BANK, sondern alles bertragen).          Um vom Single-Bank-Level in den One-Single-Level, den eigentlichen
         Sound-Editor-Level zu gelangen, braucht nur ein bereits selectierter
         Single-Sound einmal oder irgend ein anderer SIngle-Sound zweimal
         angeklickt werden

Der One-Single-Level:

         In diesem Level knnen die Single-Sounds endlich editiert werden.
         Neben den reinen Sound-nderungen sind wieder die folgenden
         Funktionen mglich:

         RECEIVE      - ein Single-Sound wird vom Keyboard empfangen.
                        Dabei wird das Keyboard automatisch auf den ak-
                        tuellen Single-Sound umgeschaltet (fr Insider:
                        per Program-Change, damit Editor und Keyboard nicht
                        aus Versehen mal an zwei verschidenen Sounds arbeiten)
         TRANSMIT     - der aktuelle Single-Sound wird ans Keyboard ber-
                        tragen.
         PRINT        - druckt die Werte eines Single-Sounds aus (Der
                        Ausdruck entspricht in etwa dem Beispiel aus dem
                        KAWAI-Handbuch, der Platzbedarf betrgt
                        eine DIN-A 4 Seite)
         CLEAR        - der aktuelle Single-Sound wird gelscht und auf
                        Null gesetzt (nur im AMIGA Speicher, wird allerdings
                        direkt nach CLEAR transmitted, so ist auch der
                        Single-Sound im KAWAI gelscht. Logisch !)
         LOAD         - ein Single-Sound wird geladen und gleichzeitig
                        ans Keyboard bertragen. So kann man sehr schnell
                        viele Sounds von der Diskette ausprobieren.
         SAVE         - ein Single-Sound wird auf Diskette gespeichert.
         DELETE       - ein Single-Sound wird von Diskette gelscht.
         MENU BACK    - zurck in den Single-Bank-Level, der aktuelle
                        Single-Sound wird mit allen nderungen in den
                        All-Speicher des AMIGA bernommen
         UNDO+BACK    - zurck in den Single-Bank-Level, hierbei wird der
                        Single-Sound aber nicht in den All-Speicher ber-
                        nommen, alle nderungen gehen verloren, der Sound
                        im All-Speicher wurdenicht verndert.

         - Die nderungen der einzelnen Parameter werden sofort ans Keyboard
           gesendet, so da die Auswirkungen sofort am Keyboard hrbar sind.
         - Manche Parameter haben werksmig illegale Werte (diese sind
           laut Handbuch garnicht mglich, die Erfahrung zeigt aber, da
           sie berhaupt keinen Unterschied zu erlaubten Werten haben)
         - Da das Verndern der einzelnen Paramter im Programm immer nach
           dem selben Schema abluft, erlutere ich im Folgenden nur den
           allgemeinen Arbeitsablauf, sowie einige Besonderheiten mancher
           Parameter:

         - Zum ndern eines Parameters wird dieser einfach im mittleren
           Bildschirmteil angeklickt. Daraufhin erscheint im oberen Bild-
           schirmteil das Eingabefeld, welches je nach Parameter unterschied-
           lich aussieht.
                 - ein Eingabebalken kann einfach innerhalb des weien
                   Kastens mit gedrckter Maustaste verndert werden.
                   Links oder rechts auerhalb des weien Kastens angeklickt,
                   verndert sich der Eingabewert jeweils um +/- eins.
                   Falls ein ZERO-Feld vorhanden ist, setzt das Anklicken
                   dieses Feldes den Eingabewert auf Null.
                 - eine Multiple-Choice-Eingabe erfolgt einfach durch an-
                   klicken der vorgegebenen Worte.
         - Bei der Eingabe erscheinen im unteren Bildschirmteil einige
           tiefergehende Informationen zu den Daten, die zwischen AMIGA
           und KAWAI bertragen werden (ADRESSE,PARAMETER,BITMUSTER siehe
           auch Handbuch KAWAI-MIDI-Implementation)
         - Das Editieren eines einzelnen Parameters wird beendet, indem
           man im mittleren Bildschirmteil einen anderen zu editierenden
           Parameter anklickt oder im unteren Bildschirmteil eine der oben
           genannten Funktionen anwhlt (LOAD, SAVE etc.)

         - Besonderheiten:

         - Um eine andere Single-Nummer auszuwhlen kann man LOAD, RECEIVE
           oder den Single-Namen anklicken. Im Eingabe-Bildschirm-Teil er-
           scheinen 64 Mglichkeiten von A1 bis D16, nach anklicken einer
           dieser Mglichkeiten wird zum entsprechenden Sound gewechselt

         - Der Name eines Sounds kann ebenfalls durch anklicken des Single-
           Namen gendert werden .(Neben den Mglichkeiten von A1 bis D16
           erscheint in einem weien Kasten der aktuelle Name. Dieser kann
           gendert werden, indem man innerhalb dieses Kastens die Maustaste
           drckt. Dann erscheint ein Cursor und der neue Name kann einge-
           geben werden.)

         - Die Felder S1 S2 S3 S4 dienen zur Auswahl der zu editierenden
           Stimme (siehe KAWAI Handbuch).

         - Mir den Feldern FILT1 und FILT2 wird der zu editierende Filter
           ausgewhlt  (Fr Insider: Filter 2 wird zur Zeit nicht ber
           Parameter gesendet, die nderungen sind also nicht sofort, sondern
           erst nach einem extra Single-TRANSMIT/RECEIVE hrbar. Dies ist
           vielleicht ein Programmierfehler von KAWAI oder meine Dummheit.
           Wer also wei, wie man die Daten des zweiten Filters mit
           Parametertransmit bertragen kann, der melde sich !)

         - Die aktuelle Wellenform der aktuellen Stimme erscheint in Klar-
           text (s. KAWAI-Handbuch) unter dem Text "DCO..."


So, nun viel Spa beim probieren und nicht vergessen: Eigene Sounds, Fragen,
Anregungen und eventuell eigene KAWAI K4 Editoren gleich zu mir...
