| Server IP : 182.53.201.61 / Your IP : 216.73.217.175 Web Server : Apache/2.2.15 (Fedora) System : Linux km10.dyndns.org 2.6.31.5-127.fc12.i686.PAE #1 SMP Sat Nov 7 21:25:57 EST 2009 i686 User : apache ( 48) PHP Version : 5.3.3 Disable Function : NONE MySQL : ON | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /usr/lib/python2.6/site-packages/orca/ |
Upload File : |
z#Jc @ s d Z d Z d Z d Z d Z d Z d d k Z e i d Z d d k Z d d k
Z
d d k Z e i y d d k
Z
Wn e j
o
d Z
n Xy( d d k Z d a e Z e a d a Wn e Z e a n Xy d d k Z Wn n Xd d k Z d d k Z d d k Z d d k Z d d
k l Z d d k l Z d a g Z! e o" e i" e i# e i$ e i% g Z! n h Z& e o e d e& e i" <e d
e& e i# <e d e& e i$ <e d e& e i% <e d e& e i' <e d e& e i( <e d e& e i) <e d e& e i* <e d e& e i+ <e d e& e i, <e d e& e i- <e d e& e i. <n d Z/ e/ d g a0 g a1 d a2 d a3 d d g a4 d a5 e a6 e a7 d a8 d a9 d a: h e d d 6e d d 6e d d 6e d d! 6e d" d# 6e d$ d% 6e d& d' 6e d( d) 6e d* d+ 6e d, d- 6e d. d/ 6e d0 d1 6e d2 d3 6e d4 d5 6e d6 d7 6e d8 d9 6e d: d; 6e d< d= 6e d> d? 6e d@ dA 6e dB dC 6e dD dE 6e dF dG 6e dH dI 6e dJ dK 6e dL dM 6e dN dO 6e dP dQ 6e dR dS 6Z; dT Z< dU Z= e
o
e= Z> n dV Z? dW d dX YZ@ dY e@ f dZ YZA d[ eA f d\ YZB d] e@ f d^ YZC d_ eA f d` YZD da e@ f db YZE dc d dd YZF de ZG df ZH dg ZI dh ZJ di ZK dj ZL e e dk ZM dl ZN e d e e dm ZO dn ZP e do ZQ dp ZR dq ZS d dr ZT d d ds ZU d dt ZV d du ZW dv ZX d dw ZY dx ZZ dy Z[ dz Z\ d{ Z] d| Z^ d d} d~ Z_ d Z` d S( s A very experimental approach to the refreshable Braille display. This
module treats each line of the display as a sequential set of regions, where
each region can potentially backed by an Accessible object. Depending upon
the Accessible object, the cursor routing keys can be used to perform
operations on the Accessible object, such as invoking default actions or
moving the text caret.
s $Id$s
$Revision$s $Date$s- Copyright (c) 2005-2009 Sun Microsystems Inc.t LGPLiNt braillei ( t tablesdir( t _s Line Lefts
Line Rights Line Ups Line Downt Freezes Top Lefts Bottom Rights Cursor Positions Six Dotss Cursor Routings Cut Begins Cut Linei i s
Czech Grade 1s Cz-Cz-g1s Spanish Grade 1s Es-Es-g1s Canada French Grade 2s Fr-Ca-g2s France French Grade 2s Fr-Fr-g2s Latvian Grade 1s Lv-Lv-g1s Netherlands Dutch Grade 1s Nl-Nl-g1s Norwegian Grade 0s No-No-g0s Norwegian Grade 1s No-No-g1s Norwegian Grade 2s No-No-g2s Norwegian Grade 3s No-No-g3s Polish Grade 1s Pl-Pl-g1s Portuguese Grade 1s Pt-Pt-g1s Swedish Grade 1s Se-Se-g1s Arabic Grade 1s ar-ar-g1s
Welsh Grade 1s cy-cy-g1s
Welsh Grade 2s cy-cy-g2s German Grade 0s de-de-g0s German Grade 1s de-de-g1s German Grade 2s de-de-g2s U.K. English Grade 2s en-GB-g2s U.K. English Grade 1s en-gb-g1s U.S. English Grade 1s en-us-g1s U.S. English Grade 2s en-us-g2s Canada French Grade 1s fr-ca-g1s France French Grade 1s fr-fr-g1s
Greek Grade 1s gr-gr-g1s
Hindi Grade 1s hi-in-g1s Italian Grade 1s it-it-g1s Belgium Dutch Grade 1s nl-be-g1c C s h } yb x[ t i t D]J } | d d j o3 | d } t i i t | | t i | | <q q WWn t j
o n X| S( Nis .utbs .ctb( s .utbs .ctb( t ost listdirR t patht joint TABLE_NAMESt gett OSError( t tablest fnamet alias( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt
listTables s
1c C sq yW xP t i t D]? } | d d j o( | i d o t i i t | Sq q WWn t j
o n Xd S( Nis .utbs .ctbs en-ust ( s .utbs .ctb( R R R t
startswithR R R ( R
( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getDefaultTable s c C s t i | d t | d S( s Prints out a Braille event. The given level may be overridden
if the eventDebugLevel (see debug.setEventDebugLevel) is greater in
debug.py.
Arguments:
- command: the BrlAPI command for the key that was pressed.
s BRAILLE EVENT: %sN( t debugt printInputEventt repr( t levelt command( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt _printBrailleEvent* s t Regionc B sw e Z d Z d e d Z d Z d Z e d Z d Z d e d Z
d Z d Z d
Z
d Z RS( sp A Braille region to be displayed on the display. The width of
each region is determined by its string.
i c C s | p
d } n t i o
t d j | _ | | _ | i d i d | _ | i oG t i p t
| _ | i | i | | \ | _
| _ | _ | _ n | i | _
| | _ d S( s Creates a new Region containing the given string.
Arguments:
- string: the string to be displayed
- cursorOffset: a 0-based index saying where to draw the cursor
for this Region if it gets focus.
R s UTF-8s
N( t settingst enableContractedBraillet louist Nonet
contractedt expandOnCursort decodet stript rawLinet brailleContractionTablet _defaultContractionTablet contractionTablet contractLinet stringt inPost outPost cursorOffset( t selfR' R* R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt __init__< s
( c C s d | i | i f S( Ns Region: '%s', %d( R' R* ( R+ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt __str__] s c C s d S( s Processes a cursor routing key press on this Component. The offset
is 0-based, where 0 represents the leftmost character of string
associated with this region. Note that the zeroeth character may have
been scrolled off the display.N( ( R+ t offset( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt processRoutingKey` s c C s= t | i d | i i d } d g | } d i | S( s Creates a string which can be used as the attrOr field of brltty's
write structure for the purpose of indicating text attributes, links,
and selection.
Arguments:
- getLinkMask: Whether or not we should take the time to get
the attributeMask for links. Reasons we might not want to
include knowning that we will fail and/or it taking an
unreasonable amount of time (AKA Gecko).
i u …t R ( t lenR' t countR ( R+ t getLinkMaskt maskSizet mask( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getAttributeMaskg s #
c C sH | i o: | i | i | i | i \ | _ | _ | _ | _ n d S( s: Reposition the cursor offset for contracted mode.
N( R R& R" R* R R' R( R) ( R+ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt repositionCursor| s
c
C s y | | d j } Wn t j
o
t } n X| p | o
d } n
t i } t i | i g | d | d | \ } } } } t | t | } | | | | f S( s* Contract the given line. Returns the contracted line, and the
cursor position in the contracted line.
Arguments:
- line: Line to contract.
- cursorOffset: Offset of cursor,defaults to 0.
- expandOnCursor: Expand word under cursor, False by default.
t i t cursorPost mode( t
IndexErrort FalseR t compbrlAtCursort translateR% t minR1 (
R+ t lineR* R t
cursorOnSpaceR: R R( R) R9 ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR& s
c C sR y | i | } Wn: t j
o t | i } n t j
o
| } n X| S( N( R( R; R1 R" t AttributeError( R+ t display_offsetR. ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt displayToBufferOffset s c C s6 | o! t i p t | _ | i n | i d S( N( R R# R$ R% t contractRegiont expandRegion( R+ R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt setContractedBraille s
c C sR | i o d S| i | i | i | i \ | _ | _ | _ | _ t | _ d S( N( R R& R" R* R R' R( R) t True( R+ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRE s
$c C sg | i p d S| i | _ y | i | i | _ Wn% t j
o t | i | _ n Xt | _ d S( N( R R" R' R( R* R; R1 R< ( R+ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRF s
( t __name__t
__module__t __doc__R< R, R- R/ RH R6 R7 R& RD RG RE RF ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR 7 s ! t Componentc B s; e Z d Z d d e d Z d Z d Z d Z RS( s A subclass of Region backed by an accessible. This Region will react
to any cursor routing key events and perform the default action on the
accessible, if a default action exists.
i R c C sY t i | | | | | o/ | i o | d | i | _ qL | | _ n | | _ d S( s Creates a new Component.
Arguments:
- accessible: the accessible
- string: the string to use to represent the component
- cursorOffset: a 0-based index saying where to draw the cursor
for this Region if it gets focus.
R8 N( R R, R' t
accessible( R+ RM R' R* t indicatorR ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR, s
c C s d | i | i f S( Ns Component: '%s', %d( R' R* ( R+ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR- s c C s d S( s Returns the caret position of the given offset if the object
has text with a caret. Otherwise, returns -1.
Arguments:
- offset: 0-based offset of the cell on the physical display
i( ( R+ R. ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getCaretOffset s c C s y | i i } Wn^ t i t i d y t i | i d Wq t i t i d t i t i q Xn X| i d d S( s Processes a cursor routing key press on this Component. The offset
is 0-based, where 0 represents the leftmost character of string
associated with this region. Note that the zeroeth character may have
been scrolled off the display.s. braille.Component.processRoutingKey: no actioni s Could not process routing key:i N(
RM t queryActionR t printlnt LEVEL_FINESTt eventsynthesizert clickObjectt LEVEL_SEVEREt printExceptiont doAction( R+ R. t action( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR/ s ( RI RJ RK R< R, R- RO R/ ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRL s t Linkc B s/ e Z d Z d d Z d Z e d Z RS( s A subclass of Component backed by an accessible. This Region will be
marked as a link by dots 7 or 8, depending on the user's preferences.
i c C s t i | | | | d t d S( sl Initialize a Link region. similar to Component, but here we always
have the region expand on cursor.R N( RL R, RH ( R+ RM R' R* ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR, s c C s d | i | i f S( Ns Link: '%s', %d( R' R* ( R+ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR- s c C s t t i t | i S( s Creates a string which can be used as the attrOr field of brltty's
write structure for the purpose of indicating text attributes and
selection.
Arguments:
- getLinkMask: Whether or not we should take the time to get
the attributeMask for links. Reasons we might not want to
include knowning that we will fail and/or it taking an
unreasonable amount of time (AKA Gecko).
( t chrR t brailleLinkIndicatorR1 R' ( R+ R3 ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR6 s ( RI RJ RK R, R- RH R6 ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRY
s t Textc B st e Z d Z d d d d d Z d Z d Z d Z d Z e d Z
d e d Z d
Z d Z
RS(
sj A subclass of Region backed by a Text object. This Region will
react to any cursor routing key events by positioning the caret in
the associated text object. The line displayed will be the
contents of the text object preceded by an optional label.
[[[TODO: WDW - need to add in text selection capabilities. Logged
as bugzilla bug 319754.]]]R c C s | | _ t i o5 | i o+ t i i | i | \ } | _ | _ n d } d | _ d | _ | i d } | o | i d } n | o | i d } n y | | i } Wn t j
o n Xy | | i | _ Wn t j
o d | _ n X| | i | !} | i | i 8_ t | i | i t
| } | i t
| | _ | | _ | o | d | _
n
d | _
| i
| } | t
| i
7} t i | | | t | i o! t i o | i | i 7_ n t i o | i d 7_ n d S( s Creates a new Text region.
Arguments:
- accessible: the accessible that implements AccessibleText
- label: an optional label to display
R i s UTF-8R8 N( RM t
orca_statet activeScriptt getTextLineAtCarett caretOffsett
lineOffsetR t TypeErrort startOffsetR? R1 t _maxCaretOffsett eolt labelR R, RH R R t disableBrailleEOLR' ( R+ RM Rf Re Rc t endOffsetR' R* ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR, / sF
c C s d | i | i f S( Ns Text: '%s', %d( R' R* ( R+ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR- o s c C s t i i | i | i \ } } } | i d } t | | t | } | | i j o t S| | _
| | _ | t | i 7} | i o1 | i
| i | t \ | _ | _ | _ } n | | _ t S( s Attempts to reposition the cursor in response to a new
caret position. If it is possible (i.e., the caret is on
the same line as it was), reposition the cursor and return
True. Otherwise, return False.
s UTF-8( R] R^ R_ RM Rc R R? R1 Ra R< R` Rf R R& R" RH R' R( R) R* ( R+ R' R` Ra R* ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR7 r s
1 c C s8 | i | } | d j o d St | i | | i S( s Returns the caret position of the given offset if the object
has text with a caret. Otherwise, returns -1.
Arguments:
- offset: 0-based offset of the cell on the physical display
i i( RD R? Ra Rd ( R+ R. ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRO s
c C s; | i | } | d j o d St i i | i | d S( s Processes a cursor routing key press on this Component. The offset
is 0-based, where 0 represents the leftmost character of text
associated with this region. Note that the zeroeth character may have
been scrolled off the display.
i N( RO R] R^ t setCaretOffsetRM ( R+ R. R` ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR/ s
c C sL y | i i } Wn t j
o d SXt | i t | i } | i | } t i g | } t i } t i
} t i } t i
} | o | t i j o y | i i }
|
i } Wn
d } n Xd } x | | j or |
i | }
| i |
i j oB x? t |
i |
i D]$ } y | | c | O<WqqXqWn | d 7} q Wn | o.| i t i } | i } x| | j o | i | i | t \ } } } | | j o Pn t i } | } xK | D]C } | i | d d j o$ | | | | j o | } PqqqW| t i j oZ t | | i d } t | | i | } x+ t | | D] } | | c | O<qhWqqWn | o | i | i } xn | D]b \ } } t | | i d } t | | i | } x' t | | D] } | | c | O<qWqWn | i o d g t | i } | i t | i } | i o6 g } | D] } | | t | i d qd~ } n xK t | D]= \ } } y | | | c | O<Wqt j
o
qqXqW| t | i! } n | d g t | i" 7} | i o d g t | i | } n d i# t$ t% | S( s Creates a string which can be used as the attrOr field of brltty's
write structure for the purpose of indicating text attributes, links,
and selection.
Arguments:
- getLinkMask: Whether or not we should take the time to get
the attributeMask for links. Reasons we might not want to
include knowning that we will fail and/or it taking an
unreasonable amount of time (AKA Gecko).
R i i (& RM t queryTextt NotImplementedErrorR1 R" Rf Ra R t TEXT_ATTR_BRAILLE_NONEt textAttributesBrailleIndicatort brailleSelectorIndicatorR[ R] R^ t BRAILLE_LINK_NONEt queryHypertextt getNLinkst getLinkt
startIndext xranget endIndext attributeStringToDictionaryt enabledBrailledTextAttributest getTextAttributesRH R
t maxR? t getAllTextSelectionsR R) t enumerateR; R' Re R t mapRZ ( R+ R3 t textt stringLengtht
lineEndOffsett
regionMaskt
attrIndicatort selIndicatort
linkIndicatort scriptt hyperTextt nLinkst nt linkt it enabledAttributesR. t
attributesRc Rh R5 t attribt maskStartt maskEndt
selectionst contractedMaskR) t _[1]t m( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR6 s
!
6
i c C s; t i | | | | \ } } } } | | i | | | f S( N( R R& Re ( R+ R@ R* R R R( R) R9 ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR& s c C s6 t i | | } | | i 7} | t | i 8} | S( N( R RD Rc R1 Rf ( R+ RC R. ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRD s
c C s1 t i | | | p | i | i 7_ n d S( N( R RG R' Re ( R+ R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRG s N( RI RJ RK R R, R- R7 RO R/ RH R6 R& RD RG ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR\ ' s ? f t ReviewComponentc B s e Z d Z d Z RS( s@ A subclass of Component that is to be used for flat review mode.c C s) t i | | | | d t | | _ d S( s_ Creates a new Component.
Arguments:
- accessible: the accessible
- string: the string to use to represent the component
- cursorOffset: a 0-based index saying where to draw the cursor
for this Region if it gets focus.
- zone: the flat review Zone associated with this component
R N( RL R, RH t zone( R+ RM R' R* R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR, & s
( RI RJ RK R, ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR # s t
ReviewTextc B s) e Z d Z d Z d Z d Z RS( s A subclass of Region backed by a Text object. This Region will
does not react to the caret changes, but will react if one updates
the cursorPosition. This class is meant to be used by flat review
mode to show the current character position.
c C s5 t i | | d t | | _ | | _ | | _ d S( sI Creates a new Text region.
Arguments:
- accessible: the accessible that implements AccessibleText
- string: the string to use to represent the component
- lineOffset: the character offset into where the text line starts
- zone: the flat review Zone associated with this component
R N( R R, RH RM Ra R ( R+ RM R' Ra R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR, ; s c C s, | i | } | d j o d S| i | S( s Returns the caret position of the given offset if the object
has text with a caret. Otherwise, returns -1.
Arguments:
- offset: 0-based offset of the cell on the physical display
i i( RD Ra ( R+ R. ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRO I s
c C s) | i | } t i i | i | d S( s Processes a cursor routing key press on this Component. The offset
is 0-based, where 0 represents the leftmost character of text
associated with this region. Note that the zeroeth character may have
been scrolled off the display.N( RO R] R^ Ri RM ( R+ R. R` ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR/ W s ( RI RJ RK R, RO R/ ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR 4 s t Linec B sS e Z d Z d d Z d Z d Z e d Z d Z d Z
d Z RS( sa A horizontal line on the display. Each Line is composed of a sequential
set of Regions.
c C s. g | _ d | _ | o | i | n d S( NR ( t regionsR' t addRegion( R+ t region( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR, e s c C s | i i | d S( N( R t append( R+ R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR k s c C s | i i | d S( N( R t extend( R+ R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt
addRegionsn s c C s d } d } d } xn | i D]c } | t j o t | } n | i o | | i i d d 7} n | i | } | | 7} q W| | | g S( s$ Computes the complete string for this line as well as a
0-based index where the focused region starts on this line.
If the region with focus is not on this line, then the index
will be -1.
Arguments:
- getLinkMask: Whether or not we should take the time to get
the attributeMask for links. Reasons we might not want to
include knowning that we will fail and/or it taking an
unreasonable amount of time (AKA Gecko).
Returns [string, offsetIndex, attributeMask]
R iu …s ...( R t _regionWithFocusR1 R' t replaceR6 ( R+ R3 R' t focusOffsett
attributeMaskR R5 ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getLineInfoq s
c C s d } d } d } xH | i D]= } | } | | i } t | | j o Pq t | } q W| t | j o d d g S| | | g Sd S( s5 Finds the Region at the given 0-based offset in this line.
Returns the [region, offsetinregion] where the region is
the region at the given offset, and offsetinregion is the
0-based offset from the beginning of the region, representing
where in the region the given offset is.R i iN( R R R' R1 ( R+ R. t foundRegionR' t posR ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getRegionAtOffset s
c C s1 | i | \ } } | o | i | n d S( s Processes a cursor routing key press on this Component. The offset
is 0-based, where 0 represents the leftmost character of string
associated with this line. Note that the zeroeth character may have
been scrolled off the display.N( R R/ ( R+ R. R t regionOffset( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR/ s c C s% x | i D] } | i | q
Wd S( N( R RG ( R+ R R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRG s
N( RI RJ RK R R, R R RH R R R/ RG ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR ` s
c C sO t t d j o. | d t d } t d } t | i | Sd d g Sd S( sB Given a 1-based cell offset, return the braille region
associated with that cell in the form of [region, offsetinregion]
where 'region' is the region associated with the cell and
'offsetinregion' is the 0-based offset of where the cell is
in the region, where 0 represents the beginning of the region.
i i iN( R1 t _linest viewportR R ( t cellR. t lineNum( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getRegionAtCell s
c C s| | i d } t | d \ } } | o< t | t p t | t o | i } | i | } n
d } d } | | g S( sN Gets the accesible and caret offset associated with the given
event. The event should have a BrlAPI event that contains an
argument value that corresponds to a cell on the display.
Arguments:
- event: an instance of input_event.BrailleEvent. event.event is
the dictionary form of the expanded BrlAPI event.
t argumenti iN( t eventR t
isinstanceR\ R RM RO R ( R R. R R RM R` ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getCaretContext s
' c C s g a d a d d g a d S( sg Clears the logical structure, but keeps the Braille display as is
(until a refresh operation).
i N( R R R R ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt clear s c C s
| a d S( N( R ( t lines( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt setLines s c C s t i | t t | _ d S( s/ Adds a line to the logical display for painting. The line is added to
the end of the current list of known lines. It is necessary for the
viewport to be over the lines and for refresh to be called for the new
line to be painted.
Arguments:
- line: an instance of Line to add.
N( R R R1 t _index( R@ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt addLine s
c C s t t d S( sE Returns the Line that is currently being painted on the display.
i ( R R ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt getShowingLine s c
C s | a | p t o d Sd } t } xZ t D]R } x3 | i D]( } | t j o | t d <t } Pq> q> W| o Pq. | d 7} q. Wt t d } | i | \ } } } t i t d j o | t i t d d 7} n t d | t d <d S( s/ Specififes the region with focus. This region will be positioned
at the home position if panToFocus is True.
Arguments:
- region: the given region, which much be in a line that has been
added to the logical display
- panToFocus: whether or not to position the region at the home
position
- getLinkMask: Whether or not we should take the time to get the
attributeMask for links. Reasons we might not want to include
knowning that we will fail and/or it taking an unreasonable
amount of time (AKA Gecko).
Ni i (
R R< R R R RH R R* t _displaySizeRy (
R t
panToFocusR3 R t doneR@ t regR' R. R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt setFocus s*
c
C s d } | d j p> t i t i j p+ | t d j o | t d t d j o nt d t i d } t d t d t i } t d | } t i t i j o: | | j o | | } qb| | j o | | } qbnt i t i j op| | j o t } t d d } xM | | j o? | | d j o
t
} n | o | d 7} Pn | d 8} qWt | | } | t d } n | | j o t } t d t d } xI | t | j o5 | | d j o
t
} n
| o Pn | d 7} qWt t | | } t d | t d t d } n t
| t i j o t i | t
| } qbn | oM t | t d | t d <t t d t | t | t d t d <n d S( s\ Realigns the braille display to account for braille alignment
preferences. By the time this method is called, if there is a
cursor cell to be displayed, it should already be somewhere in
the viewport. All we're going to do is adjust the viewport a
little to align the viewport edge according to the
settings.brailleAlignmentStyle.
Arguments:
- string: the entire string to be presented
- focusOffset: where in string the focused region begins
- cursorOffset: where in the string the cursor should be
Returns: the viewport[0] value is potentially modified.
i i s
N( R t brailleAlignmentStylet ALIGN_BRAILLE_BY_EDGER R t brailleAlignmentMarginRy t ALIGN_BRAILLE_BY_MARGINt ALIGN_BRAILLE_BY_WORDR< RH R1 R? t abst brailleMaximumJump(
R' R R* t jumpt
leftMargint rightMargint leftMostEdget inWordt leftWordEdget
rightWordEdge( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt _realignViewport7 s^
#
c C s t \ } } } } t o/ t t t o t i } t i } t i }
n d } d } d }
| o t d t n t
t d j oy t p t
t t i n t oL y t i d d Wq t i t i d t i t i t q Xn d
a d S| d j o t d | d } n | d j o | o | | j o |
| j o | d j o q| | j o
| } q| | j o t t d | | | } q| | j o t d | | | } qn t t d } | i | \ } }
} d } |
d j o |
t i } n | o | d j o t
| t d j o d t d <q| o t d | | d t d <q| t d j o t d | t d <q| t d t d j o# t d | t d d t d <qn t | |
| t d } | t d } | | a t d j p t t d j o
d a n t d 7a d | } t i t i | t! i" | i# d d
| | | !t f } t i t i | t! i" | i# d | | | !} t p t
t t i n t o
t$ i% } d | _& t
| | _' xG | i' t d j o2 | d 7} | o | d 7} n | i' d 7_' q
W| | _( t | _) | o | | | !| _* n t p t
t t i n t oI y t i+ | Wqt i t i d t i t i t qXqn t i, o] t- p! t. i/ t d a- t- i0 n | o | | | !} n d } t- i t | | n t- o t- i1 d a- n | d j a2 | t
| j a3 t o/ t t t o t i t i t i t f a n d a d S( sd Repaints the Braille on the physical display. This clips the entire
logical structure by the viewport and also sets the cursor to the
appropriate location. [[[TODO: WDW - I'm not sure how BrlTTY handles
drawing to displays with more than one line, so I'm only going to handle
drawing one line right now.]]]
Arguments:
- panToCursor: if True, will adjust the viewport so the cursor is
showing.
- targetCursorCell: Only effective if panToCursor is True.
0 means automatically place the cursor somewhere on the display so
as to minimize movement but show as much of the line as possible.
A positive value is a 1-based target cell from the left side of
the display and a negative value is a 1-based target cell from the
right side of the display.
- getLinkMask: Whether or not we should take the time to get the
attributeMask for links. Reasons we might not want to include
knowning that we will fail and/or it taking an unreasonable
amount of time (AKA Gecko).
- stopFlash: if True, kill any flashed message that may be showing.
i t restoreSavedR s! BrlTTY seems to have disappeared:Ni is BRAILLE LINE: '%s's UTF-8s VISIBLE: '%s', cursor=%dR8 R0 ( Ni i i ( Ni i i (4 t
_lastTextInfoR R R\ RM R` Ra R t killFlashR< R1 R t _brlAPIRunningt initt _callbackR t ttyt _brlAPIt writeTextR RQ t
LEVEL_WARNINGRV t shutdownR R? Ry R R R* R t
cursorCellt
LEVEL_INFOt logt infot encodet brlapit WriteStructt regionBegint
regionSizeR} t cursort attrOrt writet enableBrailleMonitort _monitort brlmont BrlMont show_allt destroyt beginningIsShowingt endIsShowing( t panToCursort targetCursorCellR3 t stopFlasht lastTextObjt lastCaretOffsett lastLineOffsett lastCursorCellt currentTextObjt currentCaretOffsett currentLineOffsetR@ R' R R R* t startPost endPost logLinet substringt writeStructt subMask( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt refresh s %
'
c C s: t o/ t \ a a a } t d t d t d a n t S( NR R i ( t _flashEventSourceIdt _savedR R R R R< ( t flashTime( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt _flashCallback s
c C sc t oX t d j o t i t n | o) t \ a a a } t d t d t n d a n d S( Ni R R ( R t gobjectt
source_removeR R R R R R< ( R R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR s
c C s> t d j o- t i t t d } t i | t a n d S( Ni i ( R R R R t timeout_addR ( R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt resetFlashTimer s
c C s t o( t d j o t i t n d a n t t t | f a | d j o t i | t a n | d j o
d a n d S( s Sets up the state needed to flash a message or clears any existing
flash if nothing is to be flashed.
Arguments:
- flashTime: if non-0, the number of milliseconds to display the
regions before reverting back to what was there before.
A 0 means to not do any flashing. A negative number
means display the message until some other message
comes along or the user presses a cursor routing key.
i ifN( R R R R R R R R R ( R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt
_initFlash s
c C sq t | | d } | d } t t } x | D] } | i | q5 Wt | t | t d t d S( s Displays a list of regions on a single line, setting focus to the
specified region. The regionInfo parameter is something that is
typically returned by a call to braille_generator.generateBraille.
Arguments:
- regionInfo: a list where the first element is a list of regions
to display and the second element is the region
with focus (must be in the list from element 0)
- flashTime: if non-0, the number of milliseconds to display the
regions before reverting back to what was there before.
A 0 means to not do any flashing. A negative number
means display the message until some other message
comes along or the user presses a cursor routing key.
i i R N( R R R R R R R R< ( t
regionInfoR R t
focusedRegionR@ t item( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt displayRegions s
c C sN t | t t | | } t t | t | t t d t d S( sV Displays a single line, setting the cursor to the given position,
ensuring that the cursor is in view.
Arguments:
- message: the string to display
- cursor: the 0-based cursor position, where -1 (default) means no cursor
- flashTime: if non-0, the number of milliseconds to display the
regions before reverting back to what was there before.
A 0 means to not do any flashing. A negative number
means display the message until some other message
comes along or the user presses a cursor routing key.
R N( R R R R R R R RH R< ( t messageR R R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt displayMessage s
c C sc t d } | d j o t d } n t d d j o t d t d | t d <n | t d j S( s Pans the display to the left, limiting the pan to the beginning
of the line being displayed.
Arguments:
- panAmount: the amount to pan. A value of 0 means the entire
width of the physical display.
Returns True if a pan actually happened.
i ( R R Ry ( t panAmountt oldX( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt panLeft s
c C s t d } | d j o t d } n t t d j oV t d } t d | } t | i \ } } } | t | j o | t d <q n | t d j S( s Pans the display to the right, limiting the pan to the length
of the line being displayed.
Arguments:
- panAmount: the amount to pan. A value of 0 means the entire
width of the physical display.
Returns True if a pan actually happened.
i i ( R R R1 R R ( R R R t newXR' R R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt panRight s
c C s x< | t d j o* t i t i d | t p Pq q WxD | t d t d j o* t i t i d | t p PqB qB Wd S( sO Automatically pan left or right to make sure the current offset is
showing.i s braille.panToOffset (left) %ds braille.panToOffset (right) %dN( R R RQ RR R
R R ( R. ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt panToOffset% s
c C s t t t t t S( s Pans the display so the region with focus is displayed.
Arguments:
- inputEvent: the InputEvent instance that caused this to be called.
Returns True to mean the command should be consumed.
( R R R RH ( t
inputEvent( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt returnToRegionWithFocus5 s
c C sI | i d t i @d j t _ x t D] } | i t i q$ Wt d S( s Turns contracted braille on or off based upon the event.
Arguments:
- event: an instance of input_event.BrailleEvent. event.event is
the dictionary form of the expanded BrlAPI event.
t flagsi N( R R t KEY_FLG_TOGGLE_ONR R R RG R ( R R@ ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyRG C s
c C sd t o t d S| i d } t t d j o- | t d } t d } t | i | n t S( s Processes a cursor routing key event.
Arguments:
- event: an instance of input_event.BrailleEvent. event.event is
the dictionary form of the expanded BrlAPI event.
NR i i ( R R R R1 R R R/ RH ( R R R R ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR/ Q s
c C s t t i | t } t i o: t i d j o* t i t i t i t i t i n t
oG y t
| } Wq t i t i d t i
t i t } q Xn t i o! t i d j o t i d n | S( s Handles BrlTTY command events. This passes commands on to Orca for
processing.
Arguments:
- event: the BrlAPI input event (expanded)
i s Issue processing event:( R R t
LEVEL_FINER< R t timeoutCallbackt timeoutTimet signalt SIGALRMt alarmR RQ R RV ( R t consumed( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt _processBrailleEventh s c C sj y t i t } Wn2 t i t i d t i t i t d SX| o t t i | n t
S( s\ Method to read a key from the BrlAPI bindings. This is a
gobject IO watch handler.
s! BrlTTY seems to have disappeared:N( R t readKeyR< R RQ R RV R R t
expandKeyCodeR ( t sourcet conditiont key( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt _brlAPIKeyReader s c C s t p t t t i n t p d St i t i d g t i t i
Bg } x" | D] } | i t i | B qW Wt i t i
| d S( s Hacky method to tell BrlTTY what to send and not send us via
the readKey method. This only works with BrlTTY v3.8 and better.
Arguments:
-keys: a list of BrlAPI commands.
Ni ( R R R R R R t
ignoreKeysR t
rangeType_allt KEY_TYPE_CMDt
KEY_CMD_ROUTER t
acceptKeyst rangeType_command( t keyst keySetR ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt setupKeyRanges s i c C s` t o t St i p t S| a y t i a y< t i
d } t i t a t i
t i d d | Wn1 t i | t a t i
t i d | n Xt i t i t i t a Wn1 t i
t i d t i t i t a t SXt i \ } } | d g a t o t i d a n t i
t i d t d t d f t t t t S(
s" Initializes the braille module, connecting to the BrlTTY driver.
Arguments:
- callback: the method to call with a BrlTTY input event.
- tty: the tty port to take ownership of (default = 7)
Returns False if BrlTTY cannot be accessed or braille has
not been enabled.
t
WINDOWPATHs5 Braille module has been initialized using WINDOWPATH=s %ss0 Braille module has been initialized using tty=%ds Could not initialize BrlTTY:i s braille display size = (%d, %d)i N( R RH R t
enableBrailleR< R R t
ConnectionR R t environt enterTtyModeWithPathR RQ t LEVEL_CONFIGURATIONt enterTtyModeR t io_add_watcht fileDescriptort IO_INR t _brlAPISourceIdRV t displaySizeR R R R R R ( t callbackR t
windowPatht xt y( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR sR
c C sk t o\ t a t i t d a y t i Wn n Xt o t i d a n t
d g a n t St S( sY Shuts down the braille module. Returns True if the shutdown procedure
was run.
i i N(
R R< R R R3 R t leaveTtyModeR R R t DEFAULT_DISPLAY_SIZER RH ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyR s
( Ni i i ( ( (a RK t __id__t __version__t __date__t
__copyright__t __license__t loggingt getLoggerR R R R t threads_initR t ImportErrorR R R RH t _brlAPIAvailableR< R R3 R R RS R] R t platformR t orca_i18nR R t dontInteruptSpeechKeyst KEY_CMD_FWINLTt KEY_CMD_FWINRTt KEY_CMD_LNUPt KEY_CMD_LNDNt command_namet KEY_CMD_FREEZEt KEY_CMD_TOP_LEFTt KEY_CMD_BOT_LEFTt KEY_CMD_HOMEt KEY_CMD_SIXDOTSR# t KEY_CMD_CUTBEGINt KEY_CMD_CUTLINER: R R R R R R R R R R R R R R R$ R R RL RY R\ R R R R R R R R R R R R R R R R R R R
R R
R RG R/ R R R( R R ( ( ( s0 /usr/lib/python2.6/site-packages/orca/braille.pyt <module> s
> ,[
5 x
J