JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris 11 Accessibility Guide for the GNOME Desktop     Oracle Solaris 11 Information Library
search filter icon
search icon

Document Information

Preface

1.  Introduction to Accessibility

2.  Using Assistive Technologies

Orca Screen Reader and Magnifier

Braille Support

Available Voices

Magnification in Orca

To Enable Orca

Using Orca

Setting Up Orca

Running Orca

Quitting Orca

Orca Configuration GUI

Enabling General Preferences in Orca

Keyboard Layout

Show Orca Main Window

Quit Orca Without Confirmation

Disable gksu Keyboard Grab

Present Tooltips

Speak Object Under Mouse

Start Orca When You Login

Enabling Speech Preferences in Orca

Enable Speech

Speech System and Speech Synthesizer

Voice Settings

Punctuation Level

Verbosity

Table Row Speech

Speak Blank Lines

Speak Multicase Strings as Words

Speak Tutorial Messages

Speak Object Mnemonics

Break Speech Into Chunks Between Pauses

To Speak Child Position

To Speak Indentation and Justification

Progress Bar Updates

Say All By

Enabling Braille Preferences in Orca

Enable Braille Support

Enable Braille Monitor

Enable Abbreviated Role Names

Disable End of Line Symbol

Contracted Braille

Verbosity

Enable Selection Indicator

Enable Hyperlink Indicator

Enabling Key Echo Preferences in Orca

Enable Key Echo

Enable Echo by Character

Enable Echo by Word

Enable Echo by Sentence

Enabling Magnifier Preferences in Orca

Enable Magnifier

Zoomer Settings

Border Settings

Cursor Settings

Cross-hair Settings

Color Settings

Tracking and Alignment Settings

Enabling Key Bindings Preferences in Orca

Orca Modifier Keys

Using the Key Bindings Table

Enabling Pronunciation Preferences in Orca

Text Attributes Page

Using the Orca Keyboard Commands

Using the Desktop Layout Commands

Flat Review Keyboard Commands

Bookmark Keyboard Commands

Miscellaneous Functions

Debugging Keyboard Commands

Using the Laptop Layout Commands

Flat Review Keyboard Commands

Bookmark Keyboard Commands

Miscellaneous Keyboard Commands

Debugging Keyboard Commands

Application-Specific Information

Making Application-Specific Settings

To Enable Braille

Troubleshooting Orca

Desktop Is Unresponsive

Disabling the Screensaver

To Change the PDF Viewer Application

3.  Configuring the Mouse and Keyboard

4.  Using the Keyboard to Navigate the Desktop

5.  Customizing the Appearance of the Desktop

6.  System Administration

Index

Orca Screen Reader and Magnifier

Orca is a flexible and powerful assistive technology for people with visual impairments. Using various combinations of speech synthesis, Braille, and magnification, Orca provides access to applications and toolkits that support the Assistive Technology Service Provider Interface (AT-SPI). Orca is free, open-source software.

The Orca Screen Reader and Magnifier applications help users with limited or no vision to use the Oracle Solaris Desktop and its associated applications. Orca provides the following functionalities:

Orca is a part of the GNOME platform and its releases are coupled with the GNOME platform releases.

The following sections provide information about Orca and how to use it.

Braille Support

Braille is supported through BRLTTY and is tightly integrated with Orca. BRLTTY offers support for nearly every refreshable Braille.

Also, Orca fully supports contracted Braille output.

Available Voices

Orca provides interfaces to both gnome-speech and emacspeak speech services. Currently available voices for Orca are restricted by the speech engines supported by the available speech services.

Some of the following speech engines are available:

Magnification in Orca

Orca currently uses the gnome-mag magnification service. The gnome-mag service has incorporated support for smoother full-screen magnification, which relies upon newer extensions in the X Window System server. These extensions do not always function well on all platforms, so smooth full-screen magnification might not always work.

To Enable Orca

This procedure describes how to enable Orca for the first time. Press Return after each action to proceed through the setup.

