| 1 |
<page xmlns="http://projectmallard.org/1.0/" type="topic" id="preferences_general"> |
| 2 |
<info> |
| 3 |
<title type="sort">1. General</title> |
| 4 |
<title type="link">General</title> |
| 5 |
<desc> |
| 6 |
Configuring <app>Orca</app>'s fundamental behaviors |
| 7 |
</desc> |
| 8 |
<link type="guide" xref="preferences#orca" /> |
| 9 |
<link type="next" xref="preferences_voice" /> |
| 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>General Preferences</title> |
| 19 |
<section id="keyboardlayout"> |
| 20 |
<info> |
| 21 |
<desc> |
| 22 |
Preferences dialog box option to select which <app>Orca</app> keyboard |
| 23 |
layout to use, desktop or laptop. |
| 24 |
</desc> |
| 25 |
</info> |
| 26 |
<title>Keyboard Layout</title> |
| 27 |
<p> |
| 28 |
The <gui>Keyboard Layout</gui> radio button group allows you to specify if |
| 29 |
you will be working on a desktop (i.e. with a numeric keypad) or laptop |
| 30 |
keyboard. Which layout you choose will determine both the <key>Orca |
| 31 |
Modifier</key> as well as a number of keyboard shortcuts for performing |
| 32 |
<app>Orca</app> commands.</p> |
| 33 |
<p> |
| 34 |
Default value: <gui>Desktop</gui> |
| 35 |
</p> |
| 36 |
</section> |
| 37 |
<section id="presenttooltips"> |
| 38 |
<info> |
| 39 |
<desc> |
| 40 |
Preferences dialog box option to enable presentation of tooltips which |
| 41 |
appear as the result of mouse hovering. |
| 42 |
</desc> |
| 43 |
</info> |
| 44 |
<title>Present Tooltips</title> |
| 45 |
<p> |
| 46 |
When checked, this option will tell <app>Orca</app> to present information |
| 47 |
about tooltips when they appear as the result of mouse hovering. Specific |
| 48 |
actions to force tooltips to appear, such as pressing <keyseq> |
| 49 |
<key>Ctrl</key><key>F1</key></keyseq> when an object has focus, will |
| 50 |
always result in tooltips being presented, regardless of this setting. |
| 51 |
</p> |
| 52 |
<p> |
| 53 |
Default value: not checked |
| 54 |
</p> |
| 55 |
</section> |
| 56 |
<section id="objectundermouse"> |
| 57 |
<info> |
| 58 |
<desc> |
| 59 |
Preferences dialog box option to enable presentation of the object |
| 60 |
under the mouse pointer. |
| 61 |
</desc> |
| 62 |
</info> |
| 63 |
<title>Speak Object Under Mouse</title> |
| 64 |
<p> |
| 65 |
When checked, this option will tell <app>Orca</app> to present |
| 66 |
information about the object under the mouse pointer as you move |
| 67 |
it around the screen using <app>Orca</app>'s |
| 68 |
<link xref="howto_mouse_review">Mouse Review</link> feature. |
| 69 |
</p> |
| 70 |
<p> |
| 71 |
Default value: not checked |
| 72 |
</p> |
| 73 |
</section> |
| 74 |
<section id="timeanddate"> |
| 75 |
<info> |
| 76 |
<desc> |
| 77 |
Preferences dialog box options for customizing the time and date |
| 78 |
formats used by <app>Orca</app>. |
| 79 |
</desc> |
| 80 |
</info> |
| 81 |
<title>Time Format and Date Format</title> |
| 82 |
<p> |
| 83 |
The <gui>Time Format</gui> and <gui>Date Format</gui> combo boxes allow |
| 84 |
you to specify how <app>Orca</app> will speak and braille the time and the |
| 85 |
date. |
| 86 |
</p> |
| 87 |
<p> |
| 88 |
Default value: use the system locale's format for each |
| 89 |
</p> |
| 90 |
</section> |
| 91 |
<section id="navigation_in_say_all"> |
| 92 |
<info> |
| 93 |
<desc> |
| 94 |
Preferences dialog box options for enabling rewind, fast forward, |
| 95 |
and structural navigation during Say All. |
| 96 |
</desc> |
| 97 |
</info> |
| 98 |
<title>Navigation in Say All</title> |
| 99 |
<p> |
| 100 |
<app>Orca</app>'s Say All feature speaks document content from your |
| 101 |
present location to the end of the document. By default, pressing any |
| 102 |
key will interrupt Say All's presentation. However, if you check the |
| 103 |
<gui>Enable rewind and fast forward in Say All</gui> checkbox, |
| 104 |
<key>Up</key> and <key>Down</key> can be used during Say All to quickly |
| 105 |
move within the document in order to re-hear something which was just |
| 106 |
read or skip past text of no interest without having to restart Say All. |
| 107 |
</p> |
| 108 |
<p> |
| 109 |
If you are reading a document within an application that has structural |
| 110 |
navigation support, and you have checked the <gui>Enable structural navigation |
| 111 |
in Say All</gui> checkbox, you can use the supported structural navigation |
| 112 |
commands in a similar fashion: <key>H</key>/<keyseq><key>Shift</key> |
| 113 |
<key>H</key></keyseq> continues reading from the next/previous heading, |
| 114 |
<key>P</key>/<keyseq><key>Shift</key><key>P</key></keyseq> continues reading |
| 115 |
from the next/previous paragraph, <key>T</key>/<keyseq><key>Shift</key> |
| 116 |
<key>T</key></keyseq> continues reading from the next/previous table, and |
| 117 |
so on. |
| 118 |
</p> |
| 119 |
<p> |
| 120 |
Default value: not checked |
| 121 |
</p> |
| 122 |
</section> |
| 123 |
<section id="say_all_announce_context"> |
| 124 |
<title>Announce Contextual Information in Say All</title> |
| 125 |
<p> |
| 126 |
<app>Orca</app> can optionally provide more information about the document |
| 127 |
content being spoken, such as announcing when you are entering and leaving |
| 128 |
a blockquote, list, table, or other container. Whether or not these |
| 129 |
announcements are made can be configured independently through the following |
| 130 |
checkboxes: |
| 131 |
</p> |
| 132 |
<list> |
| 133 |
<item><p>Announce blockquotes in Say All</p></item> |
| 134 |
<item><p>Announce forms in Say All</p></item> |
| 135 |
<item><p>Announce landmarks in Say All</p></item> |
| 136 |
<item><p>Announce lists in Say All</p></item> |
| 137 |
<item><p>Announce panels in Say All</p></item> |
| 138 |
<item><p>Announce tables in Say All</p></item> |
| 139 |
</list> |
| 140 |
<p> |
| 141 |
Default value: checked |
| 142 |
</p> |
| 143 |
<note style="note"> |
| 144 |
<p> |
| 145 |
Whether or not <app>Orca</app> makes these announcements during |
| 146 |
navigation is also configurable. You will find similar checkboxes |
| 147 |
on the <gui>Speech</gui> page. For more information, see |
| 148 |
<link xref="preferences_speech#spoken_context">Spoken Context</link>. |
| 149 |
</p> |
| 150 |
</note> |
| 151 |
</section> |
| 152 |
<section id="say_all_by"> |
| 153 |
<info> |
| 154 |
<desc> |
| 155 |
Preferences dialog box option for customizing <app>Orca</app>'s |
| 156 |
Say All presentation. |
| 157 |
</desc> |
| 158 |
</info> |
| 159 |
<title>Say All By</title> |
| 160 |
<p> |
| 161 |
The <gui>Say All By</gui> combo box allows you to specify whether |
| 162 |
<app>Orca</app> speaks a sentence at a time or a line at a time when |
| 163 |
doing a "Say All" of a document. |
| 164 |
</p> |
| 165 |
<p> |
| 166 |
Default value: <gui>Sentence</gui> |
| 167 |
</p> |
| 168 |
</section> |
| 169 |
<section id="profiles"> |
| 170 |
<info> |
| 171 |
<desc> |
| 172 |
Preferences dialog box options for managing settings profiles. |
| 173 |
</desc> |
| 174 |
</info> |
| 175 |
<title>Profiles</title> |
| 176 |
<p> |
| 177 |
The <gui>Profiles</gui> group of controls, which appear at the bottom |
| 178 |
of the <gui>General</gui> page, make it possible for you to maintain |
| 179 |
and use multiple configurations. |
| 180 |
</p> |
| 181 |
<list> |
| 182 |
<item> |
| 183 |
<p> |
| 184 |
The <gui>Active Profile</gui> combo box displays the current profile |
| 185 |
and allows you to select a different profile to load. |
| 186 |
</p> |
| 187 |
</item> |
| 188 |
<item> |
| 189 |
<p> |
| 190 |
The <gui>Load</gui> button will cause <app>Orca</app> to load the |
| 191 |
profile indicated in the <gui>Active Profile</gui> combo box. |
| 192 |
</p> |
| 193 |
</item> |
| 194 |
<item> |
| 195 |
<p> |
| 196 |
The <gui>Save As</gui> button allows you to save the current set of |
| 197 |
options from the preferences dialog box to a named profile. |
| 198 |
</p> |
| 199 |
</item> |
| 200 |
<item> |
| 201 |
<p> |
| 202 |
The <gui>Start-up Profile</gui> combo box allows you to select the |
| 203 |
profile which should be automatically loaded each time you launch |
| 204 |
<app>Orca</app>. |
| 205 |
</p> |
| 206 |
</item> |
| 207 |
</list> |
| 208 |
</section> |
| 209 |
<section id="progress_bar_updates"> |
| 210 |
<title>Progress Bar Updates</title> |
| 211 |
<section id="progress_bar_updates_speak"> |
| 212 |
<title>Speak updates</title> |
| 213 |
<p> |
| 214 |
If the <gui>Speak updates</gui> checkbox is checked <app>Orca</app> will |
| 215 |
periodically speak the status of progress bars. |
| 216 |
</p> |
| 217 |
<p> |
| 218 |
Default value: checked |
| 219 |
</p> |
| 220 |
</section> |
| 221 |
<section id="progress_bar_updates_braille"> |
| 222 |
<title>Braille updates</title> |
| 223 |
<p> |
| 224 |
If the <gui>Braille updates</gui> checkbox is checked <app>Orca</app> will |
| 225 |
periodically display the status of progress bars on your refreshable braille |
| 226 |
display. |
| 227 |
</p> |
| 228 |
<p> |
| 229 |
Default value: not checked |
| 230 |
</p> |
| 231 |
</section> |
| 232 |
<section id="progress_bar_updates_beep"> |
| 233 |
<title>Beep updates</title> |
| 234 |
<p> |
| 235 |
If the <gui>Beep updates</gui> checkbox is checked <app>Orca</app> will |
| 236 |
periodically emit beeps which increase in pitch as the value of the progress |
| 237 |
bar increases. |
| 238 |
</p> |
| 239 |
<p> |
| 240 |
Default value: not checked |
| 241 |
</p> |
| 242 |
</section> |
| 243 |
<section id="progress_bar_updates_frequency"> |
| 244 |
<title>Frequency (secs)</title> |
| 245 |
<p> |
| 246 |
This spin button determines how often updates are presented. |
| 247 |
</p> |
| 248 |
<p> |
| 249 |
Default value: 10 |
| 250 |
</p> |
| 251 |
</section> |
| 252 |
<section id="progress_bar_updates_restrict"> |
| 253 |
<title>Applies to</title> |
| 254 |
<p> |
| 255 |
This combo box allows you to control which progress bars should be |
| 256 |
presented, assuming the presentation of progress bar updates has been |
| 257 |
enabled. The choices are <gui>All</gui>, <gui>Application</gui>, and |
| 258 |
<gui>Window</gui>. |
| 259 |
</p> |
| 260 |
<p> |
| 261 |
Choosing <gui>All</gui> will result in <app>Orca</app> presenting |
| 262 |
updates for all progress bars, regardless of where the progress bars |
| 263 |
are located. |
| 264 |
</p> |
| 265 |
<p> |
| 266 |
Choosing <gui>Application</gui> will result in <app>Orca</app> |
| 267 |
presenting updates from progress bars in the active application, even |
| 268 |
if they are not in the active window. |
| 269 |
</p> |
| 270 |
<p> |
| 271 |
Choosing <gui>Window</gui> will result in <app>Orca</app> only |
| 272 |
presenting updates for progress bars in the active window. |
| 273 |
</p> |
| 274 |
<p> |
| 275 |
Default value: <gui>Application</gui> |
| 276 |
</p> |
| 277 |
</section> |
| 278 |
</section> |
| 279 |
</page> |