*******************************
*                             *
*       Text aus der Serie    *
*    (c) GERMAN  (Copyright)  *
*        RHEIN-MAIN-SOFT      *
*          Oberursel          *
*                             *
*******************************

____________________________________________________________________________
                                                                            
                   Dokumentation zum Programm »KME«                         
                    ©  Christian Stiens, 15-Jul-91                          
                                                                            
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯


1. Umfang des Pakets

  · KME.mod       - Der Quelltext in Oberon
  · KME.dok       - Diese Dokumentation
  · KME           - Das ausführbare Programm
  · Iconify.mod   - Das Iconify-Modul von Steffen Köhler
  · Iconify.dok   - Die Dokumentation dazu


2. Copyright

Das gesamte Paket ist Freeware. Es darf beliebig oft kopiert und
weitergegeben werden, solange:

  · Das Paket vollständig und unverändert bleibt
  · Mit der Weitergabe des Pakets in keiner Weise ein Gewinn erzielt wird

Siehe auch die Copyrightbestimmungen von Steffen Köhlers Iconify-Modul.


3. Sinn und Zweck des Programms

Mit diesem Programm können Sie die AMIGA-KeyMaps editieren.


4. Bedienungsanleitung

Starten Sie das Programm entweder von CLI / Shell oder von der Workbench.
In der oberen Hälfte des KME-Windows sehen Sie nun die Tastatur
des Amiga 500/2000/3000. Die Tasten können Sie entweder mit der Maus
anklicken als auch durch Drücken der entsprechenden Taste auf Ihrer
echten Tastatur anwählen.
In den acht String-Gadgets in dem rechten unteren Viertel des KME-Windows
kann man sehen, welche Zeichen die angewählte Taste zusammen mit den
jeweiligen Qualifiern (Shift, Alt, Ctrl,...) beim Betätigen der Taste sendet.
Indem Sie die Inhalte der String-Gadgets verändern, können Sie die Belegung
der aktuellen Taste modifizieren.
Steuerzeichen in den Strings werden dabei wie folgt dargestellt:

  \n      Line-feed         (0AX)
  \t      Tabulator         (09X)
  \f      Form-feed         (0CX)
  \r      Carriage-return   (0DX)
  \b      Backspace         (08X)
  \e      Escape            (1BX)
  \[      CSI               (9BX)
  \\      das Zeichen "\"
  \xHH    das Zeichen mit der Hexzahl HH (0HHX)

In dem linken unteren Viertel des KME-Windows finden Sie 5 Reihen mit
Bool-Gadgets. Die oberste und unterste Reihe sind Funktionsgadgets
mit denen Aktionen wie Laden, Speichern u.s.w. durchgeführt werden
können. Die 3 mittleren Reihen sind die Kontroll-Gadgets mit deren
Hilfe die Parameter für den aktuellen Key bestimmt werden.

Die Funktionsgadgets:

  LOAD:
    Der Filerequester erscheint und Sie können eine Keymap anwählen, die
    Sie modifizieren möchten.

  SAVE:
    Der Filerequester erscheint und Sie können wählen, unter welchem
    Namen Sie Ihre geänderte Keymap speichern möchten.

  ABOUT:
    Zeigt den Info-Requester.

  QUIT:
    Beendet das Programm nach eventueller Sicherheitsabfrage.

  ICONIFY:
    Hiermit kann man das KME-Fenster "iconifizieren". Reaktivierung
    erfolgt durch einen Doppelklick auf's Icon.

  UNDO:
    Macht die Änderungen des aktuellen Keys rückgängig.

Die Kontrollgadgets:

  SHIFT, ALT, CONTROL:
    Hiermit wird festgelegt, durch welche Qualifier-Tasten der aktuelle
    Key beeinflußbar ist. Eine Besonderheit ist zu beachten:
    Wenn SHIFT, ALT und CONTROL gesetzt sind, aber weder DEAD noch
    STRING gesetzt sind, ergibt sich das Zeichen, das beim Drücken
    der aktuellen Taste zusammen mit der Ctrl-Taste gesendet wird durch
    Löschen der Bits 5 bis 7 desjenigen Zeichens, das die Taste ohne
    Ctrl senden würde.

  DOWNUP:
    Der aktuelle Key sendet sein Zeichen erst beim Loslassen der Taste.
    Bei meinen Versuchen hat dies nicht richtig funktioniert (Kickstart 1.2).

  DEAD:
    Der aktuelle Key ist ein Dead-Key. Die acht Bool-Gadgets auf der rechten
    Seite bestimmen jeweils, ob der String-Inhalt eine Deadkey-Tabelle ist
    (MOD), ob der String-Inhalt einen Offset für die Deadkey-Tabelle
    darstellt (DEAD) oder ob der String-Inhalt ein einzelnes Zeichen ist.
    Die Deadkey-Tabelle ist in der Regel 6 Zeichen lang, nur die deutsche
    Keymap verwendet eine 18 Zeichen lange Tabelle, um auch doppelte
    Deadkeys verarbeiten zu können.

  STRING:
    Der aktuelle Key ist ein String-Key, d.h. er kann einen String statt
    nur ein einzelnes Zeichen senden.

  NOP:
    Der aktuelle Key ist ein NOP-Key, d.h. beim Drücken der Taste wird
    kein Zeichen gesendet (z.B. die Shift- Alt- und Amiga-Tasten).

  CAPSABLE:
    Bestimmt, ob der aktuelle Key durch die Caps-Lock Taste "gecaps" werden
    kann.

  REPEATABLE:
    Bestimmt, ob der aktuelle Key bei längerem Niederhalten wiederholt wird.


5. Hinweis

Wenn Sie Ihre modifizierten Keymaps mit SetMap laden möchten, sollten
Sie beachten, daß die Keymap nur dann geladen wird, wenn nicht vorher
schon eine Keymap mit gleichem Namen geladen worden ist.


6. Anwendungen

  · Wen es wie mich stört, daß man den häufig benötigten Apostroph ("'")
    nur umständlich über Alt-ä bekommt, kann ihn z.B. auf die Taste "`"
    legen. Das Zeichen "`" erhält man dann trotzdem noch, nämlich
    über Alt-`.

  · Häufig benötigte Befehle (z.B. Dir) kann man auf die Funktionstasten
    legen.

  · Die Taste PrtSc (Alt-* auf dem Numeric-Key-Pad) kann man mit dem
    String "Run GraphicDump\r" belegen.

  u.s.w.


Viel Spaß !!!

--- Chris



*******************************
*                             *
*       Text aus der Serie    *
*    (c) GERMAN  (Copyright)  *
*        RHEIN-MAIN-SOFT      *
*          Oberursel          *
*                             *
*******************************