You can change the settings at any time by running the --text-setup option when you start Orca, or by pressing Insert+Spacebar while Orca is running to start the Orca Configuration GUI. The settings are saved in the ~/.orca/user-settings.py file. You need to log out and log back in for the new settings to take effect.

  1. Open a Run dialog by pressing Alt+F2 or Meta+R.
  2. Start the text-only guided setup by typing the following command:

    orca --text-setup Enter

  3. Select a language from the list.

    The default language is set to English.


    Note - Using the default eSpeak text-to-speech engine, Orca supports about 45 languages.


  4. Determine whether to activate the Echo by Word option, which instructs Orca to speak words as you finish typing, by typing y or n.
  5. Determine whether to activate the Key Echo option, which instructs Orca to speak all keys as they are pressed, by typing y or n.
  6. Choose the keyboard layout that determines which key should act as the Orca modifier key, which is used in conjunction with other keys to enable keyboard access to most of the program functions.

    The options are:

    • 1 – Desktop uses the Insert key

    • 2 – Laptop uses the Caps Lock key

  7. Indicate whether you require Braille output by typing y or n.

    This functionality assumes that a BRLTTY compatible device is available, although Orca can still function if you type y without a BRLTTY device available.

  8. Determine whether you want an on-screen Braille output monitor by typing y or n.

    This feature is useful for developers who need to verify BRLTTY output, but may also be useful in other situations, such as visually diagnosing or verifying Braille output.

    Orca should be enabled on your system.


    Note - If accessibility was not yet enabled, Orca enables accessibility and then advises you to log out and restart your login session.


Magnifier in Full Screen Mode

If you plan to use the Magnifier portion of Orca in full screen mode, confirm that the Xserver Composite extension is enabled. To enable the Xserver Composite extension, perform the following actions:

Using Orca

This section describes the usage of Orca.

Setting Up Orca

When you run Orca for the first time, the application automatically opens in setup mode. If you want to run setup at a later point, execute the --setup option the next time you run Orca. While Orca is running, you can press Insert+Spacebar to open the Orca Configuration GUI.

Orca's Configuration GUI also has an option to let you indicate that Orca should be started automatically when you log in. For more information about the Orca's graphical user interface, see Orca Configuration GUI.

Running Orca

Run Orca by typing the orca command in a terminal session window.

You can run Orca from a virtual console window if you do not yet have access to the GUI.

If the GUI is installed, press Alt+F2 or Meta+R. In the Run dialog, type orca (followed by any of the optional parameters) and press Return.

Orca automatically enters the text setup mode if you run it from a virtual console window.

Quitting Orca

  1. Press Insert+Q in the desktop mode or CapsLock+Q in the laptop layout mode, to quit Orca.

    A confirmation dialog appears.

  2. Select Quit to close Orca.

  3. If the system does not respond, you can perform any one of the following:

    • Press Ctrl+Alt+F1 to get to a virtual console and enter orca --quit command. Then, press Alt+F7 to get back to the desktop. This procedure kills the Orca process and reclaims system resources. You can then restart Orca by using the previously outlined methods.

    • Press Ctrl+Alt+Backspace to end your login session and get back to the graphical login prompt.

Orca Configuration GUI

The Orca Configuration GUI enables you to customize the behavior and features of Orca, such as speech, Braille, and magnification. For example, you can select the type of speech synthesis engine you want to use, enable or disable Braille, and the type of magnification preferences you want to set. You can select the keyboard layout you want (desktop or laptop) and also examine and modify the existing keyboard layout.

To open the Orca Configuration GUI, press Orca Modifier+Spacebar, where Orca Modifier is the Insert key when you use the Desktop keyboard layout and CapsLock key when you use the Laptop keyboard layout. To change settings for a single application, press Ctrl+Orca Modifier+ Spacebar while the application has focus.

For more information about the Desktop keyboard layout, see Using the Desktop Layout Commands.

For more information about the Laptop keyboard layout, see Using the Laptop Layout Commands.

Enabling General Preferences in Orca

The General page enables you to customize general settings of Orca such as selecting the keyboard layout and starting and quitting Orca. The options in the General page are described in the following sections.

