diff options
Diffstat (limited to 'www/manual/play-keyboard.t')
-rw-r--r-- | www/manual/play-keyboard.t | 94 |
1 files changed, 94 insertions, 0 deletions
diff --git a/www/manual/play-keyboard.t b/www/manual/play-keyboard.t new file mode 100644 index 0000000000..bda482b6fd --- /dev/null +++ b/www/manual/play-keyboard.t | |||
@@ -0,0 +1,94 @@ | |||
1 | #define _PAGE_ Manual - Player keyboard | ||
2 | #include "head.t" | ||
3 | #include "manual.t" | ||
4 | |||
5 | <p> | ||
6 | The keyboard allows you to edit text. The first line holds the | ||
7 | text being edited and the second line is a combined menu line | ||
8 | where you both can select characters for insertion and the | ||
9 | operations; backspace, delete, accept and abort. | ||
10 | </p> | ||
11 | |||
12 | <p> | ||
13 | You move between the lines using the normal LEFT and RIGHT | ||
14 | buttons. An arrow to the left indicate what line is selected. The | ||
15 | second line will scroll. This is like like in most menus except | ||
16 | that the first line will always show the text being edited. | ||
17 | </p> | ||
18 | |||
19 | <h2>Button bindings and functionality</h2> | ||
20 | |||
21 | <table class=buttontable> | ||
22 | <tr><th>Line</th><th>Function and key bindings</th> | ||
23 | <tr><td>First</td><td>Text - Use UP and DOWN to move the cursor</td></tr> | ||
24 | <tr><td>Second</td> | ||
25 | <td> | ||
26 | <table> | ||
27 | <tr> | ||
28 | <td>Characters</td><td>Chars selectable for | ||
29 | input. With ON insert the char between the | ||
30 | arrows. Select another character by using UP and | ||
31 | DOWN. Finally change the character subset with | ||
32 | MENU. There are three subsets to choose from: | ||
33 | capital letters, small letters and others.</td> | ||
34 | </tr> | ||
35 | <tr> | ||
36 | <td>Backspace</td><td>Use UP to delete the char to the | ||
37 | left the cursor.</td> | ||
38 | </tr> | ||
39 | <tr><td>Delete</td><td>Use UP to delete char under the | ||
40 | cursor</td> | ||
41 | </tr> | ||
42 | <tr><td>Accept</td><td>UP accepts the text and returns | ||
43 | to the application</td> | ||
44 | </tr> | ||
45 | <tr><td>Abort</td><td>UP returns to the application | ||
46 | without any change</td> | ||
47 | </tr> | ||
48 | </table> | ||
49 | </td> | ||
50 | </tr> | ||
51 | </table> | ||
52 | |||
53 | <h2>Example</h2> | ||
54 | |||
55 | <p>Supposed we want edit the text "file.mp3" and change it to | ||
56 | "fileName.mp3". Maybe as a part of doing a rename operation. This | ||
57 | is how the screen will look:</p> | ||
58 | |||
59 | <img src="play-keyboard-initial.png"> | ||
60 | |||
61 | <p>Note how the arrow points to the first line. This means that UP | ||
62 | and DOWN will move the cursor on the first line so that you can | ||
63 | select where to insert a char or where to delete chars.</p> | ||
64 | |||
65 | <p>Now we press DOWN three times to move the cursor so it will be | ||
66 | above the dot. The we move down to the second line by pressing | ||
67 | RIGHT. Finally we select the character N by pressing UP a few | ||
68 | times. You will se that the second line will scroll to the left | ||
69 | placing a new character between the arrows each time you press | ||
70 | UP. We continue doing this until we have N between the arrows. The | ||
71 | screen will look something like this then.</p> | ||
72 | |||
73 | <img src="play-keyboard-Nselected.png"> | ||
74 | |||
75 | <p>We are now ready to insert out first character. Press ON and N | ||
76 | will be inserted at the place of the cursor.</p> | ||
77 | |||
78 | <p>To get to the small letters we press MENU, move to 'a' by using | ||
79 | UP and DOWN, insert it by pressing ON.</p> | ||
80 | |||
81 | <img src="play-keyboard-Naentered.png"> | ||
82 | |||
83 | <p>Finally to feed our new text back to the application requesting | ||
84 | this we move further down by pressing RIGHT. This will scroll the | ||
85 | second line vertically, move away the character insertion line and | ||
86 | another menu line will be visible. We continue pressing RIGHT until | ||
87 | the menu choice Accept is visible.</p> | ||
88 | |||
89 | <img src="play-keyboard-accept.png"> | ||
90 | |||
91 | <p>We acknowledge this by pressing UP. We are done. We will now be | ||
92 | taken back to where we were before entering the keyboard.</p> | ||
93 | |||
94 | #include "foot.t" | ||