Kvkbd"> xmodmap"> Caps"> Alt Gr"> ]> TodorGyumyushevyodor1@gmail.com GuillaumeMartressmarter@ubuntu.com 2007-2014 Todor Gyumyushev 2008 Guillaume Martres &FDLNotice; 2021 0.4.8 &tde; &kvkbd; is a virtual keyboard for &tde; TDE Kvkbd keyboard virtual accessibility &kvkbd; is a simple virtual keyboard for &tde;. It can be used with, or instead of, a physical keyboard or for devices with a touch screen but no keyboard. It is also useful for displaying a keyboard mapping to identify what characters are defined. When first launched, &kvkbd; will appear in the bottom-right corner of the screen. It can be moved by clicking and dragging on any part of the background area. Resize it by clicking and dragging on the stripes at the bottom right. The default style will be the system style which can be overridden whether launched from the command line or via the .desktop file with any &tde; or &TQt; style installed on the system. Example: kvkbd --style plastik, as shown here. The button on the top right is used to hide the keyboard - to show it again, just click on the tray icon. French keyboard: The AD11 key, ringed, is a dead key. To use the numeric keypad, click the double arrow on the right. The Num pad display can be toggled by clicking on the Num Lock key №. To display and select the shift characters:  • Click either &Shift; key, which will 'lock', and the shift characters will be displayed.  • Then click on the character to print it. Spanish keyboard shift characters: 3rd & 4th level characters which are printed using &AltGr; & &AltGr;+&Shift; as modifier keys, can be displayed and printed in a similar way. There are therefore four sets of characters which can be displayed - Lower  &Shift;  &AltGr;  &AltGr;+&Shift; For each of these, &Caps; will toggle the case of alpha characters where a lower/upper pair is defined in UnicodeData.txt && &TQt; && libX11. The &kvkbd; configuration menu is accessible by clicking on the configuration button or by right clicking on the tray icon. Select "Font" to choose the font used to display the characters and text on the keys. Allows selection of the style and size. Check "Auto Resize Font" for the font size to change as the keyboard is resized. Select "Background color" to choose a colour for the keyboard background. Select "Key color" to choose a colour for the keys/buttons. Check "Dock Widget" to display a small dock which can be placed anywhere on screen. Click on the dock to hide or show the virtual keyboard. Check "Lock on screen" to fix the position and size of the keyboard on the screen. The &kvkbd; keyboard is based on the US layout with an extra key to the right of Left &Shift; for non-US keyboards - the extra key duplicates the '<' and '>' characters on the US keyboard. For non-US keyboards, the key which is normally lower left of the &Enter; key is placed above the &Enter; key. &AltGr; will enable selection of the character mapped to the lower right of any key, and &AltGr; &Shift; for any upper right character where they have been set up in the keyboard mapping file [<path_to>/X11/xkb/symbols/]. Note that there are two possible gotchas in displaying the &AltGr; characters:   • they tend to be less commonly used and might not have glyphs in the font being used,   • the keyboard mapping file needs to include "level3(ralt_switch)" for the variant being used. The &Shift;, &Ctrl;, Alt* keys 'lock' when clicked to simulate holding down a key on a physical keyboard. Whether the *Win keys 'lock' will depend on the build time option chosen. Using &Shift; and/or &AltGr; which need press and hold on a physical keyboard will need click only for &kvkbd;. For example, using the AD11 key [ ˆ ] on the oss variant of the French keyboard: setxkbmap fr -variant oss Character: dead_circumflex  dead_diaeresis dead_tilde dead_abovering K/B press: ˆ o &Shift;+¨ u &AltGr;+ˆ e &AltGr;+&Shift;+¨ a &kvkbd; click:  ˆ o &Shift; ¨ u  &AltGr; ˜ e  &AltGr; &Shift; ° a Printed: ô ü ẽ å Note that &kvkbd; is compiled for keycodes defined by evdev » /etc/X11/xkb/keycodes/evdev. &kvkbd; will have reduced functionality in systems using another keycode definitions file which can be checked by: • running xev in a konsole • pressing or clicking Menu • looking for keycode 135 among the output A similar function to dead keys, but they follow the handwriting sequence of character+diacritic. For example, using the AE12 key [ ´ ] on the ru-recom variant of the German keyboard: setxkbmap de -variant ru-recom Character: combining acute  combining grave combining dot below ́combining dot above K/B press: o ´ u &Shift;+` e &AltGr;+´ a &AltGr;+&Shift;+` &kvkbd; click:  о ´ у &Shift; `  е &AltGr; .  а &AltGr; &Shift; ˙ Printed: о́ у̀ е̣ а̇ &kvkbd; doesn't work with &tdm;. Use with other Display Managers by editing /etc/.../Xsetup. Add this: HOME=/root kvkbd --loginhelper There is no configuration button in the loginhelper mode. To change the default config, launch &kvkbd; as root: tdesu kvkbd and make the changes there from the configuration menu. &kvkbd; is run without the --loginhelper option when run from a konsole. Add kvkbd.desktop to the &tde; Autostart directory for &kvkbd; to run when &tde; starts. For a specific keyboard layout: [§]  Exec=setxkbmap <xx>;kvkbd Or, with &xmmp;: [as in the example]  Exec=setxkbmap <xx>;&xmmp; -e 'keycode 133=quotedbl';&xmmp; -e 'keycode 134=asterisk';kvkbd Or, including the setxkbmap compose option:  Exec=setxkbmap -option compose:menu <xx>;xmodmap -e 'keycode 133=quotedbl';xmodmap -e 'keycode 134=asterisk';kvkbd [§] See /etc/X11/xkb/rules/evdev.lst for a list of layouts, variants, and options. &kvkbd; will dynamically switch keyboard layouts as they are changed, either through the command line, with setxkbmap, or using the &tde; Keyboard Tool. Refer to the &kxkb; Handbook for details on keyboard layout switching. Using the compose option for setxkbmap, it could be useful for example to set Menu as the compose key to set up user specified characters or character strings. Add the Euro symbol for a US keyboard [¹] • Add <Multi_key> <e> <r> : U20AC # "€" EuroSign to ~/.XCompose [²] • Run setxkbmap -option compose:menu us • Start a new konsole or editor • Click Menu e r .. and € should be displayed Add a shortcut for a frequently used text string • Add <Multi_key> <t> <r> : "&tde; rocks" to ~/.XCompose • Run setxkbmap -option compose:menu <xx> • Start a new konsole or editor • Click Menu t r .. and &tde; rocks should be displayed Assign keycodes &xmmp; can be used to assign keycodes to any key. If &kvkbd; has been built for the Win keys not to function as modifier keys, they can conveniently be used for frequently used characters which might otherwise be more cumbersome to generate. For example, the " and * characters on a gb keyboard are &Shift;+2 and &Shift;+8, and they could be assigned to the Win keys: &xmmp; -e 'keycode 133=quotedbl' &xmmp; -e 'keycode 134=asterisk' Then LWin would print " and RWin would print * [¹] To emulate a keyboard where the Euro sign is engraved on the 5 key, setxkbmap us -variant euro and &AltGr; 5 would be more appropriate. [²] This is an easier combination to enter than the other Euro options in /usr/share/X11/locale/<LOCALE>/Compose, which doesn't include this combination.     However, if ~/.XCompose 'includes' /usr/share/X11/locale/<LOCALE>/Compose, any duplicated compose sequences in ~/.XCompose will have priority. Create a character that doesn't have a direct unicode mapping, but is composed of unicode characters in the font being used. As an example -- a-ogonek 'ą' [U0105] + combining acute '´' [U0301]́ Add the character and chosen key combination to the ~/.XCompose file: • echo "<Multi_key> <space> <a> : \"$(printf '\u0105\u0301')\" # aogonek + combining acute" >> ~/.XCompose Test: • Run setxkbmap -option compose:menu <xx> • Start new editor • Print the character:   Menu space a → ą́ &kvkbd; Program Copyright © 2007-2014 Todor Gyumyushev yodor1@gmail.com Program and Documentation Copyright © 2008 Guillaume Martres smarter@ubuntu.com &underFDL; &underGPL; For your own build of &kvkbd;, see the INSTALL file. &documentation.index;