image:Figure displaying the Orca general preferences.
Keyboard Layout

The keyboard layout section enables you to select the Desktop or Laptop layout.

For more information about the Desktop keyboard layout, see Using the Desktop Layout Commands.

For more information about the Laptop keyboard layout, see Using the Laptop Layout Commands.

Show Orca Main Window

The Orca main window enables you to display the Orca Configuration GUI.

image:Figure displaying the Orca main window

The main window provides a Quit option to close the Orca Configuration GUI. You can also quit Orca by pressing Orca Modifier+Q. Because the Orca main window is included in the window manager's tab order when you press Alt+Tab to switch windows, you might want to deselect the Show Orca main window button.

Quit Orca Without Confirmation

When you press Orca Modifier+K to quit Orca or press the Quit button in the Orca main window, Orca displays a confirmation dialog asking whether you want to quit. Select this option to prevent the confirmation window from appearing again.

Disable gksu Keyboard Grab

When running commands from the Launch menu, many distributions use an application known as gksu to authorize the user to run these commands. gksu is the GUI which asks you for your password. When gksu runs, the application enables the keyboard grab feature.

Keyboard grab is a feature to prevent keyboard actions from going to any other application on the desktop, including Orca. The result of a keyboard grab is that Orca will not receive any keyboard events, preventing it from functioning normally.

By selecting the Disable gksu Keyboard Grab button, you can turn off the keyboard grab behavior, allowing Orca to function normally with system administration applications.


Note - The keyboard grab is a security attempt by gksu to prevent applications from sniffing the keyboard and grabbing secret information. Disabling the gksu keyboard grab feature can expose you to such behavior. You can use the root account for system administration purposes. To do this for system administration purposes, you need to enable the root account for login, and then logout and log back in as root whenever you want to perform a system administration command.


Present Tooltips

The Present tooltips option displays information in tooltips that appear as the result of mouse hovering. Pressing Ctrl+F1 when an object has focus always displays tooltips regardless of this setting.

Speak Object Under Mouse

When the Speak Object Under Mouse option is selected, Orca presents audio information about the object under the mouse.

Start Orca When You Login

When the Start Orca When You Login option is selected, the system automatically launches Orca when you log in.

Enabling Speech Preferences in Orca

The Speech page enables you to customize the Orca speech synthesis settings.

image:Figure displaying the Orca speech preferences.
Enable Speech

The Enable Speech option causes Orca to make use of a speech synthesizer.

Speech System and Speech Synthesizer

These options enable you to select the speech system and synthesizer. Orca provides support for a growing number of speech systems. These include GNOME-speech, Emacspeak, and an experimental backend for Speech Dispatcher. Depending on the machine configurations, you might have all or none of these options. By default, only GNOME-speech is available.

First, determine which speech system you would like to use. Then, choose from the Speech Synthesizer list of available synthesizers.

Voice Settings

If your synthesizer supports voice settings, Orca can use multiple voices to identify special cases within an application, such as hyperlinks or uppercase text. Use the Voice Settings and Person options to customize these settings. For example, assume you are using Fonix DECtalk and want the Betty voice to denote uppercase. Do the following:

  1. Select the uppercase voice for the Voice Settings option.

  2. For the Person option, select the Betty voice.

Use the next sliders to set the synthesizer's rate, pitch, and volume.

Punctuation Level

Use the Punctuation Level setting to adjust the amount of punctuation spoken by the synthesizer. The following levels are available:

Verbosity

The Verbosity setting determines the amount of information that is spoken in certain situations. For example, if the Verbose level is set, the synthesizer speaks shortcut keys for items in menus. When it is set to Brief, these shortcut keys are not announced.

Table Row Speech

The Table Row Speech option determines the way the speech synthesizer will read items within tables. The following settings are available:

The ability to adjust this behavior can be useful in many situations. For example, consider the process of browsing email messages in Evolution. In this instance, the Speak current row setting is preferable. While navigating through the list of messages, all relevant info, such as the sender, subject, and whether the message has attachments, is read automatically. While the current row setting is active, you can still read individual cells by using the left and right arrows.


