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

= Virtual Keyboards in PSPKM =

Whenever you need to edit or enter text when using a Midlet, the VM will pop up a 'virtual keyboard' you use for this purpose. You can, as of this writing, select from five such keyboards in PSPKVM.

PSPKVM virtual keyboards (with the exception of the OSK) support selection, copying, and pasting of text. See UsingTheClipboard for more information.

== Configuring the virtual keyboard setup ==

In builds prior to 0.5.4 test 6, you configured the virtual keyboard setup from the .ini file (pspkvm.ini). In 0.5.4 test 6 and after, you configure it from the Configure VM midlet. Go to Configure VM -> Virtual keyboard setup:

[[Image(configuringboards.png, border=1)]]

== Analog cursor option ==

Setting 'Analog cursor' on in the configuration screen means the QWERTY and AWF variant boards (AWF/Default, AWF/Chinese, and AWF/Float) will use the analog stick to move the cursor in the text pane, and the cursor keys to navigate within the virtual keypad. Setting it off inverts this scheme (analog stick navigates within the boards, cursor keys move within the text pane).

Turning 'Analog cursor' off also disables use of the analog stick for text pane navigation in the semichordal board.

The control has no effect in the Danzeff virtual board.

== Auto-open ==

Turning auto-open on means the virtual keyboards (excepting the OSK) pop up without being called up from a menu as soon as you start editing a text pane. Turning it off means you have to start the keyboards yourself from the menus. The default/shipped configuration in previous builds (in the .ini file) was on, and full/minimal packages will still ship with this value set on.

Auto-open has no effect when using the Sony OSK.

== AWF ==

As of this writing, this is the default board. It is particularly useful for entering Chinese, Japanese, and Korean (CJK) characters. Its layout is a little like a Danzeff board (in non-CJK mode), but it uses arrow keys to select the key  group.

In the VM configuration midlet, you can enable AWF either with AWF/Default (opens in Latin character mode) or AWF/Chinese (opens !in PinYin mode).

=== pspkvm.ini settings for AWF virtual board ===

(For builds prior to 0.5.4 Test 6 only--subsequent builds use the VM configuration midlet to select the keyboard)

In the .ini, this keyboard is enabled if no other keyboard is set ({{{com.pspkvm.inputmethod}}} isn't set).

When this keyboard is in use, you can also set:

{{{com.pspkvm.inputmethod = vk-chinese}}}

... to ensure that this keyboard comes up in CJK input mode first when editing text.

== AWF/Chinese ==

Setting AWF/Chinese in the GUI means you get the AWF virtual keyboard, but it opens by default in Pinyin mode.

== AWF/Float ==

As of 0.5.4 test build 11 (and in the official 0.5.4 release), there's a new 'AWF/Float' option in the VM configuration menus. This sets up a compact version of the AWF board that 'floats' over the text the same way the Danzeff and semichordal boards do. See [wiki:AWFFloat the AWF/Float] page for a few more details. Note that when this board is selected, you can choose from the Pinyin, Stroke, and Roman entry modes as the default (starting) mode in a separate menu.

== Danzeff ==

[[Image(danzeff.png, right, border=1)]]As of 0.5.4 test build 7, there's a 'Danzeff' style virtual board available. This is a common disc-style virtual board that uses the analog stick to select the active keygroup. The PSPKVM implementation has a few additional keys to support the cross-MIDlet clipboard and a 'return' key for entering text in multiline textfields--you can find them on the standard 'number pad' in the Danzeff-style board.

There are no .ini file settings for the Danzeff-style board, as it only appears in builds that use the VM Configuration control panel to set the virtual keyboards. To use it, just open this panel from the AMS and select it in the virtual keyboards setup menu.

== OSK ==

This is the built-in PSP virtual board. It supports a wide range of input modes and scripts.

Note that FW 1.5 users can '''not''' use the OSK, and the auto-open option does not work for the OSK.

=== pspkvm.ini settings for OSK virtual board ===

(For builds prior to 0.5.4 Test 6 only--subsequent builds use the VM configuration midlet to select the keyboard)

{{{com.pspkvm.inputmethod = sony-osk}}}

== QWERTY ==

The QWERTY virtual board has a layout a lot like a standard typewriter keyboard. This was the original virtual board in PSPKVM. Note that as of Release build 0.5.4, the QWERTY board 'floats' over the content, as do all the other virtual boards, and is slightly smaller, having no text pane within the board.

=== pspkvm.ini settings for QWERTY virtual board ===

(For builds prior to 0.5.4 Test 6 only--subsequent builds use the VM configuration midlet to select the keyboard)

{{{com.pspkvm.inputmethod = vk-qwert}}}

== Semichordal ==

This board uses the dpad and the shoulder buttons to set up 'chords', a little bit like the chordal keys of a courtroom stenotype, and the symbol keys to do entry. It is extremely fast (fun fact: this page--including these very words--was originally entered with this keyboard, using Opera Mini on the PSPKVM), but difficult to learn. It supports Roman, Cyrillic, and Greek scripts as of this release, all with a wide range of diacritics (accents) supported, and so should generally be useful for any language using those alphabets.

The semichordal board supports a number of advanced editing/navigation functions in addition to the clipboard extensions. See UsingTheSemichordalBoard for more information. See UsingTheClipboard for details on the clipboard functions that are available.

There is a demo video for the semichordal board [http://www.dailymotion.com/video/xabkn9_semichordal-keyboard-demonstration here].

=== pspkvm.ini settings for semichordal virtual board ===

(For builds prior to 0.5.4 Test 6 only--subsequent builds use the VM configuration midlet to select the keyboard)

{{{com.pspkvm.inputmethod = vk-semichordal}}}

For builds supporting Greek and Cyrillic methods, you can also set up the starting keymap for the semichordal board, when this board is in use. The relevant settings are:

{{{com.pspkvm.virtualkeyboard.default_keymap = cyrillic}}} for Cyrillic,
{{{com.pspkvm.virtualkeyboard.default_keymap = greek}}} for Greek, and
{{{com.pspkvm.virtualkeyboard.default_keymap = roman}}} for Roman.

The default if there is no value in this field is Roman.