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>joanied@gnome.org</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> 280