startup:typing [WayTools Community Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
The TextBlade is an ultra-portable, highly-configurable keyboard.  For casual users, it can be a superior alternative to the on-screen keyboard on a phone/tablet.  For power users, it can be the one keyboard to rule them all - a highly customized productivity device able to be used with all computing devices.  Using the TextBlade is no more complicated than using an on-screen keyboard.

====On-Screen Keyboard Analogy====
At the most basic level, the TextBlade is an alternative to an on-screen keyboard.  While a typical QWERTY keyboard has around 100 keys, the iPhone's on-screen keyboard has less than 40 "keys" displayed at a given point in time.  In order to type all of the symbols found on a standard QWERTY keyboard, one must employ multiple taps.  For example, to produce <kbd>{</kbd> one must tap {{:maps:iOS123.png?30}}, then tap {{:maps:iOSpuncKey.png?30}}, and then tap <kbd>{</kbd>.

The standard on-screen QWERTY keyboard for the iPhone((Based on U.S. English localization)) looks like this: 
{{ :maps:iosalpha.png?310 }}

Tapping {{:maps:iOSshiftKey.png?30}} looks the same, but the next letter pressed will be uppercase rather than lowercase:
{{ :maps:iosshift.png?310 }}

Tapping {{:maps:iOS123.png?30}} reveals the number layer of the on-screen keyboard:
{{ :maps:iOSnum.png?310 }}

Tapping {{:maps:iOSpuncKey.png?30}} reveals yet another keyboard layer:
{{ :maps:iOSpunc.png?310 }}

Tapping {{:maps:iOSglobe.png?30}} toggles with other on-screen keyboards that can be thought of as additional layers.

It all sounds somewhat complicated, but in practice **it really isn't**.

====Basic Typing with the TextBlade====
Similarly, the TextBlade has 37 "keys" and makes use of multiple layers to provide access to additional symbols not found on the default layer.  With the TextBlade, additional layers are accessed by pressing a key, holding a key or combination of keys (known as a chord), or long pressing a chord.  Again, it sounds complicated but in practice it really isn't.  Early users have found that it is easy enough to use the keyboard for typical typing and employ hunt-and-peck methods for finding symbols found on additional layers.  As one's familiarity grows, learning the layouts of the additional layers comes quite naturally.

While it may look overwhelming at first, thoughtful design has made the TextBlade easy for beginners to use and extremely efficient for avid users.

For example, the standard QWERTY keyboard layout contains some obvious layers as well as some additional layers that can be used to provide efficient keyboard shortcuts.  

===Alpha Layer Set===
The ALPHA layer set is easily mastered and provides all the functionality needed to type.
The ALPHA layer contains the lowercase alphabet and a few punctuation symbols:
{{ :maps:alphaLyrT.png?621 }}

Pressing the <kbd>SHIFT</kbd> switches to uppercase letters and a few different punctuation symbols:
{{ :maps:shiftLyrT.png?621 }}

For most text processing, e.g., email, all you need to know is the ALPHA layer and corresponding shifted alpha layer to get by.  This makes the keyboard extremely simple to start using.  If you need some other punctuation symbol, you can hunt and peck on the Green layer.((There are actually multiple Green layers, but for now we just need to know about the Green alpha layer.))

Holding down the middle of the SpaceBlade activates the Green layer:
{{ :maps:greenLyrT.png?621 }}

A few more punctuation symbols are found on the Green-shift layer:
{{ :maps:greenShiftLyrT.png?621 }}

===Shift and Green Modifier Keys===
So far we've just have two simple modifiers to keep track of:

  * <kbd>SHIFT</kbd> -- You can hold the shift key down and press another key or use it as a sticky key (tap it and it remains active until the next key is pressed, much like the shift on an on-screen keyboard).  As you would expect, you can also double-tap the shift key to engage CAPS-LOCK.
  * Holding down the center of the SpaceBlade activates the corresponding Green layer.  You can think of activating the Green layer as a second shift key.  Hold it down when pressing another key and it changes the behavior of the key (just like shift).

So far this is all pretty simple and intuitive -- we have shift and a second shift (that we call Green).

<button collapse="greenLayer">Demo Video</button>
<collapse id="greenLayer" collapsed="true"><well>{{ youtube>Z-kn_jmbtKw |Green layer in action demo video}}</well></collapse>

===Control, Command/Windows, Option/Alt===

The TextBlade doesn't have dedicated <kbd>C</kbd>, <kbd>Option</kbd>/<kbd>A</kbd>, and <kbd>Command</kbd>/<kbd>Windows</kbd> keys.  To activate these modifier keys, the TextBlade uses the concept of a chord.  A chord is just a combination of two or more keys depressed at the same time.  For these modifiers, each chord consists of depressing two neighboring keys on the bottom row of one of the KeyBlades.  

The placement of these chords matches the placement on standard Apple keyboards.  For example, going from outer to inner on Apple platforms, the chords are <kbd>C</kbd>, <kbd>Option</kbd>, and <kbd>Command</kbd>. 
<note>Apple has traditionally used different symbols and names for some of the mod keys on their keyboards to those that are traditional on other keyboards.  Internally they return the same keycodes, so the following table illustrates these  equivalents:

^Apple Symbol ^Apple Name^Others Name^
|<kbd>Option</kbd> |<kbd>0ption</kbd> or <kbd>A</kbd> |<kbd>A</kbd> |
|<kbd>Command</kbd> |<kbd>Cmd</kbd> |<kbd>Windows</kbd> |
</note>

==Modifier Chords==
The Modifier keys are activated by using chords on the bottom key row.

The left and right blades in principle are meant to be mirrors but (at the moment anyway) the left and right blades are not exact mirrors as can be seen on the tables below.  The (left) and (right) indicate whether the Left or Right version of the key is being returned although in the vast majority of cases the difference between left and Right is irrelevant (especially as many keyboards only have the Left variant anyway).

^Modifier Chord ^ ^ ^ ^
|**Left Blade** |**Right Blade** |**Apple** (iOS and Mac) |**Others** (Windows/Linux/Android) |
|{{:startup:key_modleft_zx.jpg?150|}}| |<kbd>C</kbd>(left) |<kbd>C</kbd>(left) |
| |{{:startup:key_modright_zx.jpg?150|}}|<kbd>C</kbd>(right) |<kbd>C</kbd>(right) |
|{{:startup:key_modleft_xc.jpg?150|}}| |<kbd>Option</kbd>(left) | <kbd>A</kbd>(left) |
| |{{:startup:key_modright_xc.jpg?150|}}|<kbd>Option</kbd>(left) |<kbd>A</kbd>(right)<kbd>C</kbd>(left) |
|{{:startup:key_modleft_cv.jpg?150|}}| |<kbd>Command</kbd> |<kbd>Windows</kbd>(left)  |
| |{{:startup:key_modright_cv.jpg?150|}}|<kbd>Command</kbd> |<kbd>Windows</kbd>(left) |

<button collapse="modKey">Mod Keys Demo Video</button>
<collapse id="modKey" collapsed="true"><well>{{ youtube>E7hcVW-gV1k |Mod Keys demo video}}</well></collapse>

The above table shows the simple modifiers.   It is also possible to get modifier combinations by using other chords as shown in the table below. 
^Extra Modifiers ^ ^ ^ ^
|**Left Blade** |**Right Blade** |**Apple (iOS and Mac)** |**Others (Windows/Linux/Android)** |
|{{:startup:key_modleft_zc.jpg?150|}} | |<kbd>C</kbd>(left)|<kbd>C</kbd>(left) |
| |{{:startup:key_modright_zc.jpg?150|}}  |<kbd>C</kbd>(right) |<kbd>C</kbd>(right) |
|{{:startup:key_modleft_zv.jpg?150|}} | |<kbd>C</kbd>(left)<kbd>Command</kbd>(left) |<kbd>C</kbd>(left)<kbd>Windows</kbd>(left) |
| |{{:startup:key_modright_zv.jpg?150|}} |<kbd>C</kbd>(right)<kbd>Command</kbd>(left) |<kbd>C</kbd>(right)<kbd>Windows</kbd>(left) |
|{{:startup:key_modleft_xv.jpg?150}} | |<kbd>Command</kbd>(left) |<kbd>Windows</kbd>(left) |
| |{{:startup:key_modright_xv.jpg?150}} |<kbd>C</kbd>(right)<kbd>Command</kbd>(left) |<kbd>Windows</kbd>(left) |
|{{:startup:key_modleft_zxc.jpg?150|}} | |<kbd>Option</kbd>(left)<kbd>C</kbd>(left) |<kbd>A</kbd>(left)<kbd>C</kbd>(left) |
| |{{:startup:key_modright_zxc.jpg?150|}} |<kbd>Option</kbd>(left)<kbd>C</kbd>(left) |<kbd>A</kbd>(right)<kbd>C</kbd>(right) |
|{{:startup:key_modleft_xcv.jpg?150|}} | |<kbd>Option</kbd>(left)<kbd>Command</kbd>(left) |<kbd>A</kbd>(left)<kbd>C</kbd>(left)<kbd>Windows</kbd>(left) |
| |{{:startup:key_modright_xcv.jpg?150|}} |<kbd>C</kbd>(left)<kbd>Option</kbd>(right)<kbd>Command</kbd>(left) |<kbd>A</kbd>(right)<kbd>C</kbd>(left) |
|{{:startup:key_modleft_zxv.jpg?150|}} | |<kbd>C</kbd>(left)<kbd>Command</kbd>(left) |<kbd>C</kbd>(left)<kbd>Windows</kbd>(left) |
| |{{:startup:key_modright_zxv.jpg?150|}}  |<kbd>C</kbd>(right)<kbd>Command</kbd>(left) |<kbd>C</kbd>(right)<kbd>Windows</kbd>(left) |
|{{:startup:key_modleft_zcv.jpg?150|}} | |<kbd>C</kbd>(left)<kbd>Command</kbd>(left) |<kbd>C</kbd>(left)<kbd>Windows</kbd>(left) |
| |{{:startup:key_modright_zcv.jpg?150|}}  |<kbd>C</kbd>(right)<kbd>Command</kbd>(left) |<kbd>C</kbd>(right)<kbd>Windows</kbd>(left) |
|{{:startup:key_modleft_zxcv.jpg?150|}} | |<kbd>C</kbd>(left)<kbd>Option</kbd>(left) |<kbd>C</kbd>(left)<kbd>A</kbd>(left)<kbd>Windows</kbd>(left) |
| |{{:startup:key_modright_zxcv.jpg?150|}} |<kbd>C</kbd>(right)<kbd>Option</kbd>(left) |<kbd>C</kbd>(right)<kbd>A</kbd>(right)<kbd>Windows</kbd>(left) |

//You will note that some combinations are available in more than one way at the moment.  This is almost certainly an artefact of the firmware that might be removed at some point in the future//.   

<note>The above tables were constructed using the standard QWERTY library map.  No validation has been done as to whether all other maps treat the modifiers identically (although it is believed they should).  The keycode3 app running under Windows 10 was used to detect the keys being returned</note>


====On-Screen Keyboard====
<note>Currently this is only available for iOS. We assume it will become available on other platforms when the TextBlade app is released for them.</note>
You can force the on-screen keyboard to be displayed by pressing all 4 home keys on the right-hand blade (<kbd>J</kbd><kbd>K</kbd><kbd>L</kbd><kbd>'</kbd> on QWERTY layout). 

====Additional Layers====

The capabilities of the TextBlade go well beyond just being a hardware alternative of an on-screen keyboard.  Much of this additional power is wrapped in the concept of layers.  The TextBlade provides additional sets of layers that are activated by pressing the appropriate chord.

===Edit Layer===
The Edit layers are activated with the edit chord ({{:emoji:editChord.png?60}}).  Notice that the standard cursor movements are arranged in the familiar inverted-T towards the upper center of the RightBlade.  This inverted-T arrangement is reused on many layers to provide consistency in layout.  This consistency makes learning additional layers a breeze.

{{ :maps:editLyrT.png?621 }}
{{ :maps:editGreenLyrT.png?621 }}

===Select Layer===
Using the select chord ({{:emoji:selectChord.png?60}}) activates Select mode, which is the same as the Edit mode except selections are made when the cursor is moved.

<button collapse="cursor">Cursor Keys Video</button>
<button collapse="edit">Edit Mode Video</button>
<button collapse="select">Select Mode Video</button>
<collapse id="cursor" collapsed="true"><well>{{ youtube>IhLnRoorGUw |Home Key Cursors demo video}}</well></collapse>
<collapse id="edit" collapsed="true"><well>{{ youtube>HNCh_EW5gH8 |Edit Mode demo video}}</well></collapse>
<collapse id="select" collapsed="true"><well>{{ youtube>UKrArtz2mGw |Select Mode demo video}}</well></collapse>

===Media and App Layers===
The Media/App layers are activated with the media chord ({{:emoji:mediaChord.png?60}}).

{{ :maps:mediaLyrT.png?621 }}
{{ :maps:appLyrT.png?621 }}

===NUM-Lock Layer===
The NUM-Lock layers provide for easy entry of numbers:

{{ :maps:numLyrT.png?621 }}
{{ :maps:numGreenLyrT.png?621 }}

Note: It is possible to activate the Edit layer directly from the NUM-Lock layer which can be really handy when navigating a spreadsheet.

===Function Key Layers===
Function keys are accessible using the function key layers.  Activating these layers is slightly different.  To activate a function key layer uses the appropriate chord ({{:emoji:f1Chord.png?60}}). This chord is 'sticky' so you can either hold it down or release it and the next key is from the Function layers. LEDs on the SpaceBlade will let you know when you've held the chord long enough. The basic Function layer gives you <key>F1</key>-<key>F10</key> and you can then use the Green Layer to get at <key>F11</key>-<key>F20</key>. Two LEDs on the SpaceBlade will illuminate to indicate that the function key layer is active.

<note tip>Other than the top rows which are mapped to the Function Key codes all the other key positions by default have nothing mapped to them.    These can be a good place to add additional key codes that you use frequently and find a bit convoluted to type.</note>

{{ :startup:map_function.jpg?650 |}}

===Macro Layer===
The Macro Layer is rather like the Function layer in that the chord to activate it acts in a ‘Sticky’ manner.  You can thus have a different macro associated with any key.   More detail on Macros can be found in the Macros sub-section of this wiki.
====Alternative Keyboard Layouts====
The TextBlade app provides a number of other keyboard layouts. You can browse all of these options in the TextBlade app.

For example the alpha layers are mapped differently for 

==Dvorak==
{{ :startup:map_dvorak.jpg?650 |}}

==Colemak==
{{ :startup:map_colemak.jpg?650 |}}

==Emoji==
There is also a **Emoji** layer available by pressing the right-side of the SpaceBlade. This currently only works on iOS using the TextBlade keyboard extension.)

{{ :startup:map_emoji2.jpg?650 |}}
{{ :startup:map_emoji1.jpg?400 |}}

==International Layouts==
Some of the international keyboard layouts have additional layers.  For example, QWERTZ includes a Left-Green layer that is activated by pressing the left-side of the SpaceBlade.

<note>The hot-corners feature need to be enabled to access the left-green layer. This means that the hot corners are re-mapped to become pure layer shifting and won't act as traditional keys when using international maps.</note>
{{ :startup:map_quertz.jpg?650 |}}


====Customizing Layouts====

For those with MultiMap, it is possible to [[:maps:start|customize the layouts of the different layers]] so those who are interested in specialized mappings can set them to be whatever they want.


====Additional Layers/Hot Corners====
If you are using an English layout then there is a feature called **Hot Corners** (available under the **Features** section of the TextBlade app) that provides an alternative way of generating some of the most common modifiers (CMD/CTRL and ALT).   These are activated by pressing on the left or right-sides of the Space Blades (rather than the center).

If using a non-English layout then this feature is used to access additional layers instead.   For international maps the left side of the SpaceBlade accesses an additional layer (Called the Left-Green layer) for accessing additional symbols and the right side does nothing.

If you have the Emoji map installed then the right-side of the SpaceBlade is used to access the additional layer that contains all the Emoji symbols.   If you have hot corners enabled then the left side of the SpaceBlade is still available to generate the CMD/CTRL key, but the right side has been pre-empted to access the Emoji layer so does not generate the ALT key.