g f ldZdZdZdZdZdZddlZddlZejdd dd l m Z ddl Z ddl Z ddlZ ddl Z d d lmZd d lmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dlmZd dl m!Z!d dl"m#Z#d dl$m%Z%d dl&m'Z'GddZ(e(gZ)Gdd Z*e*gZ+d!Z,d"Z-d#Z.d$Z/d%Z0d&Z1d'Z2e-ejfe.ejhe/ejje0ejle1ejle2ejliZ7Gd(d)ejpZ9y)*z6Utilities for obtaining speech utterances for objects.z$Id:$z $Revision:$z$Date:$z-Copyright (c) 2005-2009 Sun Microsystems Inc.LGPLNAtspiz2.0)r)acss)debug) generator) mathsymbols)messages)object_properties)settings)settings_manager)speech)text_attribute_names) AXDocument) AXHypertext)AXObject)AXTable)AXText) AXUtilities)AXValueceZdZdZdZdZy)PausezJA dummy class to indicate we want to insert a pause into an utterance.cyNselfs 7/usr/lib/python3/dist-packages/orca/speech_generator.py__init__zPause.__init__; cy)NPAUSErrs r__str__z Pause.__str__>sr!N__name__ __module__ __qualname____doc__rr$rr!rrr8s r!rceZdZdZdZdZy) LineBreakzYA dummy class to indicate we want to break an utterance into separate calls to speak.cyrrrs rrzLineBreak.__init__Fr r!cy)Nz LINE BREAKrrs rr$zLineBreak.__str__Isr!Nr%rr!rr+r+Cs  r!r+ _generatedefault uppercase hyperlinksystemstatevaluec|eZdZdZdZdZdZdfd ZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!d Z"d!Z#fd"Z$d#Z%d$Z&d%Z'fd&Z(d'Z)fd(Z*d)Z+d*Z,d+Z-d,Z.d-Z/d.Z0d/Z1fd0Z2fd1Z3fd2Z4d3Z5d4Z6d5Z7d6Z8d7Z9d8Z:d9Z;d:Zd=Z?d>Z@d?ZAd@ZBdAZCgdBfdCZDdDZEdEZFdFZGfdGZHdHZIfdIZJdJZKfdKZLdLZMfdMZNdNZOdOZPdPZQdQZRdRZSdSZTdTZUdUZVdVZWdWZXdXZYdYZZdZZ[d[Z\d\Z]d]Z^d^Z_d_Z`d`ZadaZbdbZcfdcZdfddZedeZfdfZgdgZhdhZidiZjdjZkdkZldlZmdmZndnZodoZpdpZqdqZrdrZsdsZtdtZuduZvdvZwdwZxdxZydyZzdzZ{d{Z|d|Z}d}Z~d~ZdZdZdZdZdZdZdZdZddZdZxZS)SpeechGeneratorzTakes accessible objects and produces a string to speak for those objects. See the generateSpeech method, which is the primary entry point. Subclasses can feel free to override/extend the speechGenerators instance field as they see fit.cFtjj||dy)Nr)r Generatorr)rscripts rrzSpeechGenerator.__init__ms$$T68z0SpeechGenerator.generateSpeech..xs 1e0D,Dr!zSPEECH GENERATOR: Results forzare pauses onlyT)generatelistfilterr printTokens LEVEL_INFO)robjargsrvtokenss rgenerateSpeechzSpeechGenerator.generateSpeechvsX T]]3 '$ ' d6"DbIJ5s.sQr!)r@rACSSrE_resultElementToStringjoinrFsuper)relement includeAllrBrK __class__s rrSz&SpeechGenerator._resultElementToStringsn gtyy )* gt $FMN$--a<NBN88F;34 4w-gzBBOsA:c |jdtj|}|tjj k(r%t jjdrgStjj||fi|}|ro|tjj k(r*|j|jtfd|i||S|j|jtfd|i||S)a Returns an array of strings for use by speech and braille that represent the name of the object. If the object is directly displaying any text, that text will be treated as the name. Otherwise, the accessible name of the object will be used. If there is no accessible name, then the description of the object will be used. This method will return an empty array if nothing can be found. [[[WDW - I wonder if we should just have _generateName, _generateDescription, _generateDisplayedText, etc., that don't do any fallback. Then, we can allow the formatting to do the fallback (e.g., 'displayedText or name or description'). [[[JD to WDW - I needed a _generateDescription for whereAmI. :-) See below. roleonlySpeakDisplayedTextrI)getrget_rolerRole LAYERED_PANEr getManager getSettingrr8 _generateNameextendr;SYSTEMDEFAULT)rrIrJrZresults rrbzSpeechGenerator._generateNamesxx 1 1# 67 5::** ***,778PQI$$224EE uzz... jdjjASADAB  jdjjBcBTBC r!c tjj||fi|}|r(|j|jt fd|i||S)aReturns the label for an object as an array of strings for use by speech and braille. The label is determined by the displayedLabel method of the script utility, and an empty array will be returned if no label can be found. rI)rr8_generateLabelrcr;rerrIrJrfs rrhzSpeechGenerator._generateLabelsJ$$33D#FF  MM*$**W>#>> ? r!c |jdtj|}|tjj k(rQ|j jj|r,d|dg}tjtj|dgSg}|j|j|fi||sPtj|}|r9|j||j|j t"fd|i||r|Stj$|}t'j(|r|j*|fi|}|S)zReturns the label as an array of strings for speech and braille. If the label cannot be found, the name will be used instead. If the name cannot be found, an empty array will be returned. rZzSPEECH GENERATOR:zis popup menu for current item.TrI)r\rr]rr^MENU_script utilitiesisPopupMenuForCurrentItemrrGrHrcrhget_nameappendr;re get_parentris_autocomplete_generateLabelOrName)rrIrJrZrLrfnameparents rrsz$SpeechGenerator._generateLabelOrNames xx 1 1# 67 5::?? "t||'='='W'WX['\)30QRF   e.. =I )d))#667$$S)D d# jdjjBcBTBC M$$S)  & &v ..T..v>>F r!c tjj||fi|}|r(|j|jt fd|i||S)aReturns an array of strings for use by speech and braille that represent the 'placeholder' text. This is typically text that serves as a functional label and is found in a text widget until that widget is given focus at which point the text is removed, the assumption being that the user was able to see the text prior to giving the widget focus. rI)rr8_generatePlaceholderTextrcr;reris rrwz(SpeechGenerator._generatePlaceholderTextsJ$$==dCP4P  MM*$**W>#>> ? r!c |j|fi|xs|j|fi|}|rd|jjd<|Sd|d<|j|fi|}|rd|jjd<|S)NFusedDescriptionForAlertT alerttext)_generateExpandedEOCs_generateUnrelatedLabelsrlpointOfReference_generateDescriptionris r_generateAlertTextz"SpeechGenerator._generateAlertTexts+++C848?1D11#>>  GLDLL ) )*C DM [***37$7 GKDLL ) )*C D r!c d}|jdtj|}|tjj k(r' |j jjd}n& |j jjd}|rgStjjdrgStjjds|jdsgS|jdr%tjjd sgS|jd }tj|rgS||k(rgStj j"||fi|}|r(|j%|j&t(fd |i||S#t$rYwxYw#t$rY-wxYw) zReturns an array of strings fo use by speech and braille that represent the description of the object, if that description is different from that of the name and label. FrZry!usedDescriptionForUnrelatedLabelsr[speakDescriptionrz inMouseReviewpresentToolTipspriorObjrI)r\rr]rr^ALERTrlr}pop Exceptionr r`rar is_tool_tiprr8r~rcr;rd)rrIrJ alreadyUsedrZrrfs rr~z$SpeechGenerator._generateDescriptions  xx 1 1# 67 5::## # "ll;;??@YZ  "ll;;??@cd  I  & & ( 3 34L MI**,778JK88K(I 88O $#..0;; A     s$%F#-%F3# F0/F03 G?Gc 0tjjdrgStjjdsgStjj ||fi|}|r(|j |jtfd|i||S)z|Returns an array of strings for use by speech and braille that represent the description of the image on the object.r[rrI) r r`rarr8_generateImageDescriptionrcr;rdris rrz)SpeechGenerator._generateImageDescriptions  & & ( 3 34L MI**,778JKI$$>>tSQDQ  MM*$**V=== > r!c tjj||fi|}|r(|j|jt fd|i||S)zReturns an array of strings for use by speech and braille that represent the read only state of this object, but only if it is read only (i.e., it is a text area that cannot be edited). rI)rr8_generateReadOnlyrcr;rdris rrz!SpeechGenerator._generateReadOnly,sJ $$66tSIDI  MM*$**V=== > r!c xtjjds4tjjdtjk(rgSg}t j |r|jtj|r(|j|jtfd|i||SNr[speechVerbosityLevelrI) r r`rar VERBOSITY_LEVEL_BRIEFr has_popuprpr HAS_POPUPrcr;rdris r_generateHasPopupz!SpeechGenerator._generateHasPopup7s  & & ( 3 34L M))+667MN001I   % MM(,, -  MM*$**V=== > r!c Ntjjds4tjjdtjk(rgSt j j||fi|}|r(|j|jtfd|i||Sr) r r`rar rrr8_generateClickablercr;rdris rrz"SpeechGenerator._generateClickableDs  & & ( 3 34L M))+667MN001I$$77cJTJ  MM*$**V=== > r!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||SNr[rI) r r`rarr8_generateHasLongDescrcr;rdris rrz$SpeechGenerator._generateHasLongDescOse  & & ( 3 34L MI$$99$LtL  MM*$**V=== > r!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||Sr) r r`rarr8_generateHasDetailsrcr;rdris rrz#SpeechGenerator._generateHasDetailsXe  & & ( 3 34L MI$$88sKdK  MM*$**V=== > r!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||Sr) r r`rarr8_generateDetailsForrcr;rdris rrz#SpeechGenerator._generateDetailsForarr!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||Sr) r r`rarr8_generateAllDetailsrcr;rdris rrz#SpeechGenerator._generateAllDetailsjrr!c 4tjjdrgS|jdd}|dk7rgSg}|jj j |rj|jtjg|j|jtfd|i||j|j|fi||jtjg|j|jtfd|i||SNr[ startOffsetrrI)r r`rar\rlrm$isFirstItemInInlineContentSuggestionrcr ROLE_CONTENT_SUGGESTIONr;rd_generatePauser CONTENT_DELETION_STARTrrIrJrrfs r_generateDeletionStartz&SpeechGenerator._generateDeletionStartss  & & ( 3 34L MIhh}a0 ! I << ! ! F Fs K MM,DDE F MM*$**V=== > MM-$--c:T: ; x6678 jdjj9S9D9: r!c tjjdrgS|jd}|t j |}|r||k7rgSt jg}|j|jtfd|i||jjj|r|j|j|fi||jt jg|j|jtfd|i|t!j"||jjj$}|jjj'|rS|j|j|fi||j|j)||jd|SNr[ endOffsetrImode)r)r r`rar\rget_character_countr CONTENT_DELETION_ENDrcr;rdrlrm#isLastItemInInlineContentSuggestionrCONTENT_SUGGESTION_ENDr find_ancestor hasDetailsisContentSuggestionrrrIrJrlengthrf containers r_generateDeletionEndz$SpeechGenerator._generateDeletionEndsr  & & ( 3 34L MIHH[)  //4F&I- //0 jdjj9S9D9: << ! ! E Ec J MM-$--c:T: ; MM8::; < MM*$**V=== > ..sDLL4J4J4U4UVI||%%99)D 1d11#>>? d66ytxxPVGW6XY r!c 4tjjdrgS|jdd}|dk7rgSg}|jj j |rj|jtjg|j|jtfd|i||j|j|fi||jtjg|j|jtfd|i||Sr)r r`rar\rlrmrrcr rr;rdrr CONTENT_INSERTION_STARTrs r_generateInsertionStartz'SpeechGenerator._generateInsertionStarts  & & ( 3 34L MIhh}a0 ! I << ! ! F Fs K MM,DDE F MM*$**V=== > MM-$--c:T: ; x7789 jdjj9S9D9: r!c tjjdrgS|jd}|t j |}|r||k7rgSt jg}|j|jtfd|i||jjj|r|j|j|fi||jt jg|j|jtfd|i|t!j"||jjj$}|jjj'|rS|j|j|fi||j|j)||jd|Sr)r r`rar\rrr CONTENT_INSERTION_ENDrcr;rdrlrmrrrrrrrrrs r_generateInsertionEndz%SpeechGenerator._generateInsertionEndsr  & & ( 3 34L MIHH[)  //4F&I- 001 jdjj9S9D9: << ! ! E Ec J MM-$--c:T: ; MM8::; < MM*$**V=== > ..sDLL4J4J4U4UVI||%%99)D 1d11#>>? d66ytxxPVGW6XY r!c tjjdrgS|jdd}|dk7rgSg}|jj j |}|r[|j||j|jtfd|i||j|j|fi||jtj|j|jtfd|i||Sr)r r`rar\rlrmgetRoleDescriptionrprcr;rdrr CONTENT_MARK_START)rrIrJrrfroledescriptions r_generateMarkStartz"SpeechGenerator._generateMarkStarts  & & ( 3 34L MIhh}a0 ! I,,00CCCH  MM/ * MM*$**V=== > MM-$--c:T: ; h112 jdjj9S9D9: r!c $tjjdrgS|jd}|t j |}|r||k7rgSt jg}|j|jtfd|i||S)Nr[rrI) r r`rar\rrr CONTENT_MARK_ENDrcr;rd)rrIrJrrrfs r_generateMarkEndz SpeechGenerator._generateMarkEnds  & & ( 3 34L MIHH[)  //4F&I- ++, jdjj9S9D9: r!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||Sr) r r`rarr8_generateAvailabilityrcr;rdris rrz%SpeechGenerator._generateAvailabilityse  & & ( 3 34L MI$$::4MM  MM*$**V=== > r!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||Sr) r r`rarr8_generateInvalidrcr;rdris rrz SpeechGenerator._generateInvalidse  & & ( 3 34L MI$$55dCH4H  MM*$**V=== > r!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||Sr) r r`rarr8_generateRequiredrcr;rdris rrz!SpeechGenerator._generateRequiredse  & & ( 3 34L MI$$66tSIDI  MM*$**V=== > r!c `tjjdrgS|jdrgS|jj j |r>|jdtj|}|j\}}||vrgStjjdtjk(r|j|fi|Stjj||fi|}|r(|j!|j"t$fd|i||S)Nr[leavingrZrrI)r r`rar\rlrmisTextDocumentTablerr]"_getEnabledAndDisabledContextRolesr r_generateRoleNamerr8_generateTablercr;rd)rrIrJrZenableddisabledrfs rrzSpeechGenerator._generateTables  & & ( 3 34L MI 88I I << ! ! 5 5c :88FH$5$5c$:;D $ G G I GXx  & & ( 3 34J K,, -)4))#66 6$$33D#FF  MM*$**V=== > r!c tjjdrgSg}|jdt j |}|t jjk7r"|j|j|fi||S)asA convenience method to prevent the Atspi.Role.PARAGRAPH role from being spoken. In the case of a Atspi.Role.PARAGRAPH role, an empty array will be returned. In all other cases, the role name will be returned as an array of strings (and possibly voice and audio specifications). Note that a 'role' attribute in args will override the accessible role of the obj. [[[WDW - I wonder if this should be moved to _generateRoleName. Or, maybe make a 'do not speak roles' attribute of a speech generator that we can update and the user can override.]]] r[rZ) r r`rar\rr]rr^ PARAGRAPHrcr)rrIrJrfrZs r_generateTextRolez!SpeechGenerator._generateTextRolesw  & & ( 3 34L MIxx 1 1# 67 5::'' ' MM0$00== > r!c ^tjjdrgS|jjj |rgS|jjj |rgS|jjj|rgSg}|jdtj|}tjjtjjtjjtjj g}tj"|}|tjj$k(r&t'j(|r|j+|S|jjj-|rd|j/|j1|tjj2|j5|j6t8fd|i||S|tjj:k(rt'j<|rgSt'j>|r$|j/tj||jjjA|r)|j/tjjBtjjdtDjFk(rC|j5tjjHtjjJg|tjjLk(r|jjjO|}|r^|j/tPjR|j0|fi||dz|j5|j6t8fd|i|||vrL|sJ|j/|j0|fi||j5|j6t8fd|i||S)a5Returns the role name for the object in an array of strings (and possibly voice and audio specifications), with the exception that the Atspi.Role.UNKNOWN role will yield an empty array. Note that a 'role' attribute in args will override the accessible role of the obj. r[rZrZrIr)rZlevel)*r r`rarlrmisStatusBarNotification isDesktop isDockedFramer\rr]rr^UNKNOWNREDUNDANT_OBJECTFILLEREXTENDEDrqrkr is_combo_boxrisSingleLineAutocompleteEntryrpgetLocalizedRoleName AUTOCOMPLETErcr;rdPANEL is_selected is_list_boxisStatusBarDescendantLABELr rICONCANVASHEADING headingLevelr ROLE_HEADING_LEVEL_SPEECH)rrIrJrfrZ doNotPresentrurs rrz!SpeechGenerator._generateRoleName0s  & & ( 3 34L MI << ! ! 9 9# >I << ! ! + +C 0I << ! ! / / 4Ixx 1 1# 67 ** 33 )) ++- $$S) 5::?? "{'?'?'G))&1 1 << ! ! ? ? D MM$33Cejj>U>U3V W MM*$**V=== >M 5::## #&&s+I  " "6 *    1 1# 6 7 << ! ! 7 7 <    0 0 1  & & ( 3 34J K11 2   %**2C2C D E 5::%% %LL**77 r!c 8|j|fi|}|r|dSy)awReturns the role name for the object in an array of strings (and possibly voice and audio specifications), with the exception that the Atspi.Role.UNKNOWN role will yield an empty array. Note that a 'role' attribute in args will override the accessible role of the obj. This is provided mostly as a method for scripts to call. rrO)rrrIrJ generateds r getRoleNamezSpeechGenerator.getRoleNameps++D**37$7 Q< r!c 8|j|fi|}|r|dSy)NrrO)rbrs rgetNamezSpeechGenerator.getName~s)&D&&s3d3 Q< r!c |jjj|s%|jjj|rtj S|j dtj|}|tjjk(r%tj|rtjSt|@|fi|S)zReturns the localized name of the given Accessible object; the name is suitable to be spoken. Arguments: - obj: an Accessible object rZ)rlrmisEditableComboBoxisEditableDescendantOfComboBoxr ROLE_EDITABLE_COMBO_BOXr\rr]rr^LINKr is_visitedROLE_VISITED_LINKrUr)rrIrJrZrXs rrz$SpeechGenerator.getLocalizedRoleNames << ! ! 4 4S 9ll$$CCCH$<< <xx 1 1# 67 5::?? "{'='=c'B$66 6w+C8488r!c g}|jjj| }d}|jdt j |}|t jjk(s2|t jjk(rtj|sd}|jjj|||}|D]}}|j|fi|} | rUt| ddk(rD|jjj|rt!j"| d} | r| | d<|j%| |r(|j%|j&t(fd|i||S)zReturns, as an array of strings (and possibly voice specifications), all the labels which are underneath the obj's hierarchy and which are not in a label for or labelled by relation. rrZrrI)rlrmrr\rr]rr^rDIALOGris_message_dialogunrelatedLabelsrblenisMathr getCharacterNamercr;re) rrIrJrf visibleOnly minimumWordsrZlabelslabelrtcharnames rr|z(SpeechGenerator._generateUnrelatedLabelss@ ,,00HHMM  xx 1 1# 67 5::## # EJJ%% %k.K.KC.PL''77[,W E%4%%e4t4DDG )dll.D.D.K.KC.P&77Q@&DG MM$     MM*$**W>#>> ? r!c tjjdrgStjj ||fi|}|r(|j |jtfd|i||SaReturns an array of strings for use by speech and braille that represent the checked state of the object. This is typically for check boxes. [[[WDW - should we return an empty array if we can guarantee we know this thing is not checkable?]]] r[rI) r r`rarr8_generateCheckedStatercr;STATEris rrz%SpeechGenerator._generateCheckedStatesg  & & ( 3 34L MI$$::4MM  MM*$**U<>sC D"LL11(;MQ#::(+11#6 h33)6q)9*22,!889&88=;KK ||--;;C@'2237  !)! r!c |jjj|sgStj|}|sgSt j j|}tj|jjj}|sgSg}t j j|}|d|dk(rK|d|dk(r |jtjn|jtjn|djd}|djd} t!|dkDrDt!| dkDr6|d| dk(r+|d| dk(r |jtjn|jtj"|r(|j%|j&t(fd|i||S)Nrr#.r%rI)rlrminDocumentContentrr'r)r*r+rget_uri documentFramerpr LINK_SAME_PAGELINK_SAME_SITEr,rLINK_DIFFERENT_SITErcr;rd) rrIrJr3r4doc_urirf doc_uri_info linkdomain docdomains r_generateSiteDescriptionz(SpeechGenerator._generateSiteDescriptionYs||%%77<I++C0I --h7 $$T\\%;%;%I%I%KLI||,,W5  |A .Q<?2 h556 h556&q)//4J$Q--c2I:"s9~'9b>Yr]2b>Yr]2 h556 h::;  MM*$**V=== > r!c g}d}tj|}|s|S tjj |} |j d}|rt|}|dkr%|jtj|ng|dkr/|jtjt!|dzzn3|dk\r.|jtj"t!|dzz|r(|j%|j&t(fd|i||S#t $rYwxYw#ttjjtf$rYwxYw)zReturns an array of strings (and possibly voice and audio specifications) that represent the size (Content-length) of the file pointed to by the URI of the link associated with obj. rOzContent-lengthi'i@BgMbP?gư>rI)rr'r)requesturlopeninfoKeyError ValueErrorerrorURLErrorOSErrorintrpr fileSizeBytes FILE_SIZE_KBfloat FILE_SIZE_MBrcr;rd)rrIrJrf sizeStringr&rBsizes r_generateFileSizez!SpeechGenerator._generateFileSize|s.  &&s+M &&s+A VVX&67 z?De| h44T:; h33uT{T7IJK h33uT{W7LMN  MM*$**V=== >   FLL117;   s.D+D D(%D+'D((D++(EEc tj|sgStjj|d<|j |fi|S)zReturns an array of strings (and possibly voice and audio specifications) that represent the image on the object, if it exists. Otherwise, an empty array is returned. rZ)rsupports_imagerr^IMAGErDrrIrJs r_generateImagezSpeechGenerator._generateImages@ &&s+Izz''V t}}S)D))r!c |jjrgSt| |fi|}|r(|j |j t fd|i||SNrI)rlinSayAllrU_generateColumnHeaderrcr;rers rrbz%SpeechGenerator._generateColumnHeadersU << "I.s;d;  MM*$**W>#>> ? r!c |jjrgSt| |fi|}|r(|j |j t fd|i||Sr`)rlrarU_generateRowHeaderrcr;rers rrdz"SpeechGenerator._generateRowHeadersU << "I+C848  MM*$**W>#>> ? r!c |t||fi|}|r(|j|jtfd|i||Sr`)rU_generateSortOrderrcr;rdrs rrfz"SpeechGenerator._generateSortOrders@+C848  MM*$**V=== > r!c |jjj||jdsgS|jdrgSt j j dsgSd|d<|j|fi|S)aReturns an array of strings (and possibly voice and audio specifications) that represent the row header for an object that is in a table, if it exists and if it is different from the previous row header. Otherwise, an empty array is returned. The previous row header is determined by looking at the row header for the 'priorObj' attribute of the args dictionary. The 'priorObj' is typically set by Orca to be the previous object with focus. r readingRowspeakCellHeadersTnewOnly)rlrmcellRowChangedr\r r`rardr]s r_generateNewRowHeaderz%SpeechGenerator._generateNewRowHeaders{||%%44S$((::NOI 88L !I**,778JKIY&t&&s3d33r!c |jjj||jdsgS|jdrgSt j j dsgSd|d<|j|fi|S)aReturns an array of strings (and possibly voice and audio specifications) that represent the column header for an object that is in a table, if it exists and if it is different from the previous column header. Otherwise, an empty array is returned. The previous column header is determined by looking at the column header for the 'priorObj' attribute of the args dictionary. The 'priorObj' is typically set by Orca to be the previous object with focus. rrhriTrj)rlrmcellColumnChangedr\r r`rarbr]s r_generateNewColumnHeaderz(SpeechGenerator._generateNewColumnHeaders{||%%77TXXj=QRI 88L !I**,778JKIY)t))#666r!c g}|jd|}|j|j|fi||j|||r|dst j j dro|jdds]|jddk7rI|jtj|r(|j|jtfd|i||S) ahOrca has a feature to automatically read an entire row of a table as the user arrows up/down the roles. This leads to complexity in the code. This method is used to return an array of strings (and possibly voice and audio specifications) for a single table cell itself. The string, 'blank', is added for empty cells. REAL_ROLE_TABLE_CELLrspeakBlankLinesrhF formatTypeancestorrI) _overrideRolercrD _restoreRoler r`rar\rpr BLANKr;re)rrIrJrfoldRoles r_generateRealTableCellz&SpeechGenerator._generateRealTableCells$$%;TB mdmmC0401 '4(6!9**,778IJ88L%0xx %3 MM(.. ) jdjjBcBTBC r!c rtjjdrgS|jdrgS|sgSt j t j |sgStj|rgStjg}|j|jtfd|i||S)Nr[rrI)r r`rar\rsupports_selectionrqrrr STATE_UNSELECTED_LIST_ITEMrcr;rris r$_generateUnselectedStateIfSelectablez4SpeechGenerator._generateUnselectedStateIfSelectables  & & ( 3 34L MI 88O $II**8+>+>s+CDI  " "3 'I#>>? jdjj8C8489 r!c tjjdrgS|jdrgS|sgSt j |}t j |sgStj|rgStj|rgStj|}|rT|jjj\}}|dvrgS|jjj|rBgStj |r)||jjj#|vrgSgSt$j&g}|j)|j*t,fd|i||S)ajReturns an array of strings (and possibly voice and audio specifications) if this is an icon within an layered pane or a table cell within a table or a tree table and the item is focused but not selected. Otherwise, an empty array is returned. [[[WDW - I wonder if this string should be moved to settings.py.]]] r[r)LeftRightrI)r r`rar\rrqr{rris_textr get_tablerlrmlastKeyAndModifiers isLayoutOnlyis_layered_paneselectedChildrenr STATE_UNSELECTED_TABLE_CELLrcr;r)rrIrJrutablelastKeymodsrfs r_generateUnselectedCellz'SpeechGenerator._generateUnselectedCell&sF  & & ( 3 34L MI 88O $II$$S)**62I  " "3 'I   s #I!!#&  LL22FFHMGT++ ||%%2259  ( ( 0dll,,==fEE I#??@ jdjj8C8489 r!c |jjj|sgS|jdrgSt j j dsgS|j|fi|SNrhspeakCellCoordinates)rlrmrnr\r r`ra_generateColumnr]s r_generateNewColumnz"SpeechGenerator._generateNewColumnSse||%%77<I 88L !I**,778NOI#t##C0400r!c tjjdrgStj|dd}|dk(rgSt j |dzzg}|j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) reflecting the column number of a cell. r[T find_cellrr%rI) r r`rarget_cell_coordinatesr TABLE_COLUMNrcr;rd)rrIrJcolrfs rrzSpeechGenerator._generateColumn_s  & & ( 3 34L MI**3$?B "9I''3734 jdjj9S9D9: r!c |jjj|sgS|jdrgSt j j dsgS|j|fi|Sr)rlrmrkr\r r`ra _generateRowr]s r_generateNewRowzSpeechGenerator._generateNewRownse||%%44S9I 88L !I**,778NOI t  ---r!c tjjdrgStj|dd}|dk(rgSt j |dzzg}|j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) reflecting the row number of a cell. r[Trrr%rrI) r r`rarrr TABLE_ROWrcr;rd)rrIrJrowrfs rrzSpeechGenerator._generateRowzs  & & ( 3 34L MI**3$?B "9I$$a01 jdjj9S9D9: r!c tjjdrgStj|d\}}|dk(s|dk(rgStj |}|gSg}tj |}tj|}|jtj|dz|dz|jtj|dz|dz|j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) reflecting the position of the cell in terms of its column number, the total number of columns, its row, and the total number of rows. r[Trr%rindextotalrI)r r`rarrr get_row_countget_column_countrpr TABLE_COLUMN_DETAILEDTABLE_ROW_DETAILEDrcr;rd) rrIrJrrrrfrowscolumnss r_generateColumnAndRowz%SpeechGenerator._generateColumnAndRows  & & ( 3 34L MI//tDS "9r I!!#& =I$$U+**51 h4437W^7__` h11aTX4YYZ jdjj9S9D9: r!c \tjjdrgStjjdtjk7rgSt j |r;tjg}|j|jtfd|i||SgS)zReturns an array of strings (and possibly voice and audio specifications) indicating that this cell is the last cell in the table. r[rrI) r r`rar VERBOSITY_LEVEL_VERBOSEr is_last_cellr TABLE_ENDrcr;rdris r_generateEndOfTableIndicatorz,SpeechGenerator._generateEndOfTableIndicators  & & ( 3 34L MI  & & ( 3 34J K.. /I    $(()F MM*$**V=== >M r!c |jdrtj|rgS|j|fi|}|r|dr|S|jj |\}}}|dk(rt jjdrz|jjs`|jdddk(rK|jddk7r7tjg}|j|jd||d ||Sg}|t|z}|jjj!|||}|D]\} } } } } | j#|jj$d } | s3| | c|d <|d <d |vrNd|jd d| d}t'j(t&j*|d|j-d |jd| |d |}|jjj/|| | } |jjj1| g}|j||j||S)zReturns an array of strings for use by speech and braille that represents the current line of text, if this is a text object. [[[WDW - consider returning an empty array if this is not a text object.]]] rr rrrrrsrt)stringrIrOlanguagedialectrzINFO: Found existing string 'z '; using ''Tr)r\r is_editable_generateSubstringrlgetTextLineAtCaretr r`rarar rwrcr;rrmsplitSubstringByLanguagereplaceEMBEDDED_OBJECT_CHARACTERr printMessagerHradjustForLinksadjustForRepeats)rrIrJrfr7 caretOffsetrrr,startendrrrmsgr;rKs r_generateCurrentLineTextz(SpeechGenerator._generateCurrentLineTexts+ 88O $&&s+I(((55 fQiM+/<<+J+J3+O({K 4<,779DDEVW<<((*txx/Cq/Hxx %3nn%F MM*$**BDcBTB CM#d)+  &&??[R[\5:  1E3'^^DLL$J$JBOF08' -D d9o45dhhx6H5ITZS[[\]""5#3#3S$?"DJJ>f#>>E\\++::3NF,,((99&ABB IIe  MM" ' * r!c |j|fi|}|r|dr|Stjj||fi|}|r|dsgS|dj }t |dk(rD|j jj|rtj|}||k7r||d<|j|jtfd|i||S)NrrrI)rrr8_generateDisplayedTextstriprrlrmrr rrcr;re)rrIrJrfrr s rrz&SpeechGenerator._generateDisplayedTexts(((55 fQiM$$;;D#NN6!9I" v;!  6 6 = =c B"33F;H6!$q  jdjj:c:T:; r!cx |jjdS#t$rYnwxYw|jjj |\}}}|dk7}|sbt j |\}}}|r(|jjj|}|}nt j|d}|dk(r|}|jjj|r%|jjj|}||||g|jjd<|jjdS)aReturns [textContents, startOffset, endOffset, selected] as follows: A. if no text on the current line is selected, the current line B. if text is selected, the selected text C. if the current line is blank/empty, 'blank' Also sets up a 'textInformation' attribute in self._script.generatorCache to prevent computing this information repeatedly while processing a single event. textInformationrOrr) rlgeneratorCacherrmallSelectedTextrget_line_at_offsetrget_character_at_offsetshouldVerbalizeAllPunctuationverbalizeAllPunctuation)rrI textContentsrrselectedlinechars r_getTextInformationz#SpeechGenerator._getTextInformations' <<../@A A   04||/E/E/U/UVY/Z, k92%+1+D+DS+I (D+y||-->>tD# 55c:1=4<#'L << ! ! ? ? D<<11II,WL; 8 < ##$56||**+<==s  ''c |j|fi|}|r|S|j|d}|sgS|g}|j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) containing the text content. This requires _generateTextInformation to have been called prior to this method. rrI)rrrcr;re)rrIrJrfrs r_generateTextContentz$SpeechGenerator._generateTextContent&sm )((55 M'',Q/I jdjj:c:T:; r!)styleweight underlinec&tj||\}}}|syd}|D]}|j|} | stj||j } tj| |j } |dk(r&t | dkDsk|dtjz }|dk(r| dk7s|d| z }|dk(r| dk7s|d| z }|dz }|| dz| zz }tj|||d zr|dtjz }|||fS) NrOrirPrnonernormalr) rget_text_attributes_at_offsetr\rgetTextAttributeNamerlrRr BOLDrget_all_links_in_ranger) rrIoffsetkeysattrsrrrfkey attribute localizedKeylocalizedValues r_getAttributesStringAndOffsetsz.SpeechGenerator._getAttributesStringAndOffsets8s:"@@fMuc @C #I/DDS$,,WL1FFyRVR^R^_Nhy>C'(--11F #&,00F(.!122F# <#->?% @(  - -c66A: F (--) )Fuc!!r!c X|j|\}}}}d}|}||kr>|j||\} } } |d| dtj|| | z }| }||kr>|j||dgd} | r|d| z }|g} | j |j t fd|i|| S)a;Returns an array of strings (and possibly voice and audio specifications) containing the text content, obtained from the 'textInformation' value, with character attribute information mixed in. This requires _generateTextInformation to have been called prior to this method. rOrPzparagraph-stylerrI)rrr get_substringrcr;re) rrIrJrrrrnewLine textOffsetattribsrrrfs r"_generateTextContentWithAttributesz2SpeechGenerator._generateTextContentWithAttributesWs483K3KC3P0{Ix 9$"&"E"Ec:"V GUC 7)1V%9%9#uc%J$KL LGJ9$ 55c;IZH[\]^_  7)} $G jdjj:c:T:; r!c tjjdrgStj|sgSt j g}|j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) that says if any of the text for the entire object is selected. [[[WDW - I wonder if this string should be moved to settings.py.]]] r[rI) r r`rarhas_selected_textr TEXT_SELECTEDrcr;rdris r_generateAnyTextSelectionz)SpeechGenerator._generateAnyTextSelectionosh  & & ( 3 34L MI'',I(() jdjj9S9D9: r!c tjjdrgStj|sgSt j g}|j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) that says if all the text for the entire object is selected. [[[WDW - I wonder if this string should be moved to settings.py.]]] r[rI) r r`raris_all_text_selectedr rrcr;rdris r_generateAllTextSelectionz)SpeechGenerator._generateAllTextSelectionsh  & & ( 3 34L MI**3/I(() jdjj9S9D9: r!c *t||fi|}|r|dsgS|j|jtfd|i||ddvryt j jdrV|jjs<|jdddk(r'|jddk7rtj|d<|jjj|r+|jjj|d|d<|S) NrrI)rrOrrrrrsrt)rUrrcr;rer r`rarlrar\r rwrmrrrs rrz"SpeechGenerator._generateSubstrings+C8486!9I jdjj:c:T:; !9 "'7'B'B'D'O'OPa'b<<((*txx/Cq/Hxx %3 F1I << ! ! ? ? D ..FFvayQF1I r!c 6tjjdsgS|jj |\}}}|jj j |}|sgS|g}|j|jtfd|i||S)zSpeaks a summary of the number of spaces and/or tabs at the beginning of the given line. Arguments: - obj: the text object. enableSpeechIndentationrI) r r`rarlrrmindentationDescriptionrcr;rd)rrIrJrrr descriptionrfs r_generateTextIndentationz(SpeechGenerator._generateTextIndentations **,778QRI)-)H)H)M&k;ll,,CCDI I jdjj9S9D9: r!c |t||fi|}|r(|j|jtfd|i||Sr`)rU_generateNestingLevelrcr;rdrs rrz%SpeechGenerator._generateNestingLevels@.s;d;  MM*$**V=== > r!c tjjdrgSg}|jjj |j dd}|jjj |}||k7rO|dk\rJ|j|j|fi||j|jtfd|i||S)aReturns an array of strings (and possibly voice and audio specifications) that represents the tree node level of the object, or an empty array if the object is not a tree node or if the node level is not different from the 'priorObj' 'priorObj' attribute of the args dictionary. The 'priorObj' is typically set by Orca to be the previous object with focus. r[rNrrI) r r`rarlrm nodeLevelr\rc_generateNodeLevelr;rd)rrIrJrfoldLevelnewLevels r_generateNewNodeLevelz%SpeechGenerator._generateNewNodeLevels  & & ( 3 34L MI<<))33DHHZ4NO<<))33C8  x1} MM1$11#>> ? MM*$**V=== > r!c |t||fi|}|r(|j|jtfd|i||Sr`)rU_generateValuercr;rers rrzSpeechGenerator._generateValues@'4t4  MM*$**W>#>> ? r!c tjjdrgStj|}|@t j |g}|j|jtfd|i||SgS)aReturns an array of strings (and possibly voice and audio specifications) that represents the percentage value of the object. This is typically for progress bars. [[[WDW - we should consider returning an empty array if there is no value. r[rI) r r`rarget_value_as_percentr percentagercr;rd)rrIrJ percentValuerfs r_generatePercentagez#SpeechGenerator._generatePercentagesu  & & ( 3 34L MI33C8  #)),78F MM*$**V=== >M r!c htj|sgSt| |fi|}|sgS|j |j t fd|i||jdd}tj|s|Stj|tjj}||vr|SgS)aReturns an array of strings (and possibly voice and audio specifications) that represents the radio button group label of the object, or an empty array if the object has no such label or if the radio button group is not different from the 'priorObj' 'priorObj' attribute of the args dictionary. The 'priorObj' is typically set by Orca to be the previous object with focus. rIrN) ris_radio_buttonrU_generateRadioButtonGrouprcr;rer\rget_relation_targetsr RelationType MEMBER_OF)rrIrJrfrmembersrXs r_generateNewRadioButtonGroupz,SpeechGenerator._generateNewRadioButtonGroups**3/I23?$?I jdjj:c:T:;88J-**84M//U5G5G5Q5QR 7 "M r!c |jjj|}|dvrgStj|g}|j |j tfd|i||S)N)r%rrI)rlrmgetValueCountForTermr valueCountForTermrcr;rd)rrIrJcountrfs r_generateTermValueCountz'SpeechGenerator._generateTermValueCountsb &&;;C@ G I,,U34 jdjj9S9D9: r!c xtjjds4tjjdtjk(rgSg}|j j j|}t|}|rN|jtj||j|jtfd|i||S|jdt!j"|}|t$j&j(t$j&j*fvr~t!j,|t.j0Dcgc]}|}}t|}|sgStj2|g}|j|jtfd|i||Scc}w)a5Returns an array of strings (and possibly voice and audio specifications) that represents the number of children the object has. [[[WDW - can we always return an empty array if this doesn't apply?]]] [[[WDW - I wonder if this string should be moved to settings.py.]]] r[rrIrZ)r r`rar rrlrm childNodesrrpr itemCountrcr;rdr\rr]rr^LISTLIST_BOX iter_childrenr is_list_item listItemCount) rrIrJrfrchildrenrZrBsetsizes r_generateNumberOfChildrenz)SpeechGenerator._generateNumberOfChildren s_  & & ( 3 34L M))+667MN001I\\++66s; z?  MM(,,X6 7 MM*$**V=== >Mxx 1 1# 67 EJJOOUZZ%8%89 9#+#9#9#{?W?W#XYaYHY(mG ,,W56F MM*$**V=== > Zs F7c NtjjdrgSg}tdt j |t jD}|sG|jtj|j|jtfd|i||S)ahReturns an array of strings (and possibly voice and audio specifications) that says if this object has no showing children (e.g., it's an empty table or list). object has. [[[WDW - can we always return an empty array if this doesn't apply?]]] [[[WDW - I wonder if this string should be moved to settings.py.]]] r[c3 K|]}dyw)TNr).0_s r z=SpeechGenerator._generateNoShowingChildren..MsYtYs rI)r r`raanyrrr is_showingrpr ZERO_ITEMSrcr;rd)rrIrJrfhasItemss r_generateNoShowingChildrenz*SpeechGenerator._generateNoShowingChildrenAs  & & ( 3 34L MIYX%;%;CAWAW%XYY MM(-- . MM*$**V=== > r!c tjjdrgSg}tj|sG|j t j|j|jtfd|i||S)ahReturns an array of strings (and possibly voice and audio specifications) that says if this object has no children at all (e.g., it's an empty table or list). object has. [[[WDW - can we always return an empty array if this doesn't apply?]]] [[[WDW - I wonder if this string should be moved to settings.py.]]] r[rI) r r`rarget_child_countrpr r&rcr;rdris r_generateNoChildrenz#SpeechGenerator._generateNoChildrenSsl  & & ( 3 34L MI'', MM(-- . MM*$**V=== > r!c g}|jdtj|}|tjj tjj fvr|Stj|r&|jjj|}ntj|g}|r|ds|St|j|D]}|j||S)NrZr)r\rr]rr^rrr{rlrmrrget_focused_objectmaprbrc)rrIrJrfrZitemsitems r_generateFocusedItemz$SpeechGenerator._generateFocusedItemdsxx 1 1# 67  )<)<= =M  & &s +LL**;;C@E 33C89E%(M**E2 D MM$   r!c tjjdrgS|}tj|s,tj |}tj|sgSg}tj |}t|jjj|}|jtj|||j|jt fd|i||j|jj"j%ddtj&|dz|dz|j|jt fd|i||S)zReturns an array of strings (and possibly voice and audio specifications) indicating how many items are selected in this and the position of the current item. This object will be an icon panel or a layered pane. r[rIr iconindexr stringTyperr)r r`rarr{rqr*rrlrmrrpr selectedItemsCountrcr;rd formatting getStringget_index_in_parent)rrIrJrrf childCount selectedCounts r_generateSelectedItemCountz*SpeechGenerator._generateSelectedItemCountvs=  & & ( 3 34L MI **95 ++C0I..y9 --i8 DLL22CCINO  h11-LM jdjj9S9D9: dll--77'%082$,#?#?#Dq#H#-// 0  jdjj9S9D9: r!c ZtjjdrgS|}tj|s,tj |}tj|sgS|j jj|}tt|j|S)zReturns an array of strings (and possibly voice and audio specifications) containing the names of all the selected items. This object will be an icon panel or a layered pane. r[) r r`rarr{rqrlrmrrEr._generateLabelAndName)rrIrJr selectedItemss r_generateSelectedItemsz&SpeechGenerator._generateSelectedItemss  & & ( 3 34L MI **95 ++C0I..y9  ..?? J C22MBCCr!c (|j|fi|Sr)r@r]s rgenerateSelectedItemsz%SpeechGenerator.generateSelectedItemss*t**37$77r!c dtjjdrgSg} |jjj |}|dkDrL|jtj||j|jtfd|i||S#t $rd}Y`wxYw)aReturns an array of strings (and possibly voice and audio specifications) that says how many unfocused alerts and dialogs are associated with the application for this object. [[[WDW - I wonder if this string should be moved to settings.py.]]] r[rrI) r r`rarlrmunfocusedAlertAndDialogCountrrpr dialogCountSpeechrcr;rd)rrIrJrfalertAndDialogCounts r_generateUnfocusedDialogCountz-SpeechGenerator._generateUnfocusedDialogCounts  & & ( 3 34L MI  $ &&CCCH   " MM(445HI J MM*$**V=== >  $"#  $s%B!! B/.B/c tjjddddddtjjdtjjtjj tjj tjjdtjjtjjg}gg}}|jjr&tjjd r)|jtjjtjjd r+|j!tjj dgtjjd rc|jtjj |jtjj|jdtjjd rH|j!tjjtjjdddddgtjjd r)|jtjjtjjdrO|jtjjn$tjjdr)|jtjjtjjdr,|j!tjj ddgtjjdrc|jtjj |jtjj|jdtjjdrH|j!tjjtjjdddddgtjjdr)|jtjjtjjdr)|jtjjt#t%|j'|}||fS)NROLE_CONTENT_DELETIONROLE_CONTENT_INSERTIONROLE_CONTENT_MARKrROLE_DPUB_LANDMARKROLE_DPUB_SECTION ROLE_FEED ROLE_REGIONsayAllContextBlockquotesayAllContextLandmarksayAllContextListsayAllContextPanelsayAllContextNonLandmarkFormsayAllContextTablespeakContextBlockquotespeakContextLandmarkspeakContextListspeakContextPanelspeakContextNonLandmarkFormspeakContextTable)rr^ BLOCK_QUOTEDESCRIPTION_LISTFORMLANDMARKrrTABLETOOL_TIPrlrar r`rarprcrEsetsymmetric_difference)rallRolesrrs rrz2SpeechGenerator._getEnabledAndDisabledContextRolessJJ**+,'-('JJ//JJOOJJ''JJOOJJ$$!JJ$$JJ'')" << "**,778QRuzz556**,778OP 3 35IJK**,778KLuzz/uzz::;{+**,778LM 0 0 % 3 3 7 8 3 9 3  56 **,778VWuzz/**,778LMuzz//0**,778PQuzz556**,778NO 3 35I=YZ**,778JKuzz/uzz::;{+**,778KL 0 0 % 3 3 7 8 3 9 3  56 **,778UVuzz/**,778KLuzz//0H ::7CD  r!c |jdsgS|jdtj|}|j\}}||vs'|jj j |sgS|jdd}g}|jj j |r!|jtj nH|tjjk(rL|dkDr&|jtj| n|jtj n|tjjtjj fvrq|jj j#|rL|dkDr&|jtj$| nY|jtj& n8|dk(r!|jtj( n|tjj*k(r|jj j-|r!|jtj. n|jj j1|r!|jtj2 nidg} nd|tjj4k(rF|jj j7|r!|jtj8 n|dk(r3|jj j;|r!|jtj< n|jj j?|r!|jtj@ no|jj jC|r!|jtjD n)|jj jG|r!|jtjH n|jj jK|r!|jtjL n|jj jO|r!|jtjP nW|jj jS|r!|jtjT n|jj jW|r!|jtjXn|jj j[|r!|jtj\n|jj j_|r!|jtj`n?|jj jc|r!|jtjdn|jj jg|r!|jtjhn|jj jk|r!|jtjlnm|jj jo|r!|jtjpn'|jj js|r!|jtjtn|jj jw|r!|jtjxn|jj j{|r!|jtj|nU|jj j|r!|jtjn|jj j|r|jtjn|dk(r1|jj j|r!|jtjn||jj j|r!|jtjn6|jj j|r!|jtjn|jj j|r!|jtjn|jj j|r!|jtjnd|jj j|r!|jtjn|jj j|r!|jtjn|jj j|r|jtjn|jj j|r5|jj j|r!|jtjn%|jj j|r!|jtjn|jj j|r!|jtjn|jj j|r!|jtjnS|jj j|r!|jtjn |jj j|r!|jtjn|jj j|r!|jtjn|jj j|r!|jtjn;dg}n6|tjjk(r |jtjn|tjjk(r |jtjn|d k(r |jtjn|d k(r |jtjnr|d k(r |jtjnM|d k(rE|jj j|s |jtjndg}|r(|j|jtfd |i||S)NrrZrrrNrOrLrMrIrJrKrrI)or\rr]rrlrm isDetailsrpr LEAVING_DETAILSrr^r\leavingNBlockquotesLEAVING_BLOCKQUOTErr]isDocumentList leavingNLists LEAVING_LIST LEAVING_FEEDrisFigureLEAVING_FIGUREisDocumentPanel LEAVING_PANELr`r LEAVING_TABLEisDPubAcknowledgmentsLEAVING_ACKNOWLEDGMENTSisDPubAfterwordLEAVING_AFTERWORDisDPubAppendixLEAVING_APPENDIXisDPubBibliographyLEAVING_BIBLIOGRAPHY isDPubChapterLEAVING_CHAPTERisDPubConclusionLEAVING_CONCLUSION isDPubCreditsLEAVING_CREDITSisDPubEndnotesLEAVING_ENDNOTESisDPubEpilogueLEAVING_EPILOGUE isDPubErrataLEAVING_ERRATAisDPubForewordLEAVING_FOREWORDisDPubGlossaryLEAVING_GLOSSARY isDPubIndex LEAVING_INDEXisDPubIntroductionLEAVING_INTRODUCTIONisDPubPagelistLEAVING_PAGELIST isDPubPart LEAVING_PART isDPubPrefaceLEAVING_PREFACEisDPubPrologueLEAVING_PROLOGUE isDPubToc LEAVING_TOCisDPubAbstractLEAVING_ABSTRACTisDPubColophonLEAVING_COLOPHON isDPubCreditLEAVING_CREDITisDPubDedicationLEAVING_DEDICATIONisDPubEpigraphLEAVING_EPIGRAPH isDPubExampleLEAVING_EXAMPLEisDPubPullquoteLEAVING_PULLQUOTE isDPubQna LEAVING_QNA isLandmarkisLandmarkBannerLEAVING_LANDMARK_BANNERisLandmarkComplementaryLEAVING_LANDMARK_COMPLEMENTARYisLandmarkContentInfoLEAVING_LANDMARK_CONTENTINFOisLandmarkMainLEAVING_LANDMARK_MAINisLandmarkNavigationLEAVING_LANDMARK_NAVIGATIONisLandmarkRegionLEAVING_LANDMARK_REGIONisLandmarkSearchLEAVING_LANDMARK_SEARCHisLandmarkForm LEAVING_FORMr^raLEAVING_TOOL_TIPrrrisInlineSuggestionLEAVING_SUGGESTIONrcr;rd)rrIrJrZrrrrfs r_generateLeavingz SpeechGenerator._generateLeavingsxx "Ixx 1 1# 67 CCE4<<#9#9#C#CC#HI!$ << ! ! + +C 0 MM(22 3 UZZ++ +qy h::5AB h99: ejjoouzz'B'BC C &&55c:qy h44U;< h334 [ MM(// 0 UZZ%% %||%%..s3 h556''77< h445 UZZ%% %$,,*@*@*T*TUX*Y MM(00 1 ) )||%%;;C@ h>>?''77< h889''66s; h778''::3? h;;<''55c: h667''88= h99:''55c: h667''66s; h778''66s; h778''44S9 h556''66s; h778''66s; h778''33C8 h445''::3? h;;<''66s; h778''2237 h334''55c: h667''66s; h778''11#6 h223 ( (||%%44S9 h778''66s; h778''44S9 h556''88= h99:''66s; h778''55c: h667''77< h889''11#6 h223 \\ # # . .s 3||%%66s; h>>?''??D hEEF''==cB hCCD''66s; h<<=''<>?''88= h>>?''66s; h334 UZZ__ $ MM(// 0 UZZ(( ( MM(33 4 , , MM(77 8 - - MM(88 9 ( ( MM(33 4 . .\\++>>sC MM(55 6TF  MM*$**V=== > r!c < g}|jd}|r%|jdr|}|jd}n|jd}|rtj|rgStj|rgS|r-tj |tj |k(rgSj jj|rgStj|rgStj|rgSj jj||}||k(rgS|jdg}|jdg}|jtjjj\} } |j!| |jdg} | j!tjj"tjj$g|jdg} | j!tjj&gtjj(tjj*g} d}|r|sj-|| vrfd}tj.||}tj.||}j jj1|}j jj1|}||k7}gg}}tj2|}|rމj-|}|| vrn||vr&j jj5|sn||r||vrnuj jj7|rnOj jj9|rn)||k7s|r"|j||j|||k(s|| vrntj2|}|rg}t;|D]\}}||}|| vr||vr|j||j=|}j?|||jjA|d ||||| jC|||s|jE|S) aEReturns an array of strings (and possibly voice and audio specifications) that represent the text of the ancestors for the object. This is typically used to present the context for an object (e.g., the names of the window, the panels, etc., that the object is contained in). If the 'priorObj' attribute of the args dictionary is set, only the differences in ancestry between the 'priorObj' and the current obj will be computed. The 'priorObj' is typically set by Orca to be the previous object with focus. rr includeOnly skipRoles stopAtRolesstopAfterRolesFc,j|k(Sr)_getAlternativeRole)rB commonRolers rpredz0SpeechGenerator._generateAncestors..preds33A6*DDr!rt)rsrZrr ancestorOfr)#r\ris_deadrrrqrlrm isTypeahead is_page_tabcommonAncestorrprr^ TREE_ITEMrrc APPLICATIONMENU_BARrar\rrr nestingLevelget_parent_checkedisSpreadSheetTablerisButtonWithPopup enumeraterrurDrvreverse)rrIrJrfrrrrrrrrr presentOncepresentCommonAncestorr objAncestor priorAncestorobjLevel priorLevel ancestors ancestorRolesru parentRolepresentedRolesirBaltRolerrs` @r_generateAncestorsz"SpeechGenerator._generateAncestorss((9% txx +hHHZ(c*-h ((2I  " "8 ,I ++H59L9LS9QQI << ! ! - -h 7I  " "3 'I  " "3 'I//>>xM . Ihh}b1 HH["- --. CCE"hh}b1 EJJ22EJJ4G4GHI"2B7uzz2234zz--uzz? % '11.AJ[(E&44S$? ( 6 6x F <<11>>{K!\\33@@O (0J(>%#%r= ,,S111&9J[(Y&t||/E/E/X/XY_/`;!>''44V<''99&A>)-B  ($$Z0':+G008F+.i( -DAq#A&G+%'^*C  ! !' *!''0E   w - MM aJW&-UsU]_ `   gt , - NN  r!c JtjjdrgS|jjj rgS|j dr|k(stjsgStj|rgStj|tjk7stj|fdrgS|jjj|\}}|rgSd|d<tjj tjj"tjj$tjj&dddd d d d tjj(tjj*d tjj,tjj.g|d<g}|jjj1rY|j3}|j5|||j7|j9|dd|j;|||j7|j<|fi||j?d|j?d|S)zReturns an array of strings (and possibly voice and audio specifications) that represent the text of the ancestors for the object being left.r[rc|k(Srr)rBrs rrCz7SpeechGenerator._generateOldAncestors..s AMr!TrrIrJrKrrLrMrNrOrfocused)rZrsr) r r`rarlrminFindContainerr\ris_validrrget_applicationrframeAndDialogrr^r\r]r^r_rrr`ra isBlockquoterrurcrDrvrr)rrIrJframedialogrfrxrs @r_generateOldAncestorsz%SpeechGenerator._generateOldAncestorss  & & ( 3 34L MI << ! ! 1 1 3I88J'3(?(2C2CH2MI  " "3 'I  # #C (H,D,DX,N N$$S*ABI ..==cB v IY$zz55$zz::$zz$zz22672832*$zz$zz//,$zz//$zz224]" << ! ! . .x 8..x8G   w - MM$--w9d(L M   gt , -d--c:T:;   r!c tjjdrgS|jjj rgS|j d}||k(rgS|j dtj|}|tjjtjjfvrgS|tjjk(r|rtj|rgS||j |fi|S|jjj#|\}}|xs|}tj$|r|j |fi|SgS)awReturns an array of strings (and possibly voice and audio specifications) that represent the text of the ancestors for the object. This is typically used to present the context for an object (e.g., the names of the window, the panels, etc., that the object is contained in). If the 'priorObj' attribute of the args dictionary is set, only the differences in ancestry between the 'priorObj' and the current obj will be computed. Otherwise, no ancestry will be computed. The 'priorObj' is typically set by Orca to be the previous object with focus. r[rrZ)r r`rarlrmrr\rr]rr^FRAMEWINDOW MENU_ITEMr is_windowrris_dialog_or_alert)rrIrJrrZrrtopLevels r_generateNewAncestorsz%SpeechGenerator._generateNewAncestors/s.  & & ( 3 34L MI << ! ! 1 1 3I88J' s?Ixx 1 1# 67 EJJ$$ejj&7&78 8I 5::'' '[=R=RS[=\I  *4**37$7 7 ..==cB v?U  ) )( 3*4**37$7 7 r!c |jd|k(rgS|j|fi|}|j|j|fi||S)Nr)r\rrprris rgenerateContextzSpeechGenerator.generateContextWsS 88J 3 &I+++C848 0d00==> r!c |jdtj|tjj k(r%|jdddvrt jgStj|}tj|stj|r|}|jtj|S)zReturns an array of strings (and possibly voice and audio specifications) containing the role name of the parent of obj. rZrsN) basicWhereAmIdetailedWhereAmI) r\rr]rr^rr ROLE_ICON_PANELrqr is_table_cellis_menur)rrIrJrus r_generateParentRoleNamez'SpeechGenerator._generateParentRoleName_s 88FH--c2 3uzz Fxx d+78%556 6$$S)  $ $V , 0C0CF0KC%%h&9&9#&>??r!c g}tj|tj}|r@|j |j ||j |j ||S)zReturns an array of strings (and possibly voice and audio specifications) containing the name and role of the toolbar which contains obj. )rrr is_tool_barrcr>r)rrIrJrfrts r_generateToolbarz SpeechGenerator._generateToolbarmsW ))#{/F/FG  MM$44X> ? MM$00: ; r!c tjjdrgStj|t j jtj}||vrgSg}d}t|tj|}|j|jjj!dd|j#|dzt%|dz|j'|j(t*fd |i||S) zReturns an array of strings (and possibly voice and audio specifications) that represent the relative position of an object in a group. r[cXtj|tj|z Sr)rr9)rBys rcmpz5SpeechGenerator._generatePositionInGroup..cmps$//2X5Q5QRS5TT Tr!)rr groupindexr4rrrI)r r`rarr rr r rr%sorted functools cmp_to_keyrprlr7r8rrrcr;rd)rrIrJr rfrs r_generatePositionInGroupz(SpeechGenerator._generatePositionInGroupys  & & ( 3 34L MI// ##--{/E/EG g I Ui&:&:3&?@ dll--77#+)587(/}}S'9A'='*7|55 6  jdjj9S9D9: r!c ,tjjds5tjjds|jddsgS|jj j |rgS|jj j|rgSg}|jj j|fi|\}}|dkrgSd}|dkr,|jj j|sgS|dz }|dk(rtj|rgS|dz }|j|jjjd | ||d z|j|j t"fd |i||S) zReturns an array of strings (and possibly voice and audio specifications) that represent the relative position of an object in a list. r[enablePositionSpeaking forceListFrr totalunknownrrr4rrI)r r`rar\rlrmisTopLevelMenurgetPositionAndSetSizesetSizeUnknownrrrpr7r8rcr;rd)rrIrJrfpositionrr5s r_generatePositionInListz'SpeechGenerator._generatePositionInListst  & & ( 3 34L M#..0;;F MM*$**V=== > r!c |jdr|j|fi|sdgSg}tj|}|L|j t j ||j|jtfd|i||S)NrrOrI) r\rrrrpr rrcr;rd)rrIrJrfpercents r_generateProgressBarValuez)SpeechGenerator._generateProgressBarValues 88) *7477DtD4K..s3   MM(--g6 7 MM*$**V=== > r!ctjjd}|t|}t |S)NprogressBarSpeechInterval)r r`rarU_getProgressBarUpdateIntervalrR)rintervalrXs rr#z-SpeechGenerator._getProgressBarUpdateIntervals:#..0;;H8}r!c ltjjdsyt||fi|S)NspeakProgressBarUpdatesF)r r`rarUr)rrIrJrXs rrz/SpeechGenerator._shouldPresentProgressBarUpdates3**,778QRw6sCdCCr!c jtj|sgS|jjj |}|r||gk(rgSg}|D]e}||k(r |j |d}|s|j |t|dtrD|j |j|fi|g|S)zReturns an array of strings (and possibly voice and audio specifications) that represent the status bar of a window. FincludeContextr%) r is_status_barrlrmstatusBarItemsrDrcr@rr)rrIrJr/rfr9 childResults r_generateStatusBarz"SpeechGenerator._generateStatusBars ((-I &&55c:#I FE|--e-DK k*!+b/59MM"5$"5"5e"Dt"DE F r!c g}|jjj|\}}|r5|j|}|s|j |}|j ||r |j |j||jjj |}|dkDrOtj|g}|j|jtfd|i||j ||S)zReturns an array of strings (and possibly voice and audio specifications) that represent the title of the window, obj. containing the object, along with information associated with any unfocused dialog boxes. rrI) rlrmrr>rrprDr rErcr;re) rrIrJrfrr frameResultrFdialogss r generateTitlezSpeechGenerator.generateTitle s  ..==cB v 44U;K"44U; MM+ &  MM$44V< ="ll44QQRUV  "112EFGG NN:4::g?3?$? @ MM' " r!c tjtj|sgSg}tj|}|D]$}|j |j |d&|S)NFr()rrrrqget_all_widgetsrprD)rrIrJrfwidgetswidgets r_generateListBoxItemWidgetsz+SpeechGenerator._generateListBoxItemWidgets sd&&x':':3'?@I--c2 GF MM$--u-E F G r!c tjjdrgSg}|jjj |\}}}|r9|j ||j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) that represent the accelerator for the object, or an empty array if no accelerator can be found. r[rI) r r`rarlrmmnemonicShortcutAcceleratorrprcr;rdrrIrJrfmnemonicshortcut accelerators r_generateAcceleratorz$SpeechGenerator._generateAccelerator, s~  & & ( 3 34L MI LL " " > >s C *8[  MM+ & MM*$**V=== > r!c tjjdrgSg}tjjds|jddrc|jj j |\}}}|r|d}|s|r|}|r+|g}|j|jtfd|i||S)zReturns an array of strings (and possibly voice and audio specifications) that represent the mnemonic for the object, or an empty array if no mnemonic can be found. r[enableMnemonicSpeaking forceMnemonicFr%rI) r r`rar\rlrmr8rcr;rdr9s r_generateMnemonicz!SpeechGenerator._generateMnemonic= s  & & ( 3 34L MI  & & ( 3 34L Mhh. &&BB3G .Xx#B<#" jdjjASADAB r!c tjjds#|jddj dsgSt j |}|sgS||jtfd|i|gS)z}Returns an array of strings (and possibly voice and audio specifications) that represent the tutorial for the object.enableTutorialMessagesrsrOWhereAmIrI) r r`rar\endswithr get_help_textr;rd)rrIrJr7s r_generateTutorialz!SpeechGenerator._generateTutorialT sr **,778PQ88L"-66zBI%%c*Ijdjj9S9D9::r!c g}tj|Dcgc]}|}}|s(|jjj |s|g}|D]}|jjj |r6tj |r!|j|j|^|j|}|j|||j|j|||j|||Scc}wNr) rrrlrmisMathTopLevelisMathLayoutOnlyr*rc _generateMathrrurDrv)rrIrJrfr9rrxs rrLzSpeechGenerator._generateMathd s'/'='=c'BCeECC 6 6 E Ec JuH -E||%%66u=(BZBZ[`Ba d0078..u5G   w - MM$--G-< =   gt , - Ds D c (|j|fi|Sr)rLr]s r_generateEnclosedBasez%SpeechGenerator._generateEnclosedBasev s!t!!#...r!c g}|jjj|}d|vr|jtj d|vr|jtj d|vr|jtjd|vr|jtjd|vr|jtjd|vr|jtjd|vr|jtjd|vr|jtjd |vr|jtjd |vr|jtjd |vr|jtjd |vr|jtj d |vr|jtj"d|vr|jtj$d|vr|jtj&d|vr|jtj(d|vr|jtj*|s+d|g}t-j.t,j0|dgSt3|dk(rtj4|dzg}nu|j7dtj8t3|dk(r$tj4dj;|zg}n#tj4dj;|zg}|j=|j>t@fd|i||S)N actuarialboxcirclelongdivradical roundedboxhorizontalstrikeverticalstrikedowndiagonalstrikeupdiagonalstrikenortheastarrowbottomleftrighttop phasoranglemadruwbz5SPEECH GENERATOR: Could not get enclosure message forTrrr%rrPz, rI)!rlrmgetMathEnclosuresrpr MATH_ENCLOSURE_ACTUARIALMATH_ENCLOSURE_BOXMATH_ENCLOSURE_CIRCLEMATH_ENCLOSURE_LONGDIVMATH_ENCLOSURE_RADICALMATH_ENCLOSURE_ROUNDEDBOXMATH_ENCLOSURE_HORIZONTALSTRIKEMATH_ENCLOSURE_VERTICALSTRIKE!MATH_ENCLOSURE_DOWNDIAGONALSTRIKEMATH_ENCLOSURE_UPDIAGONALSTRIKEMATH_ENCLOSURE_NORTHEASTARROWMATH_ENCLOSURE_BOTTOMMATH_ENCLOSURE_LEFTMATH_ENCLOSURE_RIGHTMATH_ENCLOSURE_TOPMATH_ENCLOSURE_PHASOR_ANGLEMATH_ENCLOSURE_MADRUWBrrGrHrMATH_ENCLOSURE_ENCLOSED_BYinsertMATH_ENCLOSURE_ANDrTrcr;rd)rrIrJstrings enclosuresrLrfs r_generateEnclosedEnclosuresz+SpeechGenerator._generateEnclosedEnclosuresy s\\++==cB * $ NN8<< = J  NN866 7 z ! NN899 :  " NN8:: ;  " NN8:: ; : % NN8== >  + NN8CC D z ) NN8AA B : - NN8EE F  + NN8CC D z ) NN8AA B z ! NN899 : Z  NN877 8 j NN888 9 J  NN866 7 J & NN8?? @  " NN8:: ;MzZF   e.. =I w<1 99GAJFGF NN2x:: ;7|q "==@QQR"== '@RRS jdjj9S9D9: r!c |jjj|\}}|r@tj|g}|j |j tfd|i||SgSr`rlrm getMathFencesr rrcr;rerrIrJ fenceStartfenceEndrfs r_generateFencedStartz$SpeechGenerator._generateFencedStart sb#||55CCCH H !22:>?F MM*$**W>#>> ?M r!c zg}|jjj|}tt |t j |dz D]}|j|d|jdtt j|D]\}}|j|j|fi|tj||}|j||j|jtfd|i||s||j|j |fi||S)Nrr%rOrI)rlrmgetMathFencedSeparatorsrangerrr*rprrrcrLr rr;rer) rrIrJrf separatorsrBrr9 separatorNames r_generateFencedContentsz'SpeechGenerator._generateFencedContents s\\++CCCH s:(@(@(Ea(GH .A   jn - ."!("8"8"=> @HAu MM,$,,U;d; <'88AGM MM- ( MM*$**W>#>> ? 1d11#>>?  @ r!c |jjj|\}}|r@tj|g}|j |j tfd|i||SgSr`rzr|s r_generateFencedEndz"SpeechGenerator._generateFencedEnd sb#||55CCCH H !228<=F MM*$**W>#>> ?M r!c |jjj|rtjg}ntj g}|j |jtfd|i||Sr`) rlrmisMathFractionWithoutBarr MATH_FRACTION_WITHOUT_BAR_STARTMATH_FRACTION_STARTrcr;rdris r_generateFractionStartz&SpeechGenerator._generateFractionStart s\ << ! ! : :3 ?>>?F223F jdjj9S9D9: r!c L|jjj|}|jjj|r|j |S|j |}|j |||j||}|j|||SrI) rlrmgetMathNumeratorrKrLrrurDrv)rrIrJ numeratorrxrfs r_generateFractionNumeratorz*SpeechGenerator._generateFractionNumerator sLL**;;C@ << ! ! 2 29 =%%i0 0**95 7D)yw7 '4( r!c L|jjj|}|jjj|r|j |S|j |}|j |||j||}|j|||SrI) rlrmgetMathDenominatorrKrLrrurDrv)rrIrJ denominatorrxrfs r_generateFractionDenominatorz,SpeechGenerator._generateFractionDenominator sll,,??D << ! ! 2 2; ?%%k2 2**;7 7D){9 '4( r!c xtjg}|j|jtfd|i||Sr`)r MATH_FRACTION_LINErcr;rdris r_generateFractionLinez%SpeechGenerator._generateFractionLine s6--. jdjj9S9D9: r!c xtjg}|j|jtfd|i||Sr`)r MATH_FRACTION_ENDrcr;rdris r_generateFractionEndz$SpeechGenerator._generateFractionEnd s6,,- jdjj9S9D9: r!c g}|jjj|rtjg}nm|jjj |}|jjj |}|dk(rtjg}n |dk(rtjg}n|r$|g}|jtjgn|jjj|r2|j|}|jtjgnw|j|}|j|||j|j|||j|||jtjg|r(|j|j t"fd|i||S)N23rrI)rlrmisMathSquareRootr MATH_SQUARE_ROOT_OFgetMathRootIndexr(MATH_CUBE_ROOT_OFrc MATH_ROOT_OFrKrLrrurDrvr;rd)rrIrJrfrrrxs r_generateRootStartz"SpeechGenerator._generateRootStart sn << ! ! 2 23 7223FLL**;;C@E\\++99%@F}"6673"445  x4456''88?++E2 x44562259""7D1 dmmEm@A!!'40 x4456  MM*$**V=== > r!c .|jjj|}|sgS|jjj|sJ|jjj |s%|jjj |r|j |S|j|fi|g}|j|}|j|||j|j|||j|||SrI) rlrmgetMathRootBaser isMathTokenrKrLrrrurcrDrv)rrIrJbaserfrxs r_generateRootBasez!SpeechGenerator._generateRootBase s||%%55c:I << ! ! 2 23 7ll$$006ll$$55d;%%d+ +%$%%c2T23**40 7D) dmmDwm78 '4( r!c xtjg}|j|jtfd|i||Sr`)r MATH_ROOT_ENDrcr;rdris r_generateRootEndz SpeechGenerator._generateRootEnd) s6(() jdjj9S9D9: r!c v|jjj|}|sgS|j|Sr)rlrmgetMathScriptBaserL)rrIrJrs r_generateScriptBasez#SpeechGenerator._generateScriptBase. s5||%%77<I!!$''r!c |jjj|r|j|S|j |}|j |||j ||}|j|||SrI)rlrmrKrLrrurDrv)rrIrJrxrfs r_generateScriptScriptz%SpeechGenerator._generateScriptScript5 sr << ! ! 2 23 7%%c* ***3/ 7D)s1 '4( r!c |jjj|}|sgStjg}|j |j tfd|i||j |j||Sr`) rlrmgetMathScriptSubscriptr MATH_SUBSCRIPTrcr;rdr)rrIrJ subscriptrfs r_generateScriptSubscriptz(SpeechGenerator._generateScriptSubscript@ soLL**AA#F I))* jdjj9S9D9: d00;< r!c |jjj|}|sgStjg}|j |j tfd|i||j |j||Sr`) rlrmgetMathScriptSuperscriptr MATH_SUPERSCRIPTrcr;rdr)rrIrJ superscriptrfs r_generateScriptSuperscriptz*SpeechGenerator._generateScriptSuperscriptK oll,,EEcJ I++, jdjj9S9D9: d00=> r!c |jjj|}|sgStjg}|j |j tfd|i||j |j||Sr`) rlrmgetMathScriptUnderscriptr MATH_UNDERSCRIPTrcr;rdr)rrIrJ underscriptrfs r_generateScriptUnderscriptz*SpeechGenerator._generateScriptUnderscriptV rr!c |jjj|}|sgStjg}|j |j tfd|i||j |j||Sr`) rlrmgetMathScriptOverscriptr MATH_OVERSCRIPTrcr;rdr)rrIrJ overscriptrfs r_generateScriptOverscriptz)SpeechGenerator._generateScriptOverscripta so\\++CCCH I**+ jdjj9S9D9: d00<= r!c g}|jjj|}t|D]\}}|jjj |r,|dzrt j g}nt jg}|j|jtfd|i||j|j||j||SNr#rI) rlrmgetMathPrescriptsr isNoneElementr MATH_PRE_SUPERSCRIPTMATH_PRE_SUBSCRIPTrcr;rdrrp)rrIrJrf prescriptsrr9rKs r_generateScriptPrescriptsz)SpeechGenerator._generateScriptPrescriptsl s\\++==cB ":. IAv||%%33F;1u334112 IIjdjj9S9D9 : IId008 9 MM"   r!c g}|jjj|}t|D]\}}|jjj |r,|dzrt j g}nt jg}|j|jtfd|i||j|j||j||Sr) rlrmgetMathPostscriptsrrr rrrcr;rdrrp)rrIrJrf postscriptsrr9rKs r_generateScriptPostscriptsz*SpeechGenerator._generateScriptPostscripts| sll,,??D ";/ IAv||%%33F;1u//0--. IIjdjj9S9D9 : IId008 9 MM"   r!c tj|sgStj|}tj|}|j j j|}|dkDrtj||g}ntj||g}|j|jtfd|i||SNrrI)rsupports_tablerrrrlrmgetMathNestingLevelr mathNestedTableSize mathTableSizercr;rd)rrIrJrrrrfs r_generateMathTableStartz'SpeechGenerator._generateMathTableStart s&&s+I$$S)**3/||--AA#F ! 224ABF,,T7;E MM$,,U3 4 MM-$--e r!c |jjj|}|dkDrtjg}ntj g}|j |jtfd|i||Sr) rlrmrr MATH_NESTED_TABLE_ENDMATH_TABLE_ENDrcr;rd)rrIrJrrfs r_generateMathTableEndz%SpeechGenerator._generateMathTableEnd sf||--AA#F ! 445F--.F jdjj9S9D9: r!c tjjdr|jddrgStjjdtj k(rgSt S)NenablePauseBreakseliminatePausesFverbalizePunctuationStyle)r r`rar\r PUNCTUATION_STYLE_ALLr#r]s rrzSpeechGenerator._generatePause s^**,778KLhh(%0I  & & ( 3 34O P  ) ) *I r!c tSr) LINE_BREAKr]s r_generateLineBreakz"SpeechGenerator._generateLineBreak sr!c ~tj|xstjt}tjj d}t j|jtjti}|jd}|jdd}d|d|d|d}tjtj|d d } |r(| r&tj} | j|||d tfvr|jd d} |jd } tj| r;|j!|jtjt"i|gSt%| t&rf| j)rV| j+j-r8|j!|jtjt.i|gS|j|} | r#| jdd r|j!| |gS)zReturns an array containing a voice. The key is a value to be used to look up the voice in the settings.py:voices dictionary. Other arguments can be passed in for future decision making. voicesrrrOzSPEECH GENERATOR: z voice requested with language='z ', dialect='rTFNrrI established) voiceTyper\rer r`rarrRrrrHrgetSpeechServershouldChangeVoiceForLanguageris_linkupdate HYPERLINKr@strisupperrisalpha UPPERCASE)rrrJ voicenamerr;rrrcheckVoicesForLanguageserverrrIoverrides rr;zSpeechGenerator.voice sMM#&@)--*@ !,,.99(C &**Y]]7%;R@A88J'((9b) &! ,wiq :  5++S$7 "' .++-F  / /' B 4/ !XXh+F((5/C""3' VZZ i(@"EFwFC(V^^-=&,,.BXBXBZ VZZ i(@"EF w zz),HHLL= X&wr!cd}|D]H}t|tr |d|z }t|ts-|s0|djsD|dz }J|j S)NrOrPr%r<)r@rrisalnumr)r utterancesrus rutterancesToStringz"SpeechGenerator.utterancesToString sb A!S!AaS'!Au%&VBZ5G5G5I#    ||~r!)Tr)r&r'r(r)rr<rMrSrbrhrsrwrr~rrrrrrrrrrrrrrrrrrrrrrrr|rrrrrrrrr:rHrYr^rbrdrfrlroryr}rrrrrrrrrrrrrrrrrrrrrrrrr(r+r1r<r@rBrGrrrrrrrrr rrr r#rr-r1r6r=rArGrLrNrxrrrrrrrrrrrrrrrrrrrrrrrrrr;r __classcell__)rXs@rr6r6gs8 =* C : 8  +Z    $2$2& ,*>@ 9$B      (2h!FJ *$4.7.**+Z 1  . 42/b$%>N$@`">0   (4.<B$"$:D$82?!BAFn`8t&P @  D&P  D 20 ". ; $/4l"    :$ (         'Rr!r6):r)__id__ __version____date__ __copyright__ __license__rgirequire_version gi.repositoryr urllib.parser)urllib.request urllib.errorrOrrrr r r r r rr ax_documentr ax_hypertextr ax_objectrax_tablerax_textr ax_utilitiesrax_valuerrr#r+r METHOD_PREFIXrerrrdrVALUE DEFAULT_VOICEUPPERCASE_VOICEHYPERLINK_VOICE SYSTEM_VOICErr8r6rr!rrs+(= ?   7E""#%%  k]     X # # x'' x'' H ! ! 8  8   X*i))X*r!