[orca-devel] Enhancements made for orca's sayall functionality , for presentation of browser and office contents.

[<pjansirani cdac in>]

Hi All,

I have added 1 feature and made 2 enhancements relevant with sayall
functionality.

List of Features:

1.SOFFICE - For Word Documents:

 1. Download As MP3
--------------------
    During sayall, in order to keep the content in MP3 or any other
recorded audio format, Orca users need to copy the content manually to any
TTS engine, for ex. geospeaker.This overhead can be avoided by providing
this functionality in orca itself.
    Implementation:
        a. Orca + d - Call the recordSayAllContent() - which will enable
sayall event along with, it will copy the contents to a text file
        b. Shift+Alt+d - Call the downloadAsMP3() - which will generate MP3 file
from the text content using espeak.

 2. Presentation of Table information which includes,
-------------------------------------
        a. No of Rows and Columns - Added generateTotalRowsAndColumns() in Speech
generator
        b. Row and Column Index - Added generateColumnAndRowDetails() in Speech
generator
        c. Indication of "End of Table" - Used generateEndOfTableIndicator()
   ex: Table contains 2 Rows and 2 Columns. Row 1 Column 1: Roll No....End
Of Table

 3. Presentation of link
------------------------
        a. Have used the function adjustForLinks() which was written
already.
   ex: www.google.com link

 Below the list of files where these changes were made:
------------------------------------------------------
        1. orca/scripts/default.py 
                Even though these features added with sayAll() already in a common file,
which will be called by all applications, have made a                condition to
work only for soffice . It can be added in soffice application script
itself, but
                       a. It leads to the Repetition of same code in 2 places.
                       b. Many events have been handled in sofice script,so this
functionality may not work properly.
                       c. To avoid this have added the code in default.py, and made one
condition for this to work only for soffice.

        2. orca/speech_generator.py - generateTotalRowsAndColumns(),
generateColumnAndRowDetails() new functions added to provide table
informtion.
        3. orca/common_keyboardmap.py - to include keyboard mapping for ORCA+d,
Shift_Alt_d

2. BROWSER - Gecko Script

 1. Download As MP3
------------------
    During sayall, in order to keep the content in MP3 or any other
recorded audio format, Orca users need to copy the content manually to any
TTS engine, for ex.geospeaker. This overhead can be avoided by providing
this functionality in orca itself.
    Implementation:
        a. Orca + d - Call the recordSayAllContent() - which will enable
sayall event along with it will copy the contents to a text file
        b. Shift+Alt+d - Call the downloadAsMP3() - which will generate MP3 file
from the text content using espeak.

 2. Presentation of Table information which includes,
------------------------------------
        a. No of Rows and Columns - Added generateTotalRowsAndColumns() in Speech
generator

 Below the list of files where these changes were made:
------------------------------------------------------
        1. orca/scripts/toolkits/Gecko/script.py 
                It is handling sayAll() event aready, so added new code there itself.
        2. orca/speech_generator.py - common files where text to be spoken was
generated.
                                    - generateTotalRowsAndColumns(), generateColumnAndRowDetails() new
functions added to provide table informtion. 
        3. orca/common_keyboardmap.py - to include keyboard mapping for ORCA+d,
Shift_Alt_d


Will update patch files in Bugzilla. 

Please provide your suggestions.


Thanks,
P. Jansi Rani

-------------------------------------------------------------------------------------------------------------------------------

This e-mail is for the sole use of the intended recipient(s) and may
contain confidential and privileged information. If you are not the
intended recipient, please contact the sender by reply e-mail and destroy
all copies and the original message. Any unauthorized review, use,
disclosure, dissemination, forwarding, printing or copying of this email
is strictly prohibited and appropriate legal action will be taken.
-------------------------------------------------------------------------------------------------------------------------------