Note - To toggle this behavior, press Orca Modifier+F11.


Speak Blank Lines

To hear the word blank when navigating to a blank line in a document, select the Speak Blank Lines option.

Speak Multicase Strings as Words

The Speak Multicase Strings As Words option causes Orca to break a word prior to passing it along to the speech synthesizer. So words in code, consisting of several words with alternating case are pronounced correctly.

For example, the word “MultiCaseString” can be broken into separate words Multi, Case, and String.

Speak Tutorial Messages

If the Speak Tutorial Messages option is selected, when moving from one component to another in an interface, Orca provides information about the component that is currently focused.

Speak Object Mnemonics

The Speak Object Mnemonics option causes Orca to announce the mnemonic associated with the object in focus. For example, Alt+O for the OK button.

Break Speech Into Chunks Between Pauses

Depending on the enabled speech settings, Orca might provide some information about a particular object such as its name, role, state, mnemonic, and tutorial message. The Break Speech Into Chunks Between Pauses option causes Orca to insert brief pauses in between each piece of information.

To Speak Child Position

The Speak Child Position checkbox enables Orca to announce the position of the focused item in menus and lists. For example, 9 of 16.

To Speak Indentation and Justification

The Speak Indentation And Justification option causes Orca to provide justification and indentation information.

Progress Bar Updates

If the Speak Progress Bar Updates setting is enabled, Orca periodically announces the status of progress bars. How often the announcement is made is determined by the value chosen as the Update interval spin. This setting is only available if the Speak Progress Bar Updates option is selected.

Use the Restrict Progress Bar Updates setting to control which progress bars should be spoken. The default value is Application. The following choices are available:

Say All By

The Say All By setting specifies whether the Say All functionality of Orca speaks by sentence or line.

Enabling Braille Preferences in Orca

The Braille page enables you to customize various aspects about the use of Braille.

image:Figure displaying the Orca Braille preferences.

Note - Orca does not automatically start BRLTTY for you. You need to do this at boot time.


Enable Braille Support

Select the Enable Braille Support option to make use of a Braille display. By default, this option is enabled.

If BRLTTY is not running, Orca recovers gracefully and does not communicate with the Braille display. If you configure BRLTTY later, you need to restart Orca to use Braille.

Enable Braille Monitor

Orca's Braille monitor provides an on-screen representation of what takes place on the Braille display. This feature is mostly for demonstration purposes, but is also useful for Orca developers who do not have access to a Braille display.

Enable Abbreviated Role Names

The Abbreviated Role Names check box determines the manner in which role names are displayed and can be used to help conserve real estate on the Braille display. For example, if a slider had focus and the Abbreviated Role Names option is selected, the word “slider” is abbreviated to “sldr”.

Disable End of Line Symbol

The Disable end of line symbol option tells Orca to not present the $l string at the end of a line.

Contracted Braille

Orca supports contracted Braille through the Liblouis project. Refer to the Orca wiki to find additional information about setting up Liblouis with Orca.

Verbosity

The Verbosity options determine the amount of information that will be displayed in Braille in certain situations. For example, if the option is set to Verbose, keyboard shortcut and role name information is displayed. This information is not displayed in Brief mode.

Enable Selection Indicator

When you select text, Orca underlines the text on your Braille display with dots 7 and 8. If you prefer, you can change the indicator to Dot 7 or Dot 8, or not provide an indicator.

Enable Hyperlink Indicator

When you encounter a hyperlink, Orca underlines that text on your Braille display with dots 7 and 8. If you prefer, you can change the indicator to Dot 7 or Dot 8, or not provide an indicator.

Enabling Key Echo Preferences in Orca

The Key Echo page enables you to specify the behavior of Orca when pressing keys on the page and whether words are spoken as you complete them.

image:Figure displaying the Orca key echo preferences.

The key echo feature offers increased flexibility. For example, one user might choose to enable all the key echo options, while another might prefer to use word echo, but only have locking keys announced.

Enable Key Echo

