======Maps====== The TextBlade comes with a number of pre-configured maps to support major language variants; however, one of its great strengths is the ability to customize maps to suit particular preferences via the TextBlade app (as long as you have the **MultiMap** capability). At the moment the TextBlade app is only available on Apple iOS devices (iPhone, iPad, iPod), but there are plans for it to be ported to other OS's in the future. WayTools provide a library of pre-configured maps which can be used either as-is, or as the starting point for any customization you want to make. The library is held on the WayTools servers so they can easily add new maps or alter existing ones. The current list of standard Library maps (as of October 2018) are called: {{:maps:qwerty.jpg?100}} [[qwerty|QWERTY]] {{:maps:uk.jpg?100}} [[uk|UK]] {{:maps:qwertz.jpg?100}} [[qwertz|QWERTZ]] {{:maps:azerty.jpg?100}} [[azerty|AZERTY]] {{:maps:spanish.jpg?100}} [[spanish|Spanish]] {{:maps:portuguese.jpg?100}} [[portuguese|Portuguese]] {{:maps:italian.jpg?100}} [[Italian|Italian]] {{:maps:swedish.jpg?100}} [[Swedish|Swedish]] {{:maps:finnish.jpg?100}} [[finnish|Finnish]] {{:maps:danish.jpg?100}} [[danish|Danish]] {{:maps:norwegian.jpg?100}} [[norwegian|Norwegian]] {{:maps:dvorak.jpg?100}} [[dvorak|Dvorak]] {{:maps:colemak.jpg?100}} [[colemak|Colemak]] {{:maps:emoji.jpg?100}} [[emoji|Emoji]] {{:maps:qwerty_num.jpg?100}} [[qwerty_num|QWERTY Num]] {{:maps:emacs_both.jpg?100}} [[emacs_both|Emacs Both]] {{:maps:emacs_pinky.jpg?100}} [[emacs_pinky|Emacs Pinky]] Click on the name of one of the above if you want to see the details of that particular map. It is presumed that WayTools are likely to offer custom key tops corresponding to most (if not all) of the standard default maps). On that basis points to note are: * The 'white' letters on the keytops correspond to the standard Alpha layer (and where relevant the Alpha shift layer). * The 'green' symbols on the keytops correspond to the standard Green layer (and where relevant the Green shift layer). * The left blade has engraved indications of the chord to be used for the Media, Select and Edit layers. The right blade has engraved meanings for the standard Edit layer (and thus Select layer where relevant). * However since none of these keytops have (yet) been shipped to TREG testers (all current TREG units ship with QWERTY keytops) the above points are only supposition. The TextBlade app provides the ability to print out a PDF version of the images associated with any of the above list of maps. This can be useful as a ‘cheat sheet’ as you get to learn the less frequently used parts of any map. You can do the same with any customised maps that you produce. One point to note that this will not include Jump Slot Settings, or any Macros you have set up (other than an indication of letters have associated macros) so you need to keep these documented separately if you want a ‘cheat sheet’ for those. =====Customizing a Map===== When producing customized maps the normal alphanumeric characters can be assigned simply by tapping on the location you wish to assign and then typing the character on an existing keyboard. There are also a lot of special characters that are available for assigning to key positions. In addition, common keyboard shortcuts are assigned so that they can always be keyed the same way regardless of the target operating system. The symbols available are organized in a scrollable window with blocks of related symbols. The ones currently available are: {{:maps:keystrip1.jpg?600|}} {{:maps:keystrip2.jpg?350|}} {{:maps:keystrip3.jpg?700|}} {{:maps:keystrip4.jpg?140|}} {{:maps:keystrip5.jpg?190|}} {{:maps:keystrip6.jpg?160|}} {{:maps:keystrip7.jpg?290|}} {{:maps:keystrip9.jpg?250|}} {{:maps:keystrip10.jpg?550|}} {{:maps:keystrip11.jpg?290|}} {{:maps:keystrip15.jpg?400|}} {{:maps:keystrip12.jpg?1000|}} {{:maps:keystrip13.jpg?440|}} {{:maps:keystrip16.jpg?100|}} {{:maps:keystrip14.jpg?140|}} The following tables gives more information what each of these selections does. Note that Modifiers can be used in conjunction with any non-modifier sequence. The table is in the order that the characters are displayed on the selection strip. ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_shift.jpg?30|}} |Shift |Provides shift to next character typed. Operates in 'Sticky mode so it does not have to be held down while next character is typed| | {{:maps:key_cmd.jpg?30|}} |Command |Modifier widely used on MacOS and iOS. Tends to be the equivalent in many cases of the C key used on Windows. On a jump slot set for Windows/Linux this key is treated as the the Win key. | | |Win |Win | | {{:maps:key_alt.jpg?30|}} |Alt/Option|Modifier widely used on all OS. Often combined with other modifiers |Option |Option |A |A |A | | {{:maps:key_ctrl.jpg?30|}} |Control |Modifier widely used on Windows and Linux. On iOS/MacOS the CMD key tends to be used instead |C |C |C |C |C | | {{:maps:key_tab.jpg?30|}} |Tab | |Tab |Tab |Tab |Tab | Tab | | {{:maps:key_homescreen.jpg?30|}} |Home Screen | | |Home\\ Button\\ CH | | {{:maps:key_enter.jpg?30|}} |Enter | | | {{:maps:key_backspace.jpg?30|}} |BackSpace |Deletes character before cursor| | {{:maps:key_del.jpg?30|}} |Del |Deletes next character |Del |Del |Del |Del |Del | | {{:maps:key_delprevword.jpg?30|}} |DelPrev |Deletes previous word |ABackSpace|ABackSpace|CBackSpace |CBackSpace |CBackSpace | | {{:maps:key_delnextword.jpg?30|}} |DelNext |Deletes next word | | |CDel | | {{:maps:key_delstartline.jpg?30|}} |DelStart |Deletes to Start of Line | |Del| | {{:maps:key_delendline.jpg?30|}} |DelEnd |Deletes to End-of-Line | | {{:maps:key_esc.jpg?30|}} |Escape | | ==Edit Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_cut.jpg?30|}} |Cut |Removes the selected text and puts it on the clipboard | x | x | Cx | Cx | Cx | Cx | | {{:maps:key_copy.jpg?30|}} |Copy |Copies the selected text to the clipboard | 'C' | 'C' | Cc | Cc | Cc | Cc | | {{:maps:key_paste.jpg?30|}} |Paste |Inserts the text from the clipboard | V | V | CV | Cv | Cv | Cv | | {{:maps:key_all.jpg?30|}} |Select All |Selects all available items | a | a | Ca | Ca | Ca | Ca | | {{:maps:key_undo.jpg?30|}} |Undo |Undoes the last edit | z | z | Cz | Cz | Cz | Cz | | {{:maps:key_redo.jpg?30|}} |Redo |Redoes the last edit | Sz | Sz | CSz | CSz | CSz | CSz | ==Navigation Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_left.jpg?30|}} |Left |Moves cursor left | Left | Left | Left | Left | Left | Left | | {{:maps:key_right.jpg?30|}} |Right |Moves cursor right | Right | Right | Right | Right | Right | Right | | {{:maps:key_up.jpg?30|}} |Up |Moves cursor up | Up | Up | Up | Up | Up | Up | | {{:maps:key_down.jpg?30|}} |Down |Moves cursor down | Down | Down | Down | Down | Down | Down | | {{:maps:key_fastback.jpg?30|}} |Previous Word | |ALeft|ALeft| CLeft | | {{:maps:key_fastright.jpg?30|}} |Next Word | |ARight |ARight| CRight | | {{:maps:key_fastup.jpg?30|}} |Beginning of line | |Left|Left| Home | | {{:maps:key_fastdown.jpg?30|}} |End of line | |Right|Right| End | | {{:maps:key_pageup.jpg?30|}} |Page Up | | | | Page Up | | {{:maps:key_pagedown.jpg?30|}} |Page Down | | | | Page Down | | {{:maps:key_paraprev.jpg?30|}} |Previous paragraph | | | | CUp | | {{:maps:key_paranext.jpg?30|}} |Next paragraph | | | | CDown | | {{:maps:key_docstart.jpg?30|}} |Beginning of document | |Up|Up| CHome | | {{:maps:key_docend.jpg?30|}} |End of document | |Down|Down| CEnd | ==Search Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_findprev.jpg?30|}} |Previous match |Go to previous match in current document | | | SF15 | | {{:maps:key_find.jpg?30|}} |Find match | | | | Cf | | {{:maps:key_findnext.jpg?30|}} |Next match |Go to the next match in current document | | | F3 | ==App Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_tabnew.jpg?30|}} |New tab | | | | SC T | | | | | {{:maps:key_tabprev.jpg?30|}} |Previous tab | | | | SCTab | | | | | {{:maps:key_tabnext.jpg?30|}} |Next tab | | | | CT | | | | | {{:maps:key_tabclose.jpg?30|}} |Close tab | Close current tab or window | | | C W | | | | | {{:maps:key_windowprev.jpg?30|}} | |Previous Window in Current app | | | CT | | | | | {{:maps:key_windownext.jpg?30|}} | |Next Window in Current app | | | Esc | | | | | {{:maps:key_windownew.jpg?30|}} | |New Window | | | C N | | | | | {{:maps:key_appprev.jpg?30|}} | |Previous app | | | SA | | | | | {{:maps:key_appnext.jpg?30|}} | |Next app | | | AT | | | | | {{:maps:key_appopen.jpg?30|}} | |Show Open apps | | {{:maps:key_appcurrent.jpg?30|}} | |Show Current app | | {{:maps:key_appfind.jpg?30|}} | |Find app | | | Win | | {{:maps:key_appquit.jpg?30|}} | |Quit app | | | AF4 | ==Accents== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_accentdieresis.jpg?30|}} | Dieresis |Dieresis applied to next character | | {{:maps:key_accentgrave.jpg?30|}} | Grave |Grave accent for next character | | {{:maps:key_accentacute.jpg?30|}} | Acute |Acute accent for next character | | {{:maps:key_accenttilde.jpg?30|}} | Tilde |Tilde applied to next character | | {{:maps:key_accentcircumflex.jpg?30|}} | Circumflex |Circumflex for next character | ==Formulaic Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_plusminus.jpg?30|}} | ± |PlusMinus | | {{:maps:key_delta.jpg?30|}} | Δ |Delta | | {{:maps:key_pi.jpg?30|}} | π |Pi | | {{:maps:key_squareroot.jpg?30|}} | √ |Square root | | {{:maps:key_summarize.jpg?30|}} | Σ |Sum | | {{:maps:key_function.jpg?30|}} | f |Function | | {{:maps:key_integrate.jpg?30|}} | ∫ |Integral | | {{:maps:key_infinity.jpg?30|}} | ∞ |Infinity | | {{:maps:key_approx.jpg?30|}} | ≈ |Approximation/Approximately equal | | {{:maps:key_degree.jpg?30|}} | º |Degree | | {{:maps:key_dot.jpg?30|}} | ∙ |Dot | ==Currency== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_dollar.jpg?30|}} | $ |Dollar | | {{:maps:key_cent.jpg?30|}} | ¢ |Cent | | {{:maps:key_pound.jpg?30|}} | £ |Pound | | {{:maps:key_euro.jpg?30|}} | € |Euro | | {{:maps:key_yen.jpg?30|}} | ¥ |Yen | | {{:maps:key_permil.jpg?30|}} | ‰ |Basis Point | ==Legacy Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_print.jpg?30|}} |Print | | | | Print | | {{:maps:key_break.jpg?30|}} |Break | | | | Break | | {{:maps:key_numlock.jpg?30|}} |Numeric Lock | | | | Num Lock | | {{:maps:key_scrolllock.jpg?30|}} |Scroll Lock | | | | Scroll Lock | | {{:maps:key_home.jpg?30|}} |Home | | | | Home | | {{:maps:key_end.jpg?30|}} |End | | | | End | | {{:maps:key_ins.jpg?30|}} |Insert | | | | Ins | ==Function Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_f1.jpg?30|}} | F1 | | {{:maps:key_f2.jpg?30|}} | F2 | | {{:maps:key_f3.jpg?30|}} | F3 | | {{:maps:key_f4.jpg?30|}} | F4 | | {{:maps:key_f5.jpg?30|}} | F5 | | {{:maps:key_f6.jpg?30|}} | F6 | | {{:maps:key_f7.jpg?30|}} | F7 | | {{:maps:key_f8.jpg?30|}} | F8 | | {{:maps:key_f9.jpg?30|}} | F9 | | {{:maps:key_f10.jpg?30|}} | F10 | | {{:maps:key_f11.jpg?30|}} | F11 | | {{:maps:key_f12.jpg?30|}} | F12 | | {{:maps:key_f13.jpg?30|}} | F13 | | {{:maps:key_f14.jpg?30|}} | F14 | | {{:maps:key_f15.jpg?30|}} | F15 | | {{:maps:key_f16.jpg?30|}} | F16 | | {{:maps:key_f17.jpg?30|}} | F17 | | {{:maps:key_f18.jpg?30|}} | F18 | | {{:maps:key_f19.jpg?30|}} | F19 | | {{:maps:key_f20.jpg?30|}} | F20 | | {{:maps:key_f21.jpg?30|}} | F21 | | {{:maps:key_f22.jpg?30|}} | F22 | | {{:maps:key_f23.jpg?30|}} | F23 | | {{:maps:key_f24.jpg?30|}} | F24 | ==Media keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_volumeup.jpg?30|}} | |Volume up | | {{:maps:key_volumedown.jpg?30|}} | |Volume down | | {{:maps:key_mute.jpg?30|}} | |Mute | | {{:maps:key_playpause.jpg?30|}} | |Play / pause | | {{:maps:key_fastreverse.jpg?30|}} | |Rewind | | {{:maps:key_fastforward.jpg?30|}} | |Fast forward | | {{:maps:key_stopleft.jpg?30|}} | |Previous track | | {{:maps:key_stopright.jpg?30|}} | |Next track | | {{:maps:key_eject.jpg?30|}} | |Eject | ==Capture Keys== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_scrolllock.jpg?30|}} |Scroll Lock | | {{:maps:key_capturescreen.jpg?30|}} |Capture Screen | Captures the whole screen | | {{:maps:key_capturewindow.jpg?30|}} |Capture window | Captures the current active window or part of screen | ==TextBlade Control== ^ Symbol ^ Name ^ Description/Comments ^ Operating System Specific ^^^^^ ^ ::: ^ ::: ^ ::: ^MacOS ^iOS ^Windows ^Linux ^Android ^ ChromeOS ^ | {{:maps:key_off.jpg?30|}} |Turn Off |Puts TextBlade into deep sleep | | {{:maps:key_reboot.jpg?30|}} |Reboot |Reboots the TextBlade | | {{:maps:key_battery.jpg?30|}} |Battery |Show TextBlade Battery level | ===== Checking Key Codes===== Useful online sites for checking exactly what key codes are being sent for any particular map can be found at: * [[http://unixpapa.com/js/testkey.html|UnixPapa]] * [[http://torinak.com/keyCode|Torinak]] MacOS users may find [[https://pqrs.org/osx/karabiner/|Karabiner]] as a useful utility for customising and monitoring keycodes. Windows users may find [[http://www.delphiforfun.org/Programs/Utilities/KeyCodes.htm|Keycode3]] as a useful utility for monitoring keycodes. Raspberry Pi users may find that you are mapping your TextBlade for the Raspberry Pi and you have Kodi on your Pi it makes a nice key logger. Just turn on the Kodi debug function and monitor the kodi log with:\\ ''tail -f /storage/.kodi/temp/kodi.log | grep OnKey'' =====Customisation Examples===== Many of the maps leave a lot of the keys unassigned, and it is possible to remap most of the pre-supplied character key positions. This section covers some ideas that users have come up with to suit their personal tastes * An extended [[maps:numericmode|Numeric Mode]] * Use the unused positions on the Function layer for common modifier sequences that you use. For example the middle row could be used to map ALT-1 to ALT-0.