/usr/lib64/python2.6/site-packages/matplotlib
Edit: /usr/lib64/python2.6/site-packages/matplotlib/text.pyc (59240B)
Jc @ s d Z d d k l Z d d k Z d d k Z d d k l Z d d k l Z d d k i
Z
d d k l Z d d k l
Z
l Z d d k l Z d d k l Z l Z l Z l Z l Z d d k i Z d d
k l Z l Z d d k l Z d d k i Z e d Z! d
Z" d e
i# d
Z= d? Z> d@ Z? dA Z@ dB ZA dC ZB dD ZC dE ZD dF ZE dG ZF dH ZG dI ZH dJ ZI dK ZJ RS(M sK
Handle storing and drawing of text in window or data coordinates.
i c C s d | i | i t | i f S( Ns Text(%g,%g,%s)( t _yt reprt _text( t self( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt __str__ s i t t bottomt leftc
K s! t i | t d | _ | | | _ | _ | d j o t d } n | d j o
t } n t | o t | } n | i
| | i | | | _ | | _
| | _ | | _ | | _ d | _ d | _ d | _ |
d j o
d }
n |
| _ | i | | i | d S( s
Create a :class:`~matplotlib.text.Text` instance at *x*, *y*
with string *text*.
Valid kwargs are
%(Text)s
i s
text.colorg333333?N( R t __init__R t cachedt _xR< R R R R t set_textt set_colort _verticalalignmentt _horizontalalignmentt _multialignmentt _rotationt _fontpropertiest _bboxt _bbox_patcht _renderert _linespacingt set_rotation_modeR (
R? R- R. R% t colort verticalalignmentt horizontalalignmentt multialignmentt fontpropertiesR t linespacingt
rotation_modeR ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRD s0
c C s t | i o | i | | S| i p | i d j o t h f S| i i \ } } } } | | } | | } | | f | | f | | f | | f f } | i | i } }
t
i | |
| } | h f S( s Test whether the mouse event occurred in the patch.
In the case of text, a hit is true anywhere in the
axis-aligned bounding-box containing the text.
Returns True or False.
N( t callablet _containst get_visibleRP R t Falset get_window_extentt boundsR- R. t nxutilst pnpoly( R? t
mouseeventt lt bR/ R0 t rR+ t xyvertsR- R. t inside( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt contains s
*c C s+ | i \ } } | i i | | f S( sD get the (possibly unit converted) transformed x, y in display coords( t get_positiont
get_transformR! ( R? R- R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt _get_xy_display s c C s# | i d j o | i S| i Sd S( N( RK R RJ ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt _get_multialignment s c C s
t | i S( s) return the text angle as float in degrees( R RL ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s c C sA | d j p
| d j o
| | _ n t d t | d S( s1
set text rotation mode. If "anchor", the un-rotated text
will first aligned according to their *ha* and
*va*, and then will be rotated with the alignement
reference point as a origin. If None (default), the text will be
rotated first then will be aligned.
t anchort defaults Unknown rotation_mode : %sN( Rm s default( R t _rotation_modet
ValueErrorR= ( R? t m( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRR s
c C s | i S( s get text rotation mode( Ro ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_rotation_mode s c C sz t i | | | i | _ | i | _ | i | _ | i | _ | i i | _ | i | _ | i | _ | i
| _
d S( s" Copy properties from other to selfN( R t update_fromt _colorRK RI RJ RM t copyRL t _pickerRQ ( R? t other( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRs s c / C s | i } | | i j o | i | Sg } d \ } } d \ } } d \ } } | i i d }
t i t |
d f } t i t |
d f } | i d | i d t \ } }
} |
| i
} d } x t |
D] \ } } | i
| \ } } | i | | i d | \ } } } | d j o | | } n | | f | | s c C s | i S( s alias for get_fontproperties( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_font_propertiesB s c C s
| i i S( s5 Return the list of font families used for font lookup( RM t
get_family( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR F s c C s
| i S( s alias for get_family( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_fontfamilyJ s c C s
| i i S( s Return the font name as string( RM t get_name( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR N s c C s
| i i S( s Return the font style as string( RM t get_style( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR R s c C s
| i i S( s Return the font size as integer( RM t get_size_in_points( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR V s c C s
| i i S( s# Return the font variant as a string( RM t get_variant( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR Z s c C s
| i S( s alias for get_variant( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_fontvariant^ s c C s
| i i S( s' Get the font weight as string or number( RM t
get_weight( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR b s c C s
| i S( s alias for get_name( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_fontnamef s c C s
| i S( s alias for get_style( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt
get_fontstylej s c C s
| i S( s alias for get_size( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_fontsizen s c C s
| i S( s alias for get_weight( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_fontweightr s c C s
| i i S( s* Get the font stretch as a string or number( RM t get_stretch( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR v s c C s
| i S( s alias for get_stretch( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_fontstretchz s c C s
| i S( s! alias for get_horizontalalignment( t get_horizontalalignment( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_ha~ s c C s | i S( sq
Return the horizontal alignment as string. Will be one of
'left', 'center' or 'right'.
( RJ ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s c C s: t | i | i } t | i | i } | | f S( s5 Return the position of the text as a tuple (*x*, *y*)( R R RF R R< ( R? R- R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRi s c C s^ | i \ } } | | | i | i | i | i t | i | i | i i t
| i f
S( s
Return a hashable tuple of properties.
Not intended to be human readable, but useful for backends who
want to cache derived information about text (eg layouts) and
need to know if the text has changed.
( Ri R Rt RI RJ t hashRM RL t figuret dpit idRP ( R? R- R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR~ s
c C s | i S( s Get the text as string( R> ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s c C s
| i S( s& alias for :meth:`getverticalalignment`( t get_verticalalignment( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_va s c C s | i S( s{
Return the vertical alignment as string. Will be one of
'top', 'center', 'bottom' or 'baseline'.
( RI ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s c
C s5 | i p t i S| d j o | i i } | | i _ n | i d j o) | i \ } } t i | | d d S| d j o
| | _ n | i d j o t
d n | i | i \ } } | i \ } } | i
i | | f \ } } | i | | } | d j o | | i _ n | S( so
Return a :class:`~matplotlib.transforms.Bbox` object bounding
the text, in display units.
In addition to being used internally, this is useful for
specifying clickable regions in a png file on a web page.
*renderer* defaults to the _renderer attribute of the text
object. This is not assigned until the first execution of
:meth:`draw`, so you must use this kwarg if you want
to call :meth:`get_window_extent` prior to the first
:meth:`draw`. For getting web page regions, it is
simpler to call the method after saving the figure.
*dpi* defaults to self.figure.dpi; the renderer dpi is
irrelevant. For the web application, if figure.dpi is not
the value used when saving the figure, then the value that
was used must be specified as the *dpi* argument.
RA i s% Cannot get window extent w/o rendererN( R\ R
t unitR R R R Rk R RP t RuntimeErrorR Ri Rj R! t
translated(
R? R& R t dpi_origt txt tyR R R- R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR^ s&
!
c C sI | i d j o t d | d | | _ n | i i t d | d S( s
Set the background color of the text by updating the bbox.
.. seealso::
:meth:`set_bbox`
To change the position of the bounding box.
ACCEPTS: any matplotlib color
t facecolort edgecolorN( RN R t dictR ( R? RS ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_backgroundcolor s c C s= y t | Wn t j
o t | } n X| | _ d S( s]
Set the foreground color of the text
ACCEPTS: any matplotlib color
N( R t TypeErrort tupleRt ( R? RS ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRH s
c C s | i | d S( s! alias for set_horizontalalignmentN( t set_horizontalalignment( R? t align( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_ha s c C s: d } | | j o t d t | n | | _ d S( sj
Set the horizontal alignment to one of
ACCEPTS: [ 'center' | 'right' | 'left' ]
Rz R{ RC s& Horizontal alignment must be one of %sN( s centers rightRC ( Rp t strRJ ( R? R
t legal( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s
c C s | i | d S( s alias for set_verticalalignmentN( t set_multialignment( R? R
( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_ma s c C s: d } | | j o t d t | n | | _ d S( s1
Set the alignment for multiple lines layout. The layout of the
bounding box of all the lines is determined bu the horizontalalignment
and verticalalignment properties, but the multiline text within that
box can be
ACCEPTS: ['left' | 'right' | 'center' ]
Rz R{ RC s& Horizontal alignment must be one of %sN( s centers rights left( Rp R RK ( R? R
R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s
c C s
| | _ d S( s
Set the line spacing as a multiple of the font size.
Default is 1.2.
ACCEPTS: float (multiple of font size)
N( RQ ( R? t spacing( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_linespacing s c C s | i i | d S( s
Set the font family. May be either a single string, or a list
of strings in decreasing priority. Each string may be either
a real font name or a generic font class name. If the latter,
the specific font names will be looked up in the
:file:`matplotlibrc` file.
ACCEPTS: [ FONTNAME | 'serif' | 'sans-serif' | 'cursive' | 'fantasy' | 'monospace' ]
N( RM t
set_family( R? t fontname( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR " s
c C s | i i | d S( sv
Set the font variant, either 'normal' or 'small-caps'.
ACCEPTS: [ 'normal' | 'small-caps' ]
N( RM t set_variant( R? t variant( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR . s c C s
| i | S( s alias for set_variant( R ( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_fontvariant6 s c C s
| i | S( s alias for set_family( R ( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_name: s c C s | i | d S( s alias for set_familyN( R ( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_fontname> s c C s | i i | d S( sZ
Set the font style.
ACCEPTS: [ 'normal' | 'italic' | 'oblique']
N( RM t set_style( R? t fontstyle( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR B s c C s
| i | S( s alias for set_style( R ( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt
set_fontstyleJ s c C s | i i | d S( s
Set the font size. May be either a size string, relative to
the default font size, or an absolute font size in points.
ACCEPTS: [ size in points | 'xx-small' | 'x-small' | 'small' | 'medium' | 'large' | 'x-large' | 'xx-large' ]
N( RM t set_size( R? t fontsize( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR N s c C s
| i | S( s alias for set_size( R ( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_fontsizeW s c C s | i i | d S( s
Set the font weight.
ACCEPTS: [ a numeric value in range 0-1000 | 'ultralight' | 'light' | 'normal' | 'regular' | 'book' | 'medium' | 'roman' | 'semibold' | 'demibold' | 'demi' | 'bold' | 'heavy' | 'extra bold' | 'black' ]
N( RM t
set_weight( R? t weight( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR" [ s c C s
| i | S( s alias for set_weight( R" ( R? R# ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_fontweightc s c C s | i i | d S( s
Set the font stretch (horizontal condensation or expansion).
ACCEPTS: [ a numeric value in range 0-1000 | 'ultra-condensed' | 'extra-condensed' | 'condensed' | 'semi-condensed' | 'normal' | 'semi-expanded' | 'expanded' | 'extra-expanded' | 'ultra-expanded' ]
N( RM t set_stretch( R? t stretch( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR% g s c C s
| i | S( s alias for set_stretch( R% ( R? R& ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_fontstretcho s c C s& | i | d | i | d d S( sQ
Set the (*x*, *y*) position of the text
ACCEPTS: (x,y)
i i N( t set_xt set_y( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_positions s c C s
| | _ d S( sJ
Set the *x* position of the text
ACCEPTS: float
N( RF ( R? R- ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR( | s c C s
| | _ d S( sJ
Set the *y* position of the text
ACCEPTS: float
N( R< ( R? R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR) s c C s
| | _ d S( sq
Set the rotation of the text
ACCEPTS: [ angle in degrees | 'vertical' | 'horizontal' ]
N( RL ( R? t s( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_rotation s c C s | i | d S( s alias for set_verticalalignmentN( t set_verticalalignment( R? R
( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_va s c C s: d } | | j o t d t | n | | _ d S( sk
Set the vertical alignment
ACCEPTS: [ 'center' | 'top' | 'bottom' | 'baseline' ]
R| RB Rz R} s$ Vertical alignment must be one of %sN( s topRB s centers baseline( Rp R RI ( R? R
R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR- s
c C s d | f | _ d S( s
Set the text string *s*
It may contain newlines (``\n``) or math in LaTeX syntax.
ACCEPTS: string or anything printable with '%s' conversion.
s %sN( R> ( R? R+ ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRG s c C s{ | i d | i d } | d j o | d d j } t d o | d f S| o | t f S| i d d t f Sd S( sM
Returns True if the given string *s* contains any mathtext.
t $s \$i i s text.usetext TeXN( t countR t Truet replaceR] ( R? R+ t dollar_countt even_dollars( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s c C s0 t | o t | } n | i | _ d S( s
Set the font properties that control the text. *fp* must be a
:class:`matplotlib.font_manager.FontProperties` object.
ACCEPTS: a :class:`matplotlib.font_manager.FontProperties` instance
N( R R Ru RM ( R? t fp( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_fontproperties s
c C s | i | d S( s alias for set_fontpropertiesN( R7 ( R? R6 ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_font_properties s N(K t __name__t
__module__t __doc__t zorderR@ R RD Rh Rk Rl R RR Rr Rs R R R R R R R R R R R R R R R R R R R R R R R R R Ri R~ R R R R^ R RH R 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 R7 R8 ( ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s $
$ < B *
t TextWithDashc B s e Z d Z d Z d Z d d d d d d d d d d d d d d d d Z d Z d
Z d Z d Z d d
Z
d Z d Z d Z
d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z d Z RS( s_
This is basically a :class:`~matplotlib.text.Text` with a dash
(drawn with a :class:`~matplotlib.lines.Line2D`) before/after
it. It is intended to be a drop-in replacement for
:class:`~matplotlib.text.Text`, and should behave identically to
it when *dashlength* = 0.0.
The dash always comes between the point specified by
:meth:`~matplotlib.text.Text.set_position` and the text. When a
dash exists, the text alignment arguments (*horizontalalignment*,
*verticalalignment*) are ignored.
*dashlength* is the length of the dash in canvas units.
(default = 0.0).
*dashdirection* is one of 0 or 1, where 0 draws the dash after the
text and 1 before. (default = 0).
*dashrotation* specifies the rotation of the dash, and should
generally stay *None*. In this case
:meth:`~matplotlib.text.TextWithDash.get_dashrotation` returns
:meth:`~matplotlib.text.Text.get_rotation`. (I.e., the dash takes
its rotation from the text's rotation). Because the text center is
projected onto the dash, major deviations in the rotation cause
what may be considered visually unappealing results.
(default = *None*)
*dashpad* is a padding length to add (or subtract) space
between the text and the dash, in canvas units.
(default = 3)
*dashpush* "pushes" the dash and text away from the point
specified by :meth:`~matplotlib.text.Text.set_position` by the
amount in canvas units. (default = 0)
.. note::
The alignment of the two objects is based on the bounding box
of the :class:`~matplotlib.text.Text`, as obtained by
:meth:`~matplotlib.artist.Artist.get_window_extent`. This, in
turn, appears to depend on the font metrics as given by the
rendering backend. Hence the quality of the "centering" of the
label text with respect to the dash varies depending on the
backend used.
.. note::
I'm not sure that I got the
:meth:`~matplotlib.text.TextWithDash.get_window_extent` right,
or whether that's sufficient for providing the object bounding
box.
t textwithdashc C s d | i | i t | i f S( Ns TextWithDash(%g,%g,%s)( RF R< R= R> ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR@ s i RA Rz g i c C s t i | d | d | d | d | d | d | d | d | d | d
|
t d | | f d | | f d d
d d | _ t | | _ t | | _ | | _ | | _ |
| _ | | _
| | _ d S( NR- R. R% RS RT RU RV RW R RX t xdatat ydatat kt linestylet -( R RD R t dashlineR t _dashxt _dashyt _dashlengtht _dashdirectiont
_dashrotationt _dashpadt _dashpush( R? R- R. R% RS RT RU RV RW R RX t
dashlengtht
dashdirectiont dashrotationt dashpadt dashpush( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRD
s$ $ c C s: t | i | i } t | i | i } | | f S( s5 Return the position of the text as a tuple (*x*, *y*)( R R RE R RF ( R? R- R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRi 8 s c
C sk g } t i | D]
} | | q ~ } | i | i | i | i | i | i | i | i g t
| S( s
Return a hashable tuple of properties.
Not intended to be human readable, but useful for backends who
want to cache derived information about text (eg layouts) and
need to know if the text has changed.
( R R~ R" RF R< RG RH RI RJ RK R ( R? t _[1]t pR ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR~ > s *7c C sH | i | t i | | | i d j o | i i | n d S( sP
Draw the :class:`TextWithDash` object to the given *renderer*.
g N( t
update_coordsR R t get_dashlengthRD ( R? R& ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR J s
c ! C s | i \ } } | i } | d j o | | | _ | _ d S| i } | i } | i } | i } t | } t i
| d | d }
t i |
t i |
} } | i
}
|
i | | f } t i | | g } | | | } | | | | } |
i } | i t | \ } } | i t | \ } } | i i | | f | | f t i | d | } | i | i } } | d j o | } d } ng | d j o d } | } nJ | | } | } | | } | | j p | | j o | } | | } n t i | | g d } | d | t i t i | | 9} | | d d | } | i t | \ } } | | | _ | _ t i | d | } | i | _ | i i t i | g t t i | d t i | d d S( s
Computes the actual *x*, *y* coordinates for text based on the
input *x*, *y* and the *dashlength*. Since the rotation is
with respect to the actual canvas's coordinates we need to map
back and forth.
g Ng f@i R& i Rz ( Ri RT RF R< t get_dashrotationt get_dashdirectiont get_dashpadt get_dashpushR R R t cost sinRj R! R t invertedR RD t set_dataR R^ R R t sqrtt dott frozent _twd_window_extentt update_from_data_xyR] R R- (! R? R& t dashxt dashyRL RN RM RO RP R R) t cos_thetat sin_thetaR t cxyt cdt c1t c2t inverset x1t y1t x2t y2t weR/ R0 t dxt dyt tan_thetat cwdt cwt newxt newy( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRS S sZ
' c C s? | i | | i d j o t i | d | S| i Sd S( so
Return a :class:`~matplotlib.transforms.Bbox` object bounding
the text, in display units.
In addition to being used internally, this is useful for
specifying clickable regions in a png file on a web page.
*renderer* defaults to the _renderer attribute of the text
object. This is not assigned until the first execution of
:meth:`draw`, so you must use this kwarg if you want
to call :meth:`get_window_extent` prior to the first
:meth:`draw`. For getting web page regions, it is
simpler to call the method after saving the figure.
g R& N( RS RT R R^ R` ( R? R& ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR^ s
c C s | i S( s-
Get the length of the dash.
( RG ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRT s c C s
| | _ d S( sT
Set the length of the dash.
ACCEPTS: float (canvas units)
N( RG ( R? t dl( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_dashlength s c C s | i S( sO
Get the direction dash. 1 is before the text and 0 is after.
( RH ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRV s c C s
| | _ d S( s
Set the direction of the dash following the text.
1 is before the text and 0 is after. The default
is 0, which is what you'd want for the typical
case of ticks below and on the left of the figure.
ACCEPTS: int (1 is before, 0 is after)
N( RH ( R? t dd( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_dashdirection s c C s& | i d j o | i S| i Sd S( s:
Get the rotation of the dash in degrees.
N( RI R R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRU s c C s
| | _ d S( s\
Set the rotation of the dash, in degrees
ACCEPTS: float (degrees)
N( RI ( R? t dr( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_dashrotation s c C s | i S( sW
Get the extra spacing between the dash and the text, in canvas units.
( RJ ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRW s c C s
| | _ d S( s
Set the "pad" of the TextWithDash, which is the extra spacing
between the dash and the text, in canvas units.
ACCEPTS: float (canvas units)
N( RJ ( R? t dp( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_dashpad s c C s | i S( sr
Get the extra spacing between the dash and the specified text
position, in canvas units.
( RK ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRX s c C s
| | _ d S( s
Set the "push" of the TextWithDash, which
is the extra spacing between the beginning
of the dash and the specified position.
ACCEPTS: float (canvas units)
N( RK ( R? R} ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_dashpush s c C s& | i | d | i | d d S( sd
Set the (*x*, *y*) position of the :class:`TextWithDash`.
ACCEPTS: (x, y)
i i N( R( R) ( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR*
s c C s t | | _ d S( s\
Set the *x* position of the :class:`TextWithDash`.
ACCEPTS: float
N( R RE ( R? R- ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR( s c C s t | | _ d S( s\
Set the *y* position of the :class:`TextWithDash`.
ACCEPTS: float
N( R RF ( R? R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR) s c C s$ t i | | | i i | d S( s
Set the :class:`matplotlib.transforms.Transform` instance used
by this artist.
ACCEPTS: a :class:`matplotlib.transforms.Transform` instance
N( R R RD ( R? R+ ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR & s c C s | i S( s0 return the figure instance the artist belongs to( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt
get_figure0 s c C s$ t i | | | i i | d S( s~
Set the figure instance the artist belong to.
ACCEPTS: a :class:`matplotlib.figure.Figure` instance
N( R t
set_figureRD ( R? t fig( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR 4 s N( R9 R: R; R@ R RD Ri R~ R RS R^ RT Rx RV Rz RU R| RW R~ RX R R* R( R) R R R ( ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR= sJ 2 T
t
Annotationc B s e Z d Z d Z d d d d d Z e i e i e i e _ d Z
d Z d Z d Z
d Z d Z d
Z d Z d Z d
Z RS( s
A :class:`~matplotlib.text.Text` class to make annotating things
in the figure, such as :class:`~matplotlib.figure.Figure`,
:class:`~matplotlib.axes.Axes`,
:class:`~matplotlib.patches.Rectangle`, etc., easier.
c C s( d | i d | i d t | i f S( Ns Annotation(%g,%g,%s)i i ( R R= R> ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR@ F s t datac
K s | d j o
| } n | d j o
| } n | \ } } | _ t i | | | | | | | _ | | _ | | _ | | _ d | _ | o> | i d o. | i
d d | _ t d d | | _
n
d | _
d | _ d S(
s
Annotate the *x*, *y* point *xy* with text *s* at *x*, *y*
location *xytext*. (If *xytext* = *None*, defaults to *xy*,
and if *textcoords* = *None*, defaults to *xycoords*).
*arrowprops*, if not *None*, is a dictionary of line properties
(see :class:`matplotlib.lines.Line2D`) for the arrow that connects
annotation to the point.
If the dictionary has a key *arrowstyle*, a FancyArrowPatch
instance is created with the given dictionary and is
drawn. Otherwise, a YAArow patch instance is created and
drawn. Valid keys for YAArow are
========= =============================================================
Key Description
========= =============================================================
width the width of the arrow in points
frac the fraction of the arrow length occupied by the head
headwidth the width of the base of the arrow head in points
shrink oftentimes it is convenient to have the arrowtip
and base a bit away from the text and point being
annotated. If *d* is the distance between the text and
annotated point, shrink will shorten the arrow so the tip
and base are shink percent of the distance *d* away from the
endpoints. ie, ``shrink=0.05 is 5%%``
? any key for :class:`matplotlib.patches.polygon`
========= =============================================================
Valid keys for FancyArrowPatch are
=============== ======================================================
Key Description
=============== ======================================================
arrowstyle the arrow style
connectionstyle the connection style
relpos default is (0.5, 0.5)
patchA default is bounding box of the text
patchB default is None
shrinkA default is 2 points
shrinkB default is 2 points
mutation_scale default is text size (in points)
mutation_aspect default is 1.
? any key for :class:`matplotlib.patches.PathPatch`
=============== ======================================================
*xycoords* and *textcoords* are strings that indicate the
coordinates of *xy* and *xytext*.
================= ===================================================
Property Description
================= ===================================================
'figure points' points from the lower left corner of the figure
'figure pixels' pixels from the lower left corner of the figure
'figure fraction' 0,0 is lower left of figure and 1,1 is upper, right
'axes points' points from lower left corner of axes
'axes pixels' pixels from lower left corner of axes
'axes fraction' 0,1 is lower left of axes and 1,1 is upper right
'data' use the coordinate system of the object being
annotated (default)
'offset points' Specify an offset (in points) from the *xy* value
'polar' you can specify *theta*, *r* for the annotation,
even in cartesian plots. Note that if you
are using a polar axes, you do not need
to specify polar for the coordinate
system since that is the native "data" coordinate
system.
================= ===================================================
If a 'points' or 'pixels' option is specified, values will be
added to the bottom-left and if negative, values will be
subtracted from the top-right. Eg::
# 10 points to the right of the left border of the axes and
# 5 points below the top border
xy=(10,-5), xycoords='axes points'
Additional kwargs are Text properties:
%(Text)s
t
arrowstylet relposg ?i i N( g ?g ?( i i ( i i ( R t xytextR RD R t xycoordst
textcoordst
arrowpropst arrowt has_keyR t
_arrow_relposR
R t _annotation_clip(
R? R+ R R R R R R R- R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRD H s" ]
c C s[ t i | | \ } } | i d j o) | i i | \ } } | p | } n | | f S( N( R Rh R R ( R? t eventR+ t tinfot at ainfo( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyRh s
c C s\ | i d j o | i i | n | i d j o | i i | n t i | | d S( N( R R R R R ( R? R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s
c C s- | d j oJ | i i } t | i | } t | i | } | i | | f S| d j o | i \ } } | i d j o | i | | d S| i | | | i \ } } | i i
} | | d 9} | | d 9} | | 7} | | 7} | | f S| d j oS | | } } | t i | } | t i
| } | i i } | i | | f S| d j o | i i } | i i i \ }
} } }
|
| } | |
} | | d 9} | | d 9} | d j o | | } n | d j o | | } n | | f S| d j op | i i i \ }
} } }
|
| } | |
} | d j o | | } n | d j o | | } n | | f S| d j o | i i } | i | | f S| d j o | i i } | i i i \ }
} } }
|
| } | |
} | d j o | | | d } n |
| | d } | d j o | | | d } n | | | d } | | f S| d
j o | i i i \ }
} } }
|
| } | |
} | d j o | | } n |
| } | d j o | | } n | | } | | f S| d j o | i i } | i | | f Sd S( NR s
offset pointsg R@t polars
figure pointsi s
figure pixelss figure fractions axes pointss axes pixelss
axes fraction( t axest transDataR R R R! R R t _get_xyR t get_dpiR RY RZ R R R_ t transFiguret transAxes( R? R- R. R+ R Rp Rq R R) Re Rc Rd R/ R0 R+ ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s
c C s
| | _ d S( s)
set *annotation_clip* attribute.
* True : the annotation will only be drawn when self.xy is inside the axes.
* False : the annotation will always be drawn regardless of its position.
* None : the self.xy will be checked only if *xycoords* is "data"
N( R ( R? Rd ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt set_annotation_clip3 s c C s | i S( s
Return *annotation_clip* attribute.
See :meth:`set_annotation_clip` for the meaning of return values.
( R ( R? ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt get_annotation_clip= s c C s# | i | } | i | | d S( s? Update the pixel positions of the annotated point and the text.N( t _get_position_xyt _update_position_xytext( R? R& t xy_pixel( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt update_positionsE s c C s% | i \ } } | i | | | i S( s5 Return the pixel position of the the annotated point.( R R R ( R? R& R- R. ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR K s c $ C s | i \ } } | i | | | i \ | _ | _ | \ } } | i | i } } | | } } | i o,| | } }
| i | i \ } } }
} | |
} | | } d | | } d | | } | i i } | i o | i
} | i | } | i | i | d } | i
| i | d } | i i | | f | | f | i d | i } | i | } | i i | | i o) | i d | i } | i i | q| i d | i } | i i | qg } | | | f D] } | t | | | f q~ } | i | d \ } } g } | | | f D] } | t | |
| f q?~ } | i | d \ } } | i d d } t i | |
| | } t i | |
d | | d } | | t i | } | | t i | } | i d d
}! | i d d }" | i d
d }# t | i | | |
| f | | | | f d |! d |" d
|# | | _ | i i! | i" n d S( sF Update the pixel positions of the annotation text and the arrow patch.g ?i i t mutation_scalet patchAt shrinkg g @R i t headwidthi t fracg?N(# R R R RF R< R R^ R_ Ru R R t x0R t y0R t
set_positionsR R R R RO R RN t abst sortR t atan2R] RY RZ R R R t set_clip_boxt get_clip_box($ R? R& R R- R. t ox0t oy0t ox1t oy1R R Rc Rd R/ R0 Re R+ t xct ycR R R R R RQ t valt dsut _t _[2]R R) Rp Rq R R R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR Q sZ $
:
:
#. c C sP | i } | p | d j o, | i d j o | i i | p t Sn t S( sb
given the xy pixel coordinate, check if the annotation need to
be drawn.
R N( R R R R t contains_pointR] R2 ( R? R& R Rd ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt _check_xy s
$ c C s8 | d j o
| | _ n | i p d S| i | } | i | | p d S| i | | | i | | i d j oJ | i i d j o# | i d j o | i | i _ n | i i | n | i
d j oJ | i
i d j o# | i d j o | i | i
_ n | i
i | n t i | | d S( sN
Draw the :class:`Annotation` object to the given *renderer*.
N( R RP R\ R R R R R R R R R ( R? R& R ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR s$
##N( R9 R: R; R@ R RD R t dedentt artistt kwdocdRh R R R R R R R R R ( ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyR ? s" s _
T (, R; t
__future__R R t numpyR t
matplotlibR R t matplotlib.artistR R t matplotlib.cbookR R t matplotlib.font_managerR t matplotlib.patchesR R R R
R t matplotlib.transformst
transformsR R R
t matplotlib.linesR t matplotlib.nxutilsR` R R R R R; R t kwdocR RD t im_funcR= R ( ( ( s5 /usr/lib64/python2.6/site-packages/matplotlib/text.pyt s< (
4
# R% h