The Enable Key Echo option provides specific settings for the key echo feature:

Enable Echo by Character

The Enable Echo by Character option causes an echo of the characters you just typed. While echo by character seems similar to the key echo of alphanumeric and punctuation keys, there are important differences related to accented letters and other symbols for which there are no dedicated keys. Key echo announces the key that is just pressed and character echo announces the characters that was just inserted.

The Echo by Character option is always available, regardless of whether any of the other key echo options are selected.

Enable Echo by Word

The Enable Echo by Word option causes an echo of the word you just typed. The Echo by Word option is always available, regardless of whether any of the key echo options are selected.

Enable Echo by Sentence

The Enable Echo by Sentence option causes an echo of the sentence you just typed. The Enable Echo by Sentence control is always available regardless of whether any of the other key echo options are selected.

Enabling Magnifier Preferences in Orca

The Magnifier page enables you to enable or disable magnification and specify how magnification must be performed.

image:Figure displaying the Orca magnifier preferences.
Enable Magnifier

The Enable Magnifier option causes Orca to provide magnification.

Zoomer Settings

Two zoomer GUI controls determine magnification characteristics:

Border Settings

The Enable Border option determines whether a window border is visible for the magnifier. The Border Size option determines the size of the border in pixels.


Note - These options are not available in Full Screen mode.


Cursor Settings

You can use Cursor Settings to customize the size and color of the magnifier's cursor by using the following options:

Cross-hair Settings

You can use Cross-hair Settings to customize the magnifier's optional area-targeting cursor by using the following options:

Color Settings

Color Settings enables you to adjust the color of the magnified region by using the following options:

Tracking and Alignment Settings

Tracking and Alignment Settings control the tracking of the mouse cursor. The following tracking and alignment settings options are available:

Enabling Key Bindings Preferences in Orca

The Key Bindings page enables you to examine and modify the key bindings for Orca.

image:Figure displaying the Orca key binding preferences.
Orca Modifier Keys

The first control on the Key Bindings window enables you to determine which key or keys act as the Orca modifier. The Orca Modifier is the key that you press and hold in conjunction with other keys to give commands to Orca.

For desktop keyboards, the default Orca Modifier is the Insert key. For laptop keyboards, the default Orca Modifier is the Caps Lock key. See the Desktop keyboard layout and Laptop keyboard layout sections for the default values.


Note - You cannot modify the Orca modifier key by using the Configuration GUI.


Using the Key Bindings Table

The Key Bindings table provides a list of Orca operations and keys that are bound to them.

image:Figure displaying the Orca key binding preferences.

Beneath the list of Orca keybindings, is a group of unbound commands. These commands are useful for some users but not needed by most users. Rather than appropriating a keystroke for such commands, these keys are unassigned.

You can assign a keystroke to any of these unbound commands as follows:

  1. Press Return to edit the keybinding.

  2. Press Delete or Backspace when prompted for the new keybinding.

  3. Press Return to confirm.

Enabling Pronunciation Preferences in Orca

Sometimes your speech synthesizer might not correctly use words to convey or pronounce a particular string. For example, you might prefer to hear "laughing out loud" rather than "LOL," or a name or a technical term the synthesizer might mispronounce. On the pronunciation page, you can add, edit, and delete Orca's pronunciation dictionary entries. The pronunciation page is part of the Application-specific Settings dialog that is started when you give a particular application focus and type Orca Modifier+Ctrl+Spacebar. You can therefore customize your entries as you need for each application that you use.

image:Figure displaying the Orca pronunciation preferences.

To Add a New Dictionary Entry

  1. Press the New Entry button or Alt+N.
  2. Type the text of the new entry and press Return to finish editing the actual string.
  3. Move to the Replacement String column and press Return to begin editing.
  4. Type the text that you would like to have spoken instead. Press Return to finish editing the replacement string.

To Edit an Existing Dictionary Entry

  1. Move to the cell you want to edit and press Return to begin editing.
  2. Make your changes and then press Return to finish editing.

To Delete an Existing Dictionary Entry

  1. Move to the entry you want to delete.
  2. Press the Delete button or Alt+D.

