| 1 |
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_key_echo"> |
| 2 |
<info> |
| 3 |
<title type="link">Echo</title> |
| 4 |
<title type="sort">4. Echo</title> |
| 5 |
<desc> |
| 6 |
Configuring what is spoken as you type |
| 7 |
</desc> |
| 8 |
<link type="guide" xref="preferences#orca" /> |
| 9 |
<link type="next" xref="preferences_key_bindings" /> |
| 10 |
<credit type="author"> |
| 11 |
<name>Joanmarie Diggs</name> |
| 12 |
<email>[email protected]</email> |
| 13 |
</credit> |
| 14 |
<license> |
| 15 |
<p>Creative Commons Share Alike 3.0</p> |
| 16 |
</license> |
| 17 |
</info> |
| 18 |
<title>Echo Preferences</title> |
| 19 |
<section id="keyecho"> |
| 20 |
<title>Enable key echo</title> |
| 21 |
<p> |
| 22 |
Orca's key echo setting controls what happens each time you press |
| 23 |
a key. To enable key echo, check the "Enable key echo" checkbox. |
| 24 |
Doing so causes additional checkboxes to become available through |
| 25 |
which you can choose exactly which keys should and should not be |
| 26 |
echoed to best suit your needs. |
| 27 |
</p> |
| 28 |
<p> |
| 29 |
Default value: checked |
| 30 |
</p> |
| 31 |
<section id="keyecho_enable_alphanumeric"> |
| 32 |
<title>Enable alphabetic keys</title> |
| 33 |
<p> |
| 34 |
This option controls whether or not keys like <key>a</key>, |
| 35 |
<key>b</key>, and <key>c</key> should be spoken when pressed. |
| 36 |
</p> |
| 37 |
<p> |
| 38 |
Default value: checked |
| 39 |
</p> |
| 40 |
</section> |
| 41 |
<section id="keyecho_enable_numeric"> |
| 42 |
<title>Enable numeric keys</title> |
| 43 |
<p> |
| 44 |
This option controls whether or not keys like <key>1</key>, |
| 45 |
<key>2</key>, and <key>3</key> should be spoken when pressed. |
| 46 |
</p> |
| 47 |
<p> |
| 48 |
Default value: checked |
| 49 |
</p> |
| 50 |
</section> |
| 51 |
<section id="keyecho_enable_punctuation"> |
| 52 |
<title>Enable punctuation keys</title> |
| 53 |
<p> |
| 54 |
This option controls whether or not keys like <key>%</key>, |
| 55 |
<key>;</key>, and <key>?</key> should be spoken when pressed. |
| 56 |
</p> |
| 57 |
<p> |
| 58 |
Default value: checked |
| 59 |
</p> |
| 60 |
</section> |
| 61 |
<section id="keyecho_enable_space"> |
| 62 |
<title>Enable space</title> |
| 63 |
<p> |
| 64 |
This option controls whether or not <key>Space</key> should be |
| 65 |
spoken when pressed. |
| 66 |
</p> |
| 67 |
<p> |
| 68 |
Default value: checked |
| 69 |
</p> |
| 70 |
</section> |
| 71 |
<section id="keyecho_enable_modifier"> |
| 72 |
<title>Enable modifier keys</title> |
| 73 |
<p> |
| 74 |
This option controls whether or not <key>Shift</key>, <key>Ctrl</key>, |
| 75 |
<key>Alt</key> and <key>Meta</key> should be spoken when pressed. |
| 76 |
</p> |
| 77 |
<p> |
| 78 |
Default value: checked |
| 79 |
</p> |
| 80 |
</section> |
| 81 |
<section id="keyecho_enable_function"> |
| 82 |
<title>Enable function keys</title> |
| 83 |
<p> |
| 84 |
This option controls whether or not <key>F1</key> through <key>F12</key> |
| 85 |
should be spoken when pressed. |
| 86 |
</p> |
| 87 |
<p> |
| 88 |
Default value: checked |
| 89 |
</p> |
| 90 |
</section> |
| 91 |
<section id="keyecho_enable_action"> |
| 92 |
<title>Enable action keys</title> |
| 93 |
<p> |
| 94 |
This option controls whether or not <key>BackSpace</key>, <key>Delete |
| 95 |
</key>, <key>Return</key>, <key>Esc</key>, <key>Tab</key>, <key>Page |
| 96 |
Up</key>, <key>Page Down</key>, <key>Home</key>, and <key>End</key> |
| 97 |
should be spoken when pressed. |
| 98 |
</p> |
| 99 |
<p> |
| 100 |
Default value: checked |
| 101 |
</p> |
| 102 |
</section> |
| 103 |
<section id="keyecho_enable_navigation"> |
| 104 |
<title>Enable navigation keys</title> |
| 105 |
<p> |
| 106 |
This option controls whether or not <key>Left</key>, <key>Right</key>, |
| 107 |
<key>Up</key>, and <key>Down</key> should be spoken when pressed. This |
| 108 |
option also applies to any key combination in which <key>Orca |
| 109 |
Modifier</key> is being held down, for instance when flat review is |
| 110 |
being used. |
| 111 |
</p> |
| 112 |
<p> |
| 113 |
Default value: not checked |
| 114 |
</p> |
| 115 |
</section> |
| 116 |
<section id="keyecho_enable_diacritical"> |
| 117 |
<title>Enable non-spacing diacritical keys</title> |
| 118 |
<p> |
| 119 |
This option controls whether or not "dead keys" used to generate |
| 120 |
accented letters should be spoken when pressed. |
| 121 |
</p> |
| 122 |
<p> |
| 123 |
Default value: not checked |
| 124 |
</p> |
| 125 |
</section> |
| 126 |
</section> |
| 127 |
<section id="characterecho"> |
| 128 |
<title>Enable echo by character</title> |
| 129 |
<p> |
| 130 |
Enabling this option causes Orca to echo the character |
| 131 |
you just typed. |
| 132 |
</p> |
| 133 |
<p> |
| 134 |
While echo by character seems quite similar to the key echo of |
| 135 |
alphabetic, numeric, and punctuation keys, there are important differences, |
| 136 |
especially with respect to accented letters and other symbols for which |
| 137 |
there is no dedicated key: |
| 138 |
</p> |
| 139 |
<list> |
| 140 |
<item> |
| 141 |
<p> |
| 142 |
Key echo causes <app>Orca</app> to announce what you just <em> |
| 143 |
pressed</em>. |
| 144 |
</p> |
| 145 |
</item> |
| 146 |
<item> |
| 147 |
<p> |
| 148 |
Character echo causes <app>Orca</app> to announce what was just |
| 149 |
<em>inserted</em>. |
| 150 |
</p> |
| 151 |
</item> |
| 152 |
</list> |
| 153 |
<p> |
| 154 |
Thus to have accented characters spoken as you type them, you should |
| 155 |
enable character echo. |
| 156 |
</p> |
| 157 |
<p> |
| 158 |
Default value: not checked |
| 159 |
</p> |
| 160 |
<note style="tip"> |
| 161 |
<title>Enabling both key echo and character echo</title> |
| 162 |
<p> |
| 163 |
If you like key echo and you frequently type accented characters, |
| 164 |
consider enabling both. <app>Orca</app>'s character echo logic |
| 165 |
attempts to filter out characters which were spoken as a result |
| 166 |
of key echo, thus minimizing the likelihood of "double speaking" |
| 167 |
as you type. |
| 168 |
</p> |
| 169 |
</note> |
| 170 |
</section> |
| 171 |
<section id="wordandsentenceecho"> |
| 172 |
<title>Enable echo by word and Enable echo by sentence</title> |
| 173 |
<p> |
| 174 |
Checking the <gui>Enable echo by word</gui> checkbox causes |
| 175 |
<app>Orca</app> to echo the word you just typed. Similarly, |
| 176 |
checking the <gui>Enable echo by sentence</gui> checkbox causes |
| 177 |
<app>Orca</app> to echo the sentence you just typed. |
| 178 |
</p> |
| 179 |
<p> |
| 180 |
Default value: not checked |
| 181 |
</p> |
| 182 |
</section> |
| 183 |
</page> |