home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 2006 November (DVD) / PCWELT_11_2006.ISO / casper / filesystem.squashfs / usr / share / doc / gnome-orca / README < prev   
Encoding:
Text File  |  2006-08-21  |  3.9 KB  |  96 lines
  1. Orca 0.9.0
  2.  
  3. Introduction
  4. ========================================================================
  5.  
  6. Orca a scriptable screen reader for people with visual impairments.
  7. To read more about Orca, including its capabilities and known
  8. limitations, please refer to the Orca documentation series available
  9. in the ./docs/doc-set directory and also the Orca WIKI at
  10. http://live.gnome.org/Orca.
  11.  
  12.  
  13. Build Requirements
  14. ========================================================================
  15.  
  16. Orca depends upon GNOME 2.14 or better.  Building Orca also requires
  17. the development modules for the following to be installed:
  18.  
  19. * Python >= 2.4              - Python platform
  20. * pyorbit >= 2.14.0          - Python bindings for ORBit2
  21. * pygtk >= 2.8.4             - GTK+ Python bindings
  22. * gnome-python >= 2.6.2      - Python bindings for various GNOME libraries
  23. * libspi-1.0 >= 1.7.6        - Python bindings for AT-SPI
  24. * gnome-speech-1.0 >= 0.3.10 - Python bindings for gnome-speech
  25. * gnome-mag-1.0 >= 0.12.5    - Python bindings for gnome-mag (optional) 
  26. * BrlTTY >= 3.7.2            - BrlTTY support for braille (optional)
  27. * BrlAPI >= 0.4.1            - BrlAPI support for braille (optional)
  28.  
  29. NOTE: If you have multiple versions of the python interpreter installed
  30. on your machine, you should set the PYTHON environment variable when 
  31. configuring Orca.  For example:
  32.  
  33.    PYTHON=/usr/bin/python2.4 ./autogen.sh
  34.  
  35. or
  36.  
  37.    PYTHON=/usr/bin/python2.4 ./configure
  38.  
  39.  
  40. Overview
  41. ========================================================================
  42.  
  43. One of the biggest challenges in screen reading technology is
  44. providing a consistent user experience across multiple applications
  45. which may use objects in different ways, and to allow quick access to
  46. information which may not be easily accessible through an
  47. application's keyboard navigation commands.  Orca explores how to
  48. solve some of these difficulties.  Some common scenarios which Orca's
  49. script-based architecture would be suited to solve:
  50.  
  51. * An application which displays text of interest to the user in a
  52.   non-focusable object
  53.  
  54. * Create hot keys to be used in certain applications to collect and
  55.   read various pieces of information
  56.  
  57. * Cause the Braille display to show status information retrieved from
  58.   status bars or other objects in the application
  59.  
  60. Orca is written in primarily in Python.  Orca defines a set of default
  61. behaviors (reactions to application events) and key bindings (reaction
  62. to user key presses).  These default behaviors and key bindings can be
  63. overwritten on a per-application basis.  Orca creates a script object
  64. for each running application, which merges both the default behaviors
  65. and key bindings with the application-specific ones.  Orca provides
  66. the infrastructure to activate and deactivate scripts as well as a
  67. host of services accessible from within the scripts.  Some of these
  68. services include:
  69.  
  70. * A speech module which provides named voices definable by the user
  71.  
  72. * A braille module which uses BrlTTY to provide high-level
  73.   braille services to scripts - these services include braille
  74.   keyboard callback support, software-based virtual regions for the
  75.   braille display, and scrolling management
  76.  
  77. * Convenience functions for finding the labels of objects, getting all the
  78.   objects within a given object, etc.
  79.  
  80.  
  81. Initial Setup
  82. ========================================================================
  83.  
  84. The first time you run orca using the "orca" command, it will
  85. automatically launch the setup utility.  The setup utility creates a
  86. .orca directory in your home directory.  This directory stores your
  87. user settings as well as any scripts you want use that are not part of
  88. the default Orca installation.  If you wish to rerun the setup
  89. utility, you ccan run orca with the "--setup" or "--text-setup"
  90. options, and you can also press "Insert+Space" when Orca is running to
  91. bring up the GUI setup utility.
  92.  
  93. You can also bypass the setup utility by running orca with the
  94. "--no-setup" option.  This is useful for running from environments
  95. such as the login screen.
  96.