Text Attributes Page

Orca speaks known text attribute information about an object when you press Orca Modifier. The Text Attributes page of the configuration GUI enables you to customize the text attributes that Orca will present.

image:Figure displaying the Orca text attributes preferences.

This page displays a text attribute list, where each row consists of four columns:

Use the Reset button (Alt+R) to set the list values back to their initial state when the dialog is first displayed.

When you initially display the text attribute pane, all the selected attributes are displayed at the top of the list. They are given in the order that they will be spoken and used in Braille.

To select others or adjust the order, use the Adjust Selected Attributes buttons:

Use the Braille Indicator buttons to select the cell or cells to be used to indicate text which has at least one of the specified attributes. The choices are:

Text attributes can also be set on an individual application basis. The Text Attribute pane is also part of the Application-specific Settings dialog box that is started when you give a particular application focus and type Orca Modifier+Ctrl+Spacebar.

Using the Orca Keyboard Commands

The Key Bindings page provides a complete list of the available keyboard commands of the Orca Configuration GUI. To open the Orca Configuration GUI, press Orca Modifier+Spacebar.

To enter Orca's Learn mode while running Orca, press Orca Modifier+H. When in Learn mode, Orca will intercept all keyboard and Braille input events and indicate what the effect would be. To exit Learn mode, press the Escape key.

Orca provides additional commands for some applications, such as Firefox. To display the list of additional commands for an application, press Ctrl+Orca Modifier+Spacebar when that application has focus. The Orca Configuration GUI opens in the application-specific state, and additional commands appear in the Key Bindings page.

The GNOME Desktop also has built in keyboard commands to control the desktop and its applications. For more information about the GNOME shortcut keys, see Chapter 4, Using the Keyboard to Navigate the Desktop


Caution

Caution - The MouseKeys use the KP_Insert key to emulate a mouse button press. When enabled, MouseKeys can conflict with KP_Insert as the Orca modifier, resulting in a stuck Orca modifier key. As an alternative, you can use the laptop key bindings, which avoid the keypad for Orca commands. If you accidentally enable MouseKeys, you can disable it using the gnome-keyboard-properties application.


Using the Desktop Layout Commands

The following sections list the common Orca keyboard commands for desktop keyboards arranged by category.

Flat Review Keyboard Commands

The following table lists the keyboard shortcuts for the flat review commands when you use the desktop layout.

Keys
Function
Numpad+7
Moves the flat review cursor to the previous line and reads it
Numpad+8
Reads the current line
Numpad+9
Moves the flat review cursor to the next line and reads it
Numpad+4
Move the flat review cursor to the previous word and reads it
Numpad+5
Reads the current word
Numpad+6
Moves the flat review cursor to the next word and reads it
Numpad+1
Moves the flat review cursor to the previous character and reads it
Numpad+2
Reads the current character
Numpad+3
Moves the flat review cursor to the next character and reads it
Numpad+Slash
Performs left mouse click at the location of the flat review cursor
Numpad+Asterisk
Performs right mouse click at the location of the flat review cursor
Numpad+Minus sign
Toggles between flat review and focus tracking modes

Note - These commands apply when working with objects as well as when working with text. For example, if the flat review cursor is positioned on a menubar, issuing the “read current line” command would speak the names of all visible menus. Similarly, issuing the “read next word” command would speak the object to the right of the flat review cursor on the same line, or move flat review to the next line if no more objects were found.


Bookmark Keyboard Commands

The following table lists the shortcut keys for the bookmark commands when you use the desktop layout.

Keys
Function
Alt+Insert+[1-6]
Assigns a bookmark to a numbered slot. If a bookmark already exists in the slot, the bookmark is replaced with a new one.
Insert+[1-6]
Goes to the position pointed to by the bookmark bound to this numbered slot.
Alt+Shift+[1-6]
Where Am I information for this bookmark relative to the current pointer location.
Insert+B and Insert+ Shift+B
Moves between the given bookmarks for the given application or page.
Alt+Insert+B
Saves the defined bookmarks for the current application or page.
Miscellaneous Functions

