http://sourceforge.net/apps/trac/pspkvm/wiki/UsingTheSemichordalBoard

= Using the semichordal virtual keyboard =

The semichordal board allows you (as of this writing) to enter Roman, Cyrillic, and Greek text, with a range of diacritics (accents and related modifiers). The following describes some of the functions.

== Fast confirm/cancel (OK/Cancel from keyboard) ==

The heavy 'return arrow' on left-shoulder-centre-dpad-triangle acts as confirm/okay key (selects the 'OK' command currently active--usually finishes text entry completely, takes you all the way back to the calling midlet--though this is somewhat dependant on the midlet implementation).

The x in a circle on left-shoulder-centre-dpad-circle acts as a cancel key (selects the 'CANCEL' command currently active--usually cancels text entry).

== Switching the keymap ==

The semichordal board opens in your default key map (see VirtualKeyboards). However, you can switch to another (to enter Cyrillic, Roman, or Greek text when this is not your default map) keymap with the switch keymap (Map switching key for semichordal board) key.

== Entering diacritic marks ==

To add diacritic marks to a character you've just entered, press one of the diacritics keys (shows as an 'x' character with the diacritic above it) immediately after entering it (or at any time, just with the caret to the right of the character).

Note that you can 'stack' diacritics on some characters. As in: press the macron key to add the macron mark, then press the acute accent key to add the accent above the macron.

== Entering ligatures ==

The ligature key (two 'x' characters together) permits you to bind the previous two keys before the caret together, to form a ligature, where there is such a ligature. For example, enter A then E and press the 'xx' key--this will create an AE ligature.

== Switching display modes ==

The semichordal board opens by default in a 'half map' (shows approx. 72 keymappings) mode for fullscreen text boxes, and in a 'one chord' (shows the current 4 keymappings) mode for one-line text fields. To switch this view (you can set it to half map, one chord map, or invisible), press the display key (Display key icon for semichordal board).

(Note that the display key is up-right-dpad/left-shoulder/circle on all maps, so you can always find it even when the display is off.)

== Switching to the symbol map for one keystroke ==

You can switch the board to the symbol map for just one keystroke by pressing the 'one shot' symbol () key. This is particularly useful for entering diacritics and symbols that aren't on your main keymap. Press the fast shift key, press the diacritic or symbol key, and your keyboard will come back to the map you shifted up from after the diacritic or symbol is inserted.

== Locking to the symbol map ==

Especially for entering numerical data, locking the map to the symbol map can be convenient. Press the symbol lock key (Symbol lock for semichordal board) to do this. To return from the symbol map, press the return to main (picture needed) key.

== Toggling caps lock ==

All main keymaps provide a caps lock key. In all of them, it looks like this: (Caps lock key for semichordal board). Press it once to turn it on, again to turn it off.

== Select, Paste, and Copy keys ==

The sdit, paste, and copy keys look like this: (Copy and page keys, Select key).

== Page up, page down, home, end, and cursor keys ==

Directional keysThe semichordal boards all have page up, down, home, end, and cursor keys. The cursor keys display as single arrows; the page up, page down, home, and end keys appear as double-headed arrows. In boards in which the cursor keys are not grouped with page up/down et al, right-shift with left or right cursor also lets you skip through text word by word.