File: //opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyo
�
�)�Uc @ s� d Z d d l m Z d d l Z d d l Z d d l m Z d d l m Z d d l j
Z
d d l m Z d d l m
Z
m Z d d l m Z d d l m Z d d
l m Z m Z m Z m Z m Z d d l j Z d d l m Z m Z m Z m Z m Z d d l m! Z! d d
l m" Z" d d l# j$ Z$ d d l% m& Z& d d l j' Z' d d l( m) Z) d d l* m+ Z+ e, d � Z- d � Z. e j/ j0 d d � d � Z1 d e f d � � YZ2 e j/ j0 d e
j3 e2 � � e j4 e2 j5 j6 � d e2 f d � � YZ7 e j/ j0 d e
j3 e7 � � d e8 f d � � YZ9 d e8 f d � � YZ: d e2 e: f d � � YZ; e j/ j0 d e; j5 j � d d l< m= Z= d S( s)
Classes for including text in a figure.
i����( t divisionN( t cbook( t rcParams( t Artist( t is_string_liket maxdict( t docstring( t FontProperties( t bbox_artistt YAArrowt FancyBboxPatcht FancyArrowPatcht Rectangle( t Affine2Dt Bboxt Transformt BboxBaset BboxTransformTo( t Line2D( t allow_rasterization( t Path( t FT2Font( t RendererBasec K s- | d k r | j | � n | j | � | S( sE Return an override dict. See :func:`~pyplot.text' docstring for infoN( t Nonet update( t overridet fontdictt kwargs( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt _process_text_args! s
c C s> | d k r d } n! | d k r* d } n t | � } | d S( sy
Return the text angle as float.
*rotation* may be 'horizontal', 'vertical', or a numeric value in degrees.
t
horizontalg t verticalg �V@ih N( R N( R t float( t rotationt angle( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_rotation+ s t Textsu
========================== =========================================================================
Property Value
========================== =========================================================================
alpha float or None
animated [True | False]
backgroundcolor any matplotlib color
bbox rectangle prop dict plus key 'pad' which is a pad in points
clip_box a matplotlib.transform.Bbox instance
clip_on [True | False]
color any matplotlib color
family [ 'serif' | 'sans-serif' | 'cursive' | 'fantasy' | 'monospace' ]
figure a matplotlib.figure.Figure instance
fontproperties a matplotlib.font_manager.FontProperties instance
horizontalalignment or ha [ 'center' | 'right' | 'left' ]
label any string
linespacing float
lod [True | False]
multialignment ['left' | 'right' | 'center' ]
name or fontname string eg, ['Sans' | 'Courier' | 'Helvetica' ...]
position (x,y)
rotation [ angle in degrees 'vertical' | 'horizontal'
rotation_mode [ None | 'anchor']
size or fontsize [ size in points | relative size eg 'smaller', 'x-large' ]
style or fontstyle [ 'normal' | 'italic' | 'oblique']
text string
transform a matplotlib.transform transformation instance
variant [ 'normal' | 'small-caps' ]
verticalalignment or va [ 'center' | 'top' | 'bottom' | 'baseline' ]
visible [True | False]
weight or fontweight [ 'normal' | 'bold' | 'heavy' | 'light' | 'ultrabold' | 'ultralight']
x float
y float
zorder any number
========================== =========================================================================
c C s? g } g } | j � d t j } t j � j | � } x� | j | � d D]t \ } } } } | \ }
} | j | | f � \ } }
| |
|
| } } | j | | g � | j |
| g � qM Wt | � t | � } } t
| � | t
| � | } } t j � j | � } | j | | f � \ } } | | | | f S( s�
Calculate the bounding box of the text. Unlike
:meth:`matplotlib.text.Text.get_extents` method, The bbox size of
the text before the rotation is calculated.
g �f@i ( R" t matht pit mtransformsR
t rotatet _get_layoutt transform_pointt extendt mint max( t textt renderert projected_xst projected_yst thetat trt tt wht xt yt wt ht xt1t yt1t xt2t yt2t xt_boxt yt_boxt w_boxt h_boxt x_boxt y_box( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt _get_textboxj s & !c
B s� e Z d Z d Z e d � Z d � Z d d d dO d d dO dO dO dO dO dO 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 e 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( d( � Z) d) � Z* d* � Z+ d+ � Z, d, � Z- d- � Z. d. � Z/ d/ � Z0 dO dO d0 � Z1 d1 � Z2 d2 � Z3 d3 � Z4 d4 � Z5 d5 � Z6 d6 � Z7 d7 � Z8 d8 � Z9 d9 � Z: d: � Z; d; � Z< d< � Z= d= � Z> d> � Z? d? � Z@ d@ � ZA dA � ZB dB � ZC dC � ZD dD � ZE dE � ZF dF � ZG dG � ZH dH � ZI dI � ZJ dJ � ZK dK � ZL eM dL � � ZN dM � ZO dN � ZP RS(P sK
Handle storing and drawing of text in window or data coordinates.
i i2 c C s d | j | j t | j � f S( Ns Text(%g,%g,%s)( t _yt reprt _text( t self( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt __str__� s i t t baselinet leftc
K s t j | � | | | _ | _ | d k r9 t d } n | d k rQ t � } n t | � rl t | � } n | j | � | j | � | j
| � | | _ | | _ | | _
| | _ | | _ d | _ d | _ d | _ |
d k r� d }
n |
| _ | j | � | j |
� d S( s�
Create a :class:`~matplotlib.text.Text` instance at *x*, *y*
with string *text*.
Valid kwargs are
%(Text)s
s
text.colorg333333�?N( R t __init__t _xRD R R R R t set_path_effectst set_textt set_colort _verticalalignmentt _horizontalalignmentt _multialignmentt _rotationt _fontpropertiest _bboxt _bbox_patcht _renderert _linespacingt set_rotation_modeR ( RG R5 R6 R- t colort verticalalignmentt horizontalalignmentt multialignmentt fontpropertiesR t linespacingt
rotation_modet path_effectsR ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRL � s0
c C s� t | j � r | j | | � S| j � s; | j d k rE t i f S| j � j \ } } } } | | } | | } | | f | | f | | f | | f f } | j | j } }
t
j | |
| � } | i 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_visibleRX R t Falset get_window_extentt boundsR5 R6 t nxutilst pnpoly( RG t
mouseeventt lt bR7 R8 t rR3 t xyvertsR5 R6 t inside( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt contains� s
*c C s+ | j � \ } } | j � j | | f � S( sD get the (possibly unit converted) transformed x, y in display coords( t get_positiont
get_transformR) ( RG R5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt _get_xy_display� s c C s! | j d k r | j S| j Sd S( N( RS R RR ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt _get_multialignment� s c C s
t | j � S( s) return the text angle as float in degrees( R" RT ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR" � s c C s> | d k s | d k r$ | | _ 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( Rv s default( R t _rotation_modet
ValueErrorRE ( RG t m( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRZ � s c C s | j S( s get text rotation mode( Rx ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_rotation_mode� s c C sz t j | | � | j | _ | j | _ | j | _ | j | _ | j j � | _ | j | _ | j | _ | j
| _
d S( s" Copy properties from other to selfN( R t update_fromt _colorRS RQ RR RU t copyRT t _pickerRY ( RG t other( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR| � s c 1 s | j � } | | j k r& | j | Sg } d \ } } d \ } } d \ } } | j � j d � }
t j t |
� d f � } t j t |
� d f � } | j � r� d d l m } t
� | � r� � f d � }
q� � f d � }
n � j }
|
d | j d
t
�\ } } } | | j } d } x� t |
� D]� \ } } | j | � \ } } | r|
| | j d
| �\ } } } n d \ } } } | | f | | <t d | | | | � } | | | | | | f | | <| | | } | | | 8} t | | � } q4W| d d } | d d | d d
} | | } | | } t � j | j � � } t j t |
� d f � } | d d � d d � f | (t |
� d k r9| j � } | d k r�| d d � d f c | d | d d � d f d 7<q9| d k r9| d d � d f c | | d d � d f 7<q9n t j | | f | | f | | f | | f g t j � } | j | � }! |! d d � d f }" |! d d � d f }# |" j � |" j � } } |# j � |# j � } } | | } | | } | j }$ | j }% | j � }& |& d k r�|$ d k r:| | d }' n |$ d k rS| | }' n | }' |% d k rv| | d } qy|% d k r�| | } qy|% d k r�| | | } qy| } n� | d \ }( }) | d \ }* }+ |$ d k r�|( |* d }' n |$ d k r|* }' n |( }' |% d k r*|) |+ d } n4 |% d k r?|+ } n |% d k rX|+ | } n |) } | j |' | f � \ }' } | |' 8} | | 8} t j | | | | � }, | j | � }- |- |' | f 8}- |- d d � d f |- d d � d f }. }/ |, t |
| |. |/ � f }0 |0 | j | <|0 S( s�
return the extent (bbox) of the text together with
multile-alignment information. Note that it returns a extent
of a rotated text when necessary.
g s
i i i����( t MixedModeRendererc s t j � j | | � S( N( R t get_text_width_height_descentRX ( t klR ( R. ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� s c s t j � | | � S( N( R R� ( R� R ( R. ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� " s t lpt ismathi i i Nt centerg @t rightRv t topRJ ( g g ( g g ( g g ( i i i (! t get_prop_tupt cachedt get_textt splitt npt zerost lent get_path_effectst! matplotlib.backends.backend_mixedR� t
isinstanceR� RU Rf RY t enumeratet is_math_textR, R
t
rotate_degR" Ru t arrayt float_t transformR+ RR RQ R{ R) R t from_boundst zip(1 RG R. t keyt horizLayoutt thisxt thisyt xmint ymint widtht heightt linest whsR� R� t tmpt lp_ht lp_blt offsetyRJ t it linet
clean_lineR� R7 R8 t dt d_yoffsett ymaxt xmaxt Mt offsetLayoutt malignt cornersHorizt cornersRotatedt txst tyst halignt valignRa t offsetxt xmin1t ymin1t xmax1t ymax1t bboxt xyst xst yst ret( ( R. sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR( s�
; 6'
-
c C s
| | _ d S( N( t
_path_effects( RG Rb ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRN � s c C s | j S( N( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s c C s� | d k r� d | k r� | j � } | j d � } | j d d � } t d d d d | d | d t j � | �| _ d | _ n d | _ | | _ d S( s�
Draw a bounding box around self. rectprops are any settable
properties for a rectangle, eg facecolor='red', alpha=0.5.
t.set_bbox(dict(facecolor='red', alpha=0.5))
If rectprops has "boxstyle" key. A FancyBboxPatch
is initialized with rectprops and will be drawn. The mutation
scale of the FancyBboxPath is set to the fontsize.
ACCEPTS: rectangle prop dict
t boxstylet bbox_transmuterg g �?R� N( g g ( R R~ t popR
R& t IdentityTransformRW RV ( RG t rectpropst propsR� R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_bbox� s c C s | j S( sk
Return the bbox Patch object. Returns None if the the
FancyBboxPatch is not made.
( RW ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_bbox_patch� s c C s | j r| j � } t | j | j � � } t | j | j � � } | j | | f � \ } } t | | � \ } } } } | j j d d | | � | j
� d t j } t
j � j | � }
|
j | | | | � }
| j j |
� | j | j � � } | j j | � n d S( s�
Update the location and the size of the bbox. This method
should be used when the position and size of the bbox needs to
be updated before actually drawing the bbox.
g g �f@N( RW Rs R t convert_xunitsRM t convert_yunitsRD R) RC t
set_boundsR" R$ R% R& R
R' t translatet
set_transformt points_to_pixelst get_sizet set_mutation_scale( RG R. t transt posxt posyRA RB R? R@ R1 R2 t fontsize_in_pixel( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt update_bbox_position_size� s
c C s� t | | � \ } } } } | j j d d | | � | j � d t j } t j � j | � } | j | | | | � } | j j
| � | j | j � � }
| j j
|
� | j j | � d S( sX Update the location and the size of the bbox
(FancyBoxPatch), and draw
g g �f@N( RC RW R� R" R$ R% R& R
R' R� R� R� R� R� t draw( RG R. R� R� RA RB R? R@ R1 R2 R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt
_draw_bbox� s
c
C sw | d k r | | _ n | j � s( d S| j � d k r> d S| j d | j � � | j | � \ } } | j � } t | j | j
� � } t | j | j � � } | j
| | f � \ } } | j � \ } } | j r� | j | | | � n | j � } | j | j � � | j | j � � | j | j � | j | � | j r_t | | | j � n | j � }
t d rdx�| D]� \ } } }
} t j |
� s|t j | � r�q|n |
| }
| | } | j � r�| | } n | j | � \ } } | j! � r>xX | j! � D]( } | j" | | |
| | | j# |
� qWq|| j" | |
| | | j# |
� q|Wn� x� | D]� \ } } }
} t j |
� skt j | � r�qkn |
| }
| | } | j � r�| | } n | j | � \ } } | j! � r3xd | j! � D]. } | j$ | | |
| | | j# |
d | �q�Wqk| j$ | |
| | | j# |
d | �qkW| j% � | j& d � d S( sI
Draws the :class:`Text` object to the given *renderer*.
NRI R- s text.usetexR� (' R RX Re R� t
open_groupt get_gidR( Rs R R� RM R� RD R) t get_canvas_width_heightRW R� t new_gct set_foregroundt get_colort set_alphat get_alphat set_urlt _urlt _set_gc_clipRV R R" R R� t isfinitet flipyR� R� t draw_texRU t draw_textt restoret close_group( RG R. R� t infoR� R� R� t canvaswt canvasht gcR! R� R4 R5 R6 R� R� t path_effect( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� sp
c C s | j S( s Return the color of the text( R} ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� T s c C s | j S( s7 Return the :class:`~font_manager.FontProperties` object( RU ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_fontpropertiesX s c C s | j S( s alias for get_fontproperties( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_font_properties\ s c C s
| j j � S( s5 Return the list of font families used for font lookup( RU t
get_family( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� ` s c C s
| j � S( s alias for get_family( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_fontfamilyd s c C s
| j j � S( s Return the font name as string( RU t get_name( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� h s c C s
| j j � S( s Return the font style as string( RU t get_style( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� l s c C s
| j j � S( s Return the font size as integer( RU t get_size_in_points( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� p s c C s
| j j � S( s# Return the font variant as a string( RU t get_variant( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� t s c C s
| j � S( s alias for get_variant( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_fontvariantx s c C s
| j j � S( s' Get the font weight as string or number( RU t
get_weight( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� | s c C s
| j � S( s alias for get_name( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_fontname� s c C s
| j � S( s alias for get_style( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt
get_fontstyle� s c C s
| j � S( s alias for get_size( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_fontsize� s c C s
| j � S( s alias for get_weight( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_fontweight� s c C s
| j j � S( s* Get the font stretch as a string or number( RU t get_stretch( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s c C s
| j � S( s alias for get_stretch( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_fontstretch� s c C s
| j � S( s! alias for get_horizontalalignment( t get_horizontalalignment( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_ha� s c C s | j S( sq
Return the horizontal alignment as string. Will be one of
'left', 'center' or 'right'.
( RR ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR � s c C s: t | j | j � � } t | j | j � � } | | f S( s5 Return the position of the text as a tuple (*x*, *y*)( R R� RM R� RD ( RG R5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRr � s c C sd | j � \ } } | | | j � | j | j | j t | j � | j | j | j j
t | j � 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.
(
Rr R� R} RQ RR t hashRU RT Rx t figuret dpit idRX ( RG R5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s c C s | j S( s Get the text as string( RF ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s c C s
| j � S( s& alias for :meth:`getverticalalignment`( t get_verticalalignment( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_va� s c C s | j S( s{
Return the vertical alignment as string. Will be one of
'top', 'center', 'bottom' or 'baseline'.
( RQ ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR � s c
C s) | j � s t j � S| d k r= | j j } | | j _ n | j � d k rw | j � \ } } t j | | d d � S| d k r� | | _ n | j d k r� t
d � � n | j | j � \ } } | j � \ } } | j
� j | | f � \ } } | j | | � } | d k r%| | j _ 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.
RI i s% Cannot get window extent w/o rendererN( Re R t unitR R R R� Rt R� RX t RuntimeErrorR( Rr Rs R) t
translated(
RG R. R t dpi_origt txt tyR� R� R5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRg � s&
! c C sG | j d k r* t d | d | � | _ n | j j 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( RV R t dictR ( RG R[ ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_backgroundcolor� s c C s; y t | � Wn t k
r- t | � } n X| | _ d S( s]
Set the foreground color of the text
ACCEPTS: any matplotlib color
N( R t TypeErrort tupleR} ( RG R[ ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRP s
c C s | j | � d S( s! alias for set_horizontalalignmentN( t set_horizontalalignment( RG t align( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_ha s c C s8 d } | | k r+ t d t | � � � n | | _ d S( sj
Set the horizontal alignment to one of
ACCEPTS: [ 'center' | 'right' | 'left' ]
R� R� RK s& Horizontal alignment must be one of %sN( s centers rightRK ( Ry t strRR ( RG R t legal( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR s c C s | j | � d S( s alias for set_verticalalignmentN( t set_multialignment( RG R ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_ma! s c C s8 d } | | k r+ 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' ]
R� R� RK s& Horizontal alignment must be one of %sN( s centers rights left( Ry R RS ( RG R R ( ( sB /opt/alt/python27/lib64/python2.7/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( RY ( RG t spacing( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_linespacing4 s c C s | j j | � 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( RU t
set_family( RG t fontname( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR = s
c C s | j j | � d S( sv
Set the font variant, either 'normal' or 'small-caps'.
ACCEPTS: [ 'normal' | 'small-caps' ]
N( RU t set_variant( RG t variant( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR I s c C s
| j | � S( s alias for set_variant( R ( RG R! ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_fontvariantQ s c C s
| j | � S( s alias for set_family( R ( RG R ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_nameU s c C s | j | � d S( s alias for set_familyN( R ( RG R ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_fontnameY s c C s | j j | � d S( sZ
Set the font style.
ACCEPTS: [ 'normal' | 'italic' | 'oblique']
N( RU t set_style( RG t fontstyle( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR% ] s c C s
| j | � S( s alias for set_style( R% ( RG R& ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt
set_fontstylee s c C s | j j | � 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( RU t set_size( RG t fontsize( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR( i s c C s
| j | � S( s alias for set_size( R( ( RG R) ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_fontsizer s c C s | j j | � 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( RU t
set_weight( RG t weight( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR+ v s c C s
| j | � S( s alias for set_weight( R+ ( RG R, ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_fontweight~ s c C s | j j | � 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( RU t set_stretch( RG t stretch( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR. � s c C s
| j | � S( s alias for set_stretch( R. ( RG R/ ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_fontstretch� s c C s& | j | d � | j | d � d S( sQ
Set the (*x*, *y*) position of the text
ACCEPTS: (x,y)
i i N( t set_xt set_y( RG t xy( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_position� s c C s
| | _ d S( sJ
Set the *x* position of the text
ACCEPTS: float
N( RM ( RG R5 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR1 � s c C s
| | _ d S( sJ
Set the *y* position of the text
ACCEPTS: float
N( RD ( RG R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR2 � s c C s
| | _ d S( sq
Set the rotation of the text
ACCEPTS: [ angle in degrees | 'vertical' | 'horizontal' ]
N( RT ( RG t s( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_rotation� s c C s | j | � d S( s alias for set_verticalalignmentN( t set_verticalalignment( RG R ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_va� s c C s8 d } | | k r+ t d t | � � � n | | _ d S( sk
Set the vertical alignment
ACCEPTS: [ 'center' | 'top' | 'bottom' | 'baseline' ]
R� t bottomR� RJ s$ Vertical alignment must be one of %sN( s topR9 s centers baseline( Ry R RQ ( RG R R ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR7 � 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( RF ( RG R5 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRO � s c C s\ t d r) | d k r d } n | d f St j | � rB | t f S| j d d � t f Sd S( sS
Returns a cleaned string and a boolean flag.
The flag indicates if the given string *s* contains any mathtext,
determined by counting unescaped dollar signs. If no mathtext
is present, the cleaned string has its dollar signs unescaped.
If usetex is on, the flag always has the value "TeX".
s text.usetext s \ t TeXs \$t $N( R R R� t Truet replaceRf ( R5 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s
c C s. t | � r t | � } n | j � | _ 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 R~ RU ( RG t fp( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_fontproperties� s c C s | j | � d S( s alias for set_fontpropertiesN( R@ ( RG R? ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_font_properties� s N(Q t __name__t
__module__t __doc__t zorderR R� RH R RL Rq Rt Ru R" RZ R{ R| R( RN 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 R Rr R� R� R R Rg R RP R R R R R R R R" R# R$ R% R' R( R* R+ R- R. R0 R4 R1 R2 R6 R8 R7 RO t staticmethodR� R@ RA ( ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR# � s� $
� $ R *
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 | j | j t | j � f S( Ns TextWithDash(%g,%g,%s)( RM RD RE RF ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRH * s i RI R� g i c C s� t j | d | d | d | d | d | d | d | d | d | d
|
�
t d | | f d | | f d d
d d � | _ t | � | _ t | � | _ | | _ | | _ |
| _ | | _
| | _ d S( NR5 R6 R- R[ R\ R] R^ R_ R R` t xdatat ydatat kt linestylet -( R# RL R t dashlineR t _dashxt _dashyt _dashlengtht _dashdirectiont
_dashrotationt _dashpadt _dashpush( RG R5 R6 R- R[ R\ R] R^ R_ R R` t
dashlengtht
dashdirectiont dashrotationt dashpadt dashpush( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRL , s$ $ c C s: t | j | j � � } t | j | j � � } | | f S( s5 Return the position of the text as a tuple (*x*, *y*)( R R� RO R� RP ( RG R5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRr W s c C sc g t j | � D] } | ^ q } | j | j | j | j | j | j | j | j 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* RM RD RQ RR RS RT RU R ( RG t pR� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� ] s "7c C sF | j | � t j | | � | j � d k rB | j j | � n d S( sP
Draw the :class:`TextWithDash` object to the given *renderer*.
g N( t
update_coordsR# R� t get_dashlengthRN ( RG R. ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� i s
c ! C s� | j � \ } } | j � } | d k rA | | | _ | _ d S| j � } | j � } | j � } | j � } t | � } t j
| d | d }
t j |
� t j |
� } } | j
� }
|
j | | f � } t j | | g � } | | | } | | | | } |
j � } | j t | � � \ } } | j t | � � \ } } | j j | | f | | f � t j | d | �} | j | j } } | d k r�| } d } na | d k r�d } | } nF | | } | } | | } | | k s�| | k r| } | | } n t j | | g � d } | d | t j t j | | � � 9} | | d d | } | j t | � � \ } } | | | _ | _ t j | d | �} | j � | _ | j j t j | g � t � t j | d � t j | 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 R� ( Rr R] RM RD t get_dashrotationt get_dashdirectiont get_dashpadt get_dashpushR" R� R% t cost sinRs R) R� t invertedR RN t set_dataR# Rg R� R� t sqrtt dott frozent _twd_window_extentt update_from_data_xyRf R R7 (! RG R. t dashxt dashyRV RX RW RY RZ R! R1 t cos_thetat sin_thetaR� t cxyt cdt c1t c2t inverset x1t y1t x2t y2t weR7 R8 t dxt dyt tan_thetat cwdt cwt newxt newy( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR\ r sZ
' c C s= | j | � | j � d k r2 t j | d | �S| j 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( R\ R] R# Rg Ri ( RG R. ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRg � s
c C s | j S( s-
Get the length of the dash.
( RQ ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR] � s c C s
| | _ d S( sT
Set the length of the dash.
ACCEPTS: float (canvas units)
N( RQ ( RG t dl( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_dashlength� s c C s | j S( sO
Get the direction dash. 1 is before the text and 0 is after.
( RR ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR_ � 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( RR ( RG t dd( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_dashdirection� s c C s$ | j d k r | j � S| j Sd S( s:
Get the rotation of the dash in degrees.
N( RS R R" ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR^ � s
c C s
| | _ d S( s\
Set the rotation of the dash, in degrees
ACCEPTS: float (degrees)
N( RS ( RG t dr( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_dashrotation s c C s | j S( sW
Get the extra spacing between the dash and the text, in canvas units.
( RT ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR` 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( RT ( RG t dp( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_dashpad s c C s | j S( sr
Get the extra spacing between the dash and the specified text
position, in canvas units.
( RU ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRa 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( RU ( RG R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt set_dashpush! s c C s& | j | d � | j | d � d S( sd
Set the (*x*, *y*) position of the :class:`TextWithDash`.
ACCEPTS: (x, y)
i i N( R1 R2 ( RG R3 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR4 , s c C s t | � | _ d S( s\
Set the *x* position of the :class:`TextWithDash`.
ACCEPTS: float
N( R RO ( RG R5 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR1 5 s c C s t | � | _ d S( s\
Set the *y* position of the :class:`TextWithDash`.
ACCEPTS: float
N( R RP ( RG R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR2 = s c C s$ t j | | � | j j | � d S( s�
Set the :class:`matplotlib.transforms.Transform` instance used
by this artist.
ACCEPTS: a :class:`matplotlib.transforms.Transform` instance
N( R# R� RN ( RG R3 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� E s c C s | j S( s0 return the figure instance the artist belongs to( R ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt
get_figureO s c C s$ t j | | � | j j | � d S( s~
Set the figure instance the artist belong to.
ACCEPTS: a :class:`matplotlib.figure.Figure` instance
N( R# t
set_figureRN ( RG t fig( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� S s N( RB RC RD RH R RL Rr R� R� R\ Rg R] R� R_ R� R^ R� R` R� Ra R� R4 R1 R2 R� R� R� ( ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRG � sJ 2 T
t
OffsetFromc B s8 e Z d d � Z d � Z d � Z d � Z d � Z RS( t pointsc C s# | | _ | | _ | j | � d S( N( t _artistt
_ref_coordt set_unit( RG t artistt ref_coordR ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRL ` s c C s
| | _ d S( N( t _unit( RG R ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� e s c C s | j S( N( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_uniti s c C s- | j � } | d k r d S| j d � Sd S( Nt pixelsg �?( R� R� ( RG R. R ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt
_get_scalel s c
C s1 t | j t � rh | j j | � } | j \ } } } } | j \ } } | | | | | | } }
n� t | j t � r� | j j \ } } } } | j \ } } | | | | | | } }
n< t | j t � r� | j j | j � \ } }
n t d � � | j
| � } t � j | | � j
| |
� } | S( Ns unknown type( R� R� R Rg Rh R� R R R) R
R� R
t scaleR� (
RG R. R� Rl Rm R7 R8 t xft yfR5 R6 t scR2 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt __call__s s !( RB RC RL R� R� R� R� ( ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� _ s
t _AnnotationBasec B st e Z d d d d d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z
d � Z d e d
� Z
RS( t datac C sr | d k r | } n | d k r* | } n | \ } } | _ | | _ | | _ | | _ | j | � d | _ d S( N( R t xytextR3 t xycoordst
textcoordst set_annotation_clipt
_draggable( RG R3 R� R� R� t annotation_clipR5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRL � s
c
C s� t | t � r | \ } } n
| | } } | d k rO t | j | � � } n | d k rs t | j | � � } n | d k r� | j | | | | � S| j | | � } | j | | f � \ } } | | f S( NR� s axes pointss
axes pixels
figure pointss figure pixel( s axes pointss
axes pixels
figure pointss figure pixel( R� R R R� R� t _get_xy_legacyt _get_xy_transformR) (
RG R. R5 R6 R5 t s1t s2R2 Rt Ru ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt _get_xy� s
c C sk t | t � rb | \ } } d d l m } | j | | � } | j | | � } | | | � } | St | � r� | | � } t | t � r� t | � St | t � r� | St d � � n t | t
� r� | j | � } t | � St | t � r� t | � St | t � r | St | � s+t d | f � � n | d k rA| j
j S| d k r}d d l m }
|
j � } | | j
j } | S| j � } t | � d k r�t d | � � n d \ }
} | \ } } | d
k r�| j j }
n | d k r�| j
j }
n |
d k r|
j d } n | d k r6| j | � } n | d k rW| \ } } d d
l m } | d k r�| j j � } | � j | d | d � } n� | d k r�| � } n� | d k r | j � } | j j � } | � j | | d | | d � } nG | d k r7|
j d \ } } | � j | | � } n t d | � � | j | | � St d | � � d S( Ni����( t blended_transform_factorys unknown return type ...s unknown coordinate type : %sR� t polar( t PolarAxesi s %s is not a recognized coodinateR t axest offset( R
R� g R@R� R) t fraction( NN( R� R t matplotlib.transformsR� R� Rc R R R R
R Rg R R� t transDatat matplotlib.projectionsR� t PolarTransformR� R� Ry R R R� Rh t _get_ref_xyR
t get_dpiR� R� R� ( RG R. R5 R� R� R� t tr1t tr2R2 R� R� R� t s_t bbox0t xy0t bbox_nameR t ref_xt ref_yR
R R) R7 R8 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � sz
( c
C s, t | j t � r� | j \ } } t | � rC | j � d d k se t | � rt | j � d d k rt t d � � n | j \ } } | j | | | | � \ } } | j | | | | � \ } } | | f St | j � r | j j � d d k r t d � � n( | j \ } } | j | | | | j � Sd S( sy
return x, y (in display coordinate) that is to be used for a reference
of any offset coordinate
i R� s+ xycoords should not be an offset coordinateN( R� R� R R R� Ry R3 R� (
RG R. R� R� R5 R6 Rt Ru Rv Rw ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� s ""
(c C s | j � } d \ } } | \ } } | d k r? | j j } n | d k rZ | j j } n | d k r| | j j � d }
n | d k r� d }
n | j \ } } }
} | d k r� |
| |
} n | | |
} | d k r� | | |
} n | | |
} | | f S(
se
only used when s in ['axes points', 'axes pixel', 'figure points', 'figure pixel'].
R R� R� g R@R� i i N( NN( R� R R R� R� R� t extents( RG R. R5 R6 R5 R� R� R� R� R R� Rl Rm Rn R3 ( ( sB /opt/alt/python27/lib64/python2.7/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( t _annotation_clip( RG Rm ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� A s c C s | j S( s
Return *annotation_clip* attribute.
See :meth:`set_annotation_clip` for the meaning of return values.
( R� ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt get_annotation_clipK s c C s( | j \ } } | j | | | | j � S( s5 Return the pixel position of the the annotated point.( R3 R� R� ( RG R. R5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt _get_position_xyR s c C sJ | j � } | s- | d k rF | j d k rF | j j | � sF 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_pointRf R= ( RG R. t xy_pixelRm ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt _check_xyW s
!c C s� d d l m } | j d k } | d k r5 | } n | rb | j d k r� | | | � | _ q� n( | j d k r� | j j � n d | _ | j S( sc
Set the draggable state -- if state is
* None : toggle the current state
* True : turn draggable on
* False : turn draggable off
If draggable is on, you can drag the annotation on the canvas with
the mouse. The DraggableAnnotation helper instance is returned if
draggable is on.
i����( t DraggableAnnotationN( t matplotlib.offsetboxR� R� R t
disconnect( RG t statet use_blitR� t is_draggable( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt draggableg s
N( RB RC R RL R� R� R� R� R� R� R� R� Rf R� ( ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s S "
t
Annotationc B st e Z d Z d � Z e j d
d d
d
d
d � � Z d � Z d � Z d � Z
d � Z d � Z e
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 | j d | j d t | j � f S( Ns Annotation(%g,%g,%s)i i ( R3 RE RF ( RG ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRH � s R� c K s� t j | | d | d | d | d | �| j \ } }
t j | | |
| | � | | _ d
| _ | r� | j d � r� | j d d � | _ t
d d
| � | _ n 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'
You may use an instance of
:class:`~matplotlib.transforms.Transform` or
:class:`~matplotlib.artist.Artist`. See
:ref:`plotting-guide-annotation` for more details.
The *annotation_clip* attribute contols the visibility of the
annotation when it goes outside the axes area. If True, the
annotation will only be drawn when the *xy* is inside the
axes. If False, the annotation will always be drawn regardless
of its position. The default is *None*, which behave as True
only if *xycoords* is"data".
Additional kwargs are Text properties:
%(Text)s
R� R� R� R� t
arrowstylet relposg �?i i N( g �?g �?( i i ( i i ( R� RL R� R# t
arrowpropsR t arrowt has_keyR� t
_arrow_relposR t arrow_patch( RG R5 R3 R� R� R� R� R� R R5 R6 ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRL � s m c C sX t j | | � \ } } | j d k rN | j j | � \ } } | pH | } n | | f S( N( R# Rq R� R ( RG t eventR3 t tinfot at ainfo( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyRq s
c C sX | j d k r" | j j | � n | j d k rD | j j | � n t j | | � d S( N( R� R R� R� R ( RG R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� s
c C s# | j | � } | j | | � d S( s? Update the pixel positions of the annotated point and the text.N( R� t _update_position_xytext( RG R. R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt update_positions& s c $ C s� | j \ } } | j | | | | j � \ | _ | _ | \ } } | j | j } } | | } } | j r�| | } }
| j | � j \ } } }
} | |
} | | } d | | } d | | } | j j � } | j r�| j
} | j | � } | j | j | d } | j
| j | d } | j j | | f | | f � | j d | j � � } | j | � } | j j | � d | k r�| j j | j d � � q�| j r�| j j | j � q�| j d d � } | j } | d k r�i } n | j � } | j d d � } | j | � } | j � d k rF| j j d � d S| j | � } | j \ } } }
} | | d
8} | | d
8} |
| 7}
| | 7} t d | | f d |
d
| � } | j t j � � | j t � | j | � | j j | � q�g | | | f D] } t | | � | f ^ q } | j! � | d \ } } g | | | f D] } t | |
� | f ^ qW} | j! � | d \ } } | j d d � } t" j# | |
| | � } t" j$ | |
d
| | d
� } | | t" j% | � } | | t" j& | � } | j d d � }! | j d d � }" | j d d � }# t' | j( | | |
| f | | | | f d |! d |" d |# | �| _) | j) j* | j+ � � n d S( sF Update the pixel positions of the annotation text and the arrow patch.g �?i i t mutation_scalet patchAt padi RI Ng @R3 R� R� t shrinkg t headwidthi t fracg�������?(, R� R� R� RM RD R� Rg Rh R~ R� R� t x0R� t y0R� t
set_positionsR� R� R� R� t
set_patchARW R RV R� R R� R& R� t set_clip_onRf R t abst sortR$ t atan2Rf Rb Rc R R R� t set_clip_boxt get_clip_box($ RG R. R� R5 R6 t ox0t oy0t ox1t oy1R� R� Rl Rm R7 R8 Rn R3 t xct ycR� R� R� R� R� R� R� t valt dsut _R� R1 Ry Rz R� R� R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� , s�
2
2
#. c C s� t | j t � s d S| j r� | j | j } } t | | � \ } } } } | j j d d | | � | j � d t j
} t j � j
| � } | j | | | | � } | j j | � | j | j � � }
| j j |
� n d S( s�
Update the location and the size of the bbox. This method
should be used when the position and size of the bbox needs to
be updated before actually drawing the bbox.
Ng g �f@( R� R� R RW RM RD RC R� R" R$ R% R& R
R' R� R� R� R� R� ( RG R. R� R� RA RB R? R@ R1 R2 R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s
c C s( | d k r | | _ n | j � s( d S| j | � } | j | | � sM d S| j | | � | j | � | j d k r� | j j d k r� | j d k r� | j | j _ n | j j | � n | j
d k r| j
j d k r| j d k r| j | j
_ n | j
j | � n t j | | � d S( sN
Draw the :class:`Annotation` object to the given *renderer*.
N( R RX Re R� R� R� R� R� R R� R� R# ( RG R. R� ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s$
!!N( RB RC RD RH R t dedent_interpdR RL Rq R� R� R� R� R R� ( ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyR� � s | n ( t TextPath(> RD t
__future__R R$ t numpyR� t
matplotlibR R t matplotlib.artistR� R t matplotlib.cbookR R R t matplotlib.font_managerR t matplotlib.patchesR R R
R R R� t
transformsR& R
R R R R t matplotlib.linesR R t matplotlib.nxutilsRi t matplotlib.pathR t font_managert matplotlib.ft2fontR t matplotlib.backend_basesR R R R" t interpdR RC R# t kwdocR� RL t im_funcRG t objectR� R� R� t matplotlib.textpathR� ( ( ( sB /opt/alt/python27/lib64/python2.7/site-packages/matplotlib/text.pyt <module> sR ((
# #� � � g � h (� � Q