The following table lists the shortcut keys for miscellaneous functions when you use the desktop layout.

Keys
Function
Numpad+Plus sign
Say All command. Reads from the current position of the caret to the end of the document.
Numpad+Return
Where Am I command. Speaks information such as the title of the current application window, as well as the name of the control that currently has focus.
Insert+H
Enters Learn mode. Press Escape to exit.
Insert+F
Speaks font and attribute information for the current character.
Insert+Spacebar
Displays the Orca Configuration dialog box.
Insert+Ctrl+Spacebar
Reloads user settings and reinitializes services as necessary. Also, displays the Orca Configuration dialog box for the current application.
Insert+S
Toggles speech on and off.
Insert+F11
Toggles reading of tables, either by a single cell or a whole row.
Insert+Q
Quits Orca.
Debugging Keyboard Commands

The following table lists the shortcut keys for the debugging commands when you use the desktop layout.

Keys
Function
Ctrl+Alt+Insert+Home
Reports information on the currently active script.

Note - To use the next three commands, Orca must be started from a virtual console or through the gnome-terminal. Output is sent to the console only and not to speech or Braille.


Ctrl+Alt+Insert+End
Prints a debug list of all the known applications to the console where Orca is running.
Ctrl+Alt+Insert+ Page Up
Prints debug information about the ancestry of the object with focus.
Ctrl+Alt+Insert+ Page Down
Prints debug information about the hierarchy of the application with focus.

Using the Laptop Layout Commands

Following is a list of common Orca keyboard commands for laptop keyboards arranged by category.

Flat Review Keyboard Commands

The following table lists the keyboard shortcuts for the flat review commands when you use the Laptop layout.

Keys
Function
Caps Lock+U
Moves the flat review cursor to the previous line and reads it. Double-click to move flat review to the top of the current window.
Caps_Lock+I
Reads the current line. Double-click to read the current line with formatting and capitalization details.
Caps Lock+O
Moves the flat review cursor to the next line and reads it. Double-click to move flat review to the bottom of the current window.
Caps Lock+J
Moves the flat review cursor to the previous word and reads it. Double-click to move flat review to the word above the current word.
Caps Lock+K
Reads the current word. Double-click to spell the word. Triple-click to hear the word spelled phonetically.
Caps Lock+L
Moves the flat review cursor to the next word and reads it. Double-click to move flat review to the word below the current word.
Caps Lock+M
Moves the flat review cursor to the previous character and reads it. Double-click to move flat review to the end of the current line.
Caps Lock+Comma
Reads the current character. Double-click to pronounce the character phonetically if it is a letter.
Caps Lock+Period
Moves the flat review cursor to the next character and reads it.
Caps Lock+7
Performs a left mouse click at the location of the flat review cursor.
Caps Lock+8
Performs a right mouse click at the location of the flat review cursor.
Caps Lock+p
Toggles between flat review and focus tracking mode.

These commands apply when working with objects as well as when working with text. For example, if the flat review cursor is positioned on a menubar, issuing the “read current line” command speaks the names of all visible menus. Similarly, issuing the “read next word” command speaks the object to the right of the flat review cursor on the same line, or move flat review to the next line if no more objects were found.

Bookmark Keyboard Commands

The following table lists the keyboard shortcuts for the bookmark commands when you use the laptop layout.

Keys
Function
Alt+Caps Lock+[1-6]
Adds a bookmark to the numbered slot. If a bookmark already exists for the slot, it is replaced with the new one.
Caps Lock+[1-6]
Goes to the position pointed to by the bookmark bound to this numbered slot.
Alt+Shift+[1-6]
Where Am I information for this bookmark relative to the current pointer location.
Caps Lock+B
Moves between the given bookmarks for the given application or page.
Alt+Caps Lock+B
Saves the defined bookmarks for the current application or page.
Miscellaneous Keyboard Commands

The following table lists the shortcut keys for the miscellaneous functions when you use the Laptop layout.

Keys
Function
Caps Lock+Semicolon
Say All command. Reads from the current position of the caret to the end of the document.
Caps Lock+Return
Where Am I command. Speaks information such as the title of the current application window, as well as the name of the control that currently has focus.
Caps Lock+H
Enters Learn mode. Press Escape to exit.
Caps Lock+F
Speaks font and attribute information for the current character.
Caps Lock+Spacebar
Starts the Orca Configuration dialog.
Caps Lock+Ctrl+Spacebar
Reloads user settings and reinitialize services as necessary. It also starts the Orca Configuration dialog for the current application.
Caps Lock+S
Toggles speech on and off.
Caps Lock + F11
Toggles reading of tables, either by single cell or whole row.
Caps Lock + Q
Quits Orca.
Debugging Keyboard Commands

The following table lists the shortcut keys for the debugging commands when you use the Laptop layout.

Keys
Function
Caps Lock+Alt+Ctrl+Home
Reports information on the currently active script.

Note - In order for the next three commands to be of use, Orca needs to be started from a virtual console or using the gnome-terminal. The output is sent to the console only and not sent to speech or Braille.


Caps Lock+Alt+Ctrl+End
Prints a debug listing all known applications to the console where Orca is running.
Caps Lock+Alt+Ctrl+ Page Up
Prints debug information about the ancestry of the object with focus.
Caps Lock+Alt+Ctrl+Page Down
Prints debug information about the object hierarchy of the application with focus.

Application-Specific Information

Orca is designed to work with applications and toolkits that support the Assistive Technology Service Provider Interface (AT-SPI). These applications include the Oracle Solaris Desktop and its bundled applications: OpenOffice, Firefox, and the Java platform.

Making Application-Specific Settings

  1. To customize the settings for a particular application, start that application.
  2. Ensure that the application has focus and then press Orca Modifier+Ctrl+Spacebar.

    A tabbed dialog window similar to the Orca Configuration dialog is displayed with the following differences:

    • No initial General pane.

    • The Speech System and Speech Synthesizer options on the Speech pane are inactive.

    • Any application-specific key bindings appear at the top of the list on the Key Bindings pane.

    • A new application-specific settings pane might appear at the end of the standard set of tabs. Press the End key from the tab list to go directly to the right-most tab.

    Adjust your application-specific settings. For example, you might have Key Echo disabled generally in Orca but would like to specifically have it enabled for the GNOME Calculator application.

    When you have customized your application settings, click OK.

    These settings are written to your ~/.orca/app-settings directory in a file called APPNAME.py, where APPNAME is the name of the application.

    Orca automatically writes these files. The contents of the file are overwritten each time you change your application settings for that application.

    To retain any application-specific settings or code, copy them to a file called ~/.orca/app-settings/APPNAME-customizations.py. This file is automatically read when the settings for the application are loaded.


    Note - If you adjust one or more application-specific key bindings, the new values will not take effect until you click OK. The workaround is to either restart Orca, or to press Alt+Tab to move to another application and then press Alt+Tab to return to the application for which you have just changed the key bindings.


To Enable Braille

Orca uses BRLTTY for Braille support. BRLTTY is used to access the text mode console content. On a typical Braille-enabled installation of Oracle Solaris, BRLTTY is already running and provides access to text consoles. When Orca starts, it connects to BRLTTY. If you switch from a text console to your X Windows session, your Braille display automatically follows and displays the content that Orca is presenting to you.

Orca currently works best with BRLTTY v3.8 or better and also works well with BRLTTY v3.7.2. This document provides information about using Orca with BRLTTY 3.8.

Troubleshooting Orca

This section describes troubleshooting topics in Orca.

Desktop Is Unresponsive

  1. Press Alt+F2 or Meta+R to open the Run dialog.

  2. Type orca and press Return to start a new instance of Orca.

    This will force any existing Orca processes to exit and then restart Orca.

    Sometimes, this step might cause the desktop to hang, which is usually because of an ill-behaved application.


Note - If you cannot get to a terminal window, try pressing Ctrl+Alt+Backspace, which shuts down the X Window System server.

This action should return you to the login screen.