1aGc@ sdZddklZddkZddkZddkZddkZddklZddkl Z ddkl Z ddk Z ddk l Z ddk l Z lZlZlZdd klZdd klZlZdd klZlZlZdd klZddkiZed ZdZ eddddZ!de i"dddd>d>d>d>d Zeieie i e_dZ d Z d Z d Zd Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZdZ dZ!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.Z0d/Z1d0Z2d1Z3d2Z4d3Z5d4Z6d5Z7d6Z8d7Z9d8Z:d9Z;d:Z<d;Z=d<Z>d=Z?RS(?sK Handle storing and drawing of text in window or data coordinates icC sd|i|i|ifS(NsText(%g,%g,%s)(t_yt_text(tself((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt__str__Vsittbottomtleftc K s ti|td|_|||_|_|djotd}n|djo t}nt |ot|}n|i ||i |||_ ||_ ||_| |_||_d|_d|_| djo d} n| |_|i| dS(sl Create a Text instance at x,y with string text. Valid kwargs are %(Text)s is text.colorg333333?N(Rt__init__Rtcachedt_xRRRR Rtset_textt set_colort_verticalalignmentt_horizontalalignmentt_multialignmentt _rotationt_fontpropertiest_bboxt _renderert _linespacingR( RtxtyttexttcolortverticalalignmentthorizontalalignmenttmultialignmenttfontpropertiesRt linespacingR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR$Ys&             c C st|io|i||Sny"|ii\}}}}WnthfSnX||}||}||f||f||f||ff}|i|i} } ti| | |} | hfS(sUTest whether the mouse event occurred in the patch. Returns T/F, {} ( tcallablet _containstget_window_extentt get_boundstFalseR1R2tnxutilstpnpoly( Rt mouseeventtltbtwthtrtttxyvertsR1R2tinside((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytcontainss$"  *cC s+|i\}}|ii||fS(sCget the (possibly unit converted) transformed x,y in display coords(t get_positiont get_transformtxy_tup(RR1R2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt_get_xy_displayscC s&|idj o |iSn|iSdS(N(R+RR*(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt_get_multialignmentscC s t|iS(sreturn the text angle as float(RR,(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC szti|||i|_|i|_|i|_|i|_|ii|_|i|_|i |_ |i |_ dS(s"Copy properties from other to selfN( Rt update_fromt_colorR+R)R*R-tcopyR,t_pickerR0(Rtother((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRPs      c2C s|i}|ii|o|i|Sng}|i\}}d}d}||}} |iid} g} |id|idt\} } }| |i }d}x| D]}|i||id|i |\}}}|djo||}n| i ||f|i |||||f||8}t ||}qW|dd} |dd|dd}|| }||}|i|| }|| f||f||f|| ff}g}t| djo|i}x|D]v\}}}}}|djo|d |d }n"|d jo||}nd}||7}|i ||fqWn7g}|D]"\}}}}}|||fq|~}g}|D]:\}}|ti|ti|g|gdggq~}g}|D]} |t| ddq~}!g}"|D]} |"t| ddq/~"}#t|!t |!}}t|#t |#} }||}|| }|i}$|i}%|i\}&}'|$djo|&||d }n*|$d jo|&||}n |&|}|%djo|'| |d }nM|%d jo|'| |}n.|%d jo|'| ||}n |'| }||7}||7}| |7} ||7}t|| ||}(g})|D]:\}}|)ti|ti|g|gdggq~)}*g}+|*D]} |+t| dd|q~+}&g},|*D]} |,t| dd|qA~,}'g}-t|&|'D]}.|-|ii|.q}~-}*t|*\}/}0|(t| | |/|0f}1|1|i|<|1S( Nis tlptismathiiitcenterg@trightttoptbaseline(t get_prop_tupR%thas_keyRNRtsplittget_text_width_height_descentR-R>R0Rt is_math_texttappendtmaxtget_rotation_matrixtlenROtnpytdottarrayRtminR*R)R tzipRLtinverse_xy_tup(2Rtrenderertkeyt horizLayouttthisxtthisytwidththeighttxmintymintlinestwhsttmptheightttbltoffsetyRZtlineRDREtdtymaxtxmaxtMt cornersHorizt offsetLayouttmaligntoffsetxt_[1]t_[2]tcornersRotatedt_[3]tvttxst_[4]ttysthaligntvalignttxttytbboxt_[5]txyst_[6]t_[7]t_[8]txytxstystret((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt _get_layouts "  '    * # 6N//    # ##     N339 cC s ||_dS(s Draw a bounding box around self. rect props are any settable properties for a rectangle, eg facecolor='red', alpha=0.5. t.set_bbox(dict(facecolor='red', alpha=0.5)) ACCEPTS: rectangle prop dict plus key 'pad' which is a pad in points N(R.(Rt rectprops((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_bboxs c C s|dj o ||_n|ipdSn|idjodSn|i}|i|i|i|i|i o|i |i i n|i ot|||i n|i}|i|\}}|i}tdo|i\}}xo|D]g\} } } } |i| | f\} } |io|| } n|i|| | | |i|q WdSnx|D]\} } } } |i| | f\} } |io |i\}}|| } n|i|| | | |i|d|i| qWdS(NR!s text.usetexRV(RR/t get_visibleRtnew_gctset_foregroundRQt set_alphat_alphat get_clip_ontset_clip_rectangletclipboxR=R.R RRRLRtget_canvas_width_heightRMtflipytdraw_texR-t draw_textR_( RRjtgcRRtinfottranstcanvaswtcanvashRytwhR1R2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytdraw*sB           cC s|iS(sReturn the color of the text(RQ(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt get_colorUscC s|iS(sReturn the font object(R-(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytget_font_propertiesYscC s|iidS(sReturn the font name as stringi(R-t get_family(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytget_name]scC s |iiS(sReturn the font style as string(R-t get_style(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRascC s |iiS(sReturn the font size as integer(R-tget_size_in_points(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytget_sizeescC s |iiS(sGet the font weight as string(R-t get_weight(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRiscC s|iidS(salias for get_namei(R-R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt get_fontnamemscC s |iiS(salias for get_style(R-R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt get_fontstyleqscC s |iiS(salias for get_size(R-R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt get_fontsizeuscC s |iiS(salias for get_weight(R-R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytget_fontweightyscC s |iS(s!alias for get_horizontalalignment(tget_horizontalalignment(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytget_ha~scC s|iS(s)Return the horizontal alignment as string(R*(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s|ii|i|ifS(sCget the (possibly unit converted) transformed x,y in display coords(RLRMR&R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRNscC s:t|i|i}t|i|i}||fS(sReturn x, y as tuple(Rtconvert_xunitsR&tconvert_yunitsR(RR1R2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRKsc C sU|i\}}|||i|i|i|it|i|i|ii 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 ( RKRRQR)R*thashR-R,RLt as_vec6_val(RR1R2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR[s  cC s|iS(sGet the text as string(R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytget_textscC s |iS(salias for getverticalalignment(tget_verticalalignment(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytget_vascC s|iS(s'Return the vertical alignment as string(R)(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s|iptSn|idjo)|i\}}t||ddSn|dj o ||_n|idjotdn|i}|i |i\}}|S(NR!is%Cannot get window extent w/o renderer( Rt _unit_boxRRNR RR/t RuntimeErrorRR(RRjRRRRR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR<s   cC stid|i}tidd| gdd| gdddgg}titi|ti| dgti|ti|dgdddgg}tidd|gdd|gdddgg}titi|||S(Ngf@ii(RdtpiRRftcostsinRe(Rtx0ty0tthetatTorigintRtTback((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRbs % cC sI|idjotd|d||_n|iitd|dS(s Set the background color of the text by updating the bbox (see set_bbox for more info) ACCEPTS: any matplotlib color t facecolort edgecolorN(R.RtdictR(RR4((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_backgroundcolorscC s=yt|Wntj ot|}nX||_dS(s] Set the foreground color of the text ACCEPTS: any matplotlib color N(Rt TypeErrorttupleRQ(RR4((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR(s cC s|i|dS(s!alias for set_horizontalalignmentN(tset_horizontalalignment(Rtalign((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_hascC s:d}||jotdt|n||_dS(sj Set the horizontal alignment to one of ACCEPTS: [ 'center' | 'right' | 'left' ] RWRXR#s&Horizontal alignment must be one of %sN(scentersrightsleft(t ValueErrortstrR*(RRtlegal((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRs cC s|i|dS(salias for set_verticalalignmentN(tset_multialignment(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_mascC s:d}||jotdt|n||_dS(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' ] RWRXR#s&Horizontal alignment must be one of %sN(scentersrightsleft(RRR+(RRR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRs  cC s ||_dS(sv Set the line spacing as a multiple of the font size. Default is 1.2. ACCEPTS: float N(R0(Rtspacing((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_linespacingscC s|ii|dS(sx Set the font family ACCEPTS: [ 'serif' | 'sans-serif' | 'cursive' | 'fantasy' | 'monospace' ] N(R-t set_family(Rtfontname((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s|ii|dS(sY Set the font variant, eg, ACCEPTS: [ 'normal' | 'small-caps' ] N(R-t set_variant(Rtvariant((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR scC s|ii|dS(sh Set the font name, ACCEPTS: string eg, ['Sans' | 'Courier' | 'Helvetica' ...] N(R-R(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_name(scC s|i|dS(salias for set_nameN(R(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt set_fontname0scC s|ii|dS(sY Set the font style ACCEPTS: [ 'normal' | 'italic' | 'oblique'] N(R-t set_style(Rt fontstyle((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR4scC s|ii|dS(salias for set_styleN(R-R(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt set_fontstyle<scC s|ii|dS(s Set the font size, eg, 8, 10, 12, 14... ACCEPTS: [ size in points | relative size eg 'smaller', 'x-large' ] N(R-tset_size(Rtfontsize((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR@scC s|ii|dS(salias for set_sizeN(R-R(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt set_fontsizeHscC s|ii|dS(salias for set_weightN(R-t set_weight(Rtweight((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_fontweightLscC s|ii|dS(s} Set the font weight ACCEPTS: [ 'normal' | 'bold' | 'heavy' | 'light' | 'ultrabold' | 'ultralight'] N(R-R(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRPscC s&|i|d|i|ddS(sI Set the xy position of the text ACCEPTS: (x,y) iiN(tset_xtset_y(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt set_positionXscC s ||_dS(sH Set the x position of the text ACCEPTS: float N(R&(RR1((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRascC s ||_dS(sH Set the y position of the text ACCEPTS: float N(R(RR2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRjscC s ||_dS(sm Set the rotation of the text ACCEPTS: [ angle in degrees 'vertical' | 'horizontal' N(R,(Rts((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt set_rotationsscC s|i|dS(salias for set_verticalalignmentN(tset_verticalalignment(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_va}scC s:d}||jotdt|n||_dS(sk Set the vertical alignment ACCEPTS: [ 'center' | 'top' | 'bottom' | 'baseline' ] RYR"RWRZs$Vertical alignment must be one of %sN(stopsbottomscentersbaseline(RRR)(RRR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRs cC sd|f|_dS(sk Set the text string s ACCEPTS: string or anything printable with '%s' conversion s%sN(R(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR'scC sYtdodSn|id|id}|djo|ddjotSntS(Ns text.usetextTeXt$s\$ii(RtcounttTrueR>(RRt dollar_count((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR_s cC s*t|ot|}n||_dS(s Set the font properties that control the text ACCEPTS: a matplotlib.font_manager.FontProperties instance N(RR R-(Rtfp((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_fontpropertiess N(@t__name__t __module__t__doc__tzorderR RR$RtdedenttartisttkwdocdRJRNRORRPRRRRRRRRRRRRRRRRKR[RRRR<RbRR(RRRRRRRRRRRRRRRRRRRRRR'R_R(((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRPs        o +                                    t TextWithDashcB seZdZdZdZdddddddddddddddedZd Zd Zd Z d Z dd Z dZ dZ dZdZdZdZdZdZdZdZdZdZdZdZdZdZRS(s This is basically a Text with a dash (drawn with a Line2D) before/after it. It is intended to be a drop-in replacement for Text, and should behave identically to Text when dashlength=0.0. The dash always comes between the point specified by 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, npy.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 self.get_dashrotation() returns self.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 set_position() by the amount in canvas units. (default=0) NOTE: The alignment of the two objects is based on the bbox of the Text, as obtained by 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. NOTE2: I'm not sure that I got the get_window_extent() right, or whether that's sufficient for providing the object bbox. t textwithdashcC sd|i|i|ifS(NsTextWithDash(%g,%g,%s)(R&RR(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR siR!RWgicC sti|d|d|d|d|d|d|d|d|d | d |  td ||fd ||fdd dd|_t||_t||_| |_| |_| |_ ||_ ||_ dS(NR1R2R3R4R5R6R7R8RR9txdatatydatatkt linestylet-( RR$RtdashlineRt_dashxt_dashyt _dashlengtht_dashdirectiont _dashrotationt_dashpadt _dashpush(RR1R2R3R4R5R6R7R8RR9t dashlengtht dashdirectiont dashrotationtdashpadtdashpushtxaxis((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR$s$$      cC s:t|i|i}t|i|i}||fS(sReturn x, y as tuple(RRR RR (RR1R2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRK sc C skg}ti|D] }||q~}|i|i|i|i|i|i|i|i gt |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[textendR&RR R RRRR(RRtptprops((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR[s*7cC sTt|_|i|ti|||idjo|ii|ndS(Ng(RR%t update_coordsRRtget_dashlengthR (RRj((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRs   c C s|i\}}|i}|djo|||_|_dSn|i}|i}|i}|i}t|} t i | d|d} t i | t i | } } |i } t i| i||f}t i| | g}|||}||||}| it|\}}| it|\}}|ii||f||fti|d|}|i|i}}| djo|}d}ng| djod}|}nJ| | }|}||}||jp|| jo|}||}nt i||gd}|d|t it i||9}||dd|}| it|\}}|||_|_ti|d|}|i|_|ii|d|dfftti|dti|ddS( sComputes 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. gNgf@iRjiiRW( RKRR&Rtget_dashrotationtget_dashdirectiont get_dashpadt get_dashpushRRdRRRRLRfRMRiRR tset_dataRR<RoRptsqrtRetdeepcopyt_twd_window_extentRR>RR( RRjtdashxtdashyRRRRRRRt cos_thetat sin_thetat transformtcxytcdtc1tc2tx1ty1tx2ty2tweRDREtdxtdyt tan_thetatcwdtcwtnewxtnewy((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR%sX              '$cC sB|i||idjoti|d|Sn|iSdS(NgRj(RRRR<R#(RRj((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR<{s cC s|iS(N(R (R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s ||_dS(sE Set the length of the dash. ACCEPTS: float N(R (Rtdl((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_dashlengthscC s|iS(N(R (R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s ||_dS(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 N(R (Rtdd((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_dashdirections cC s)|idjo|iSn|iSdS(N(RRR(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s ||_dS(sG Set the rotation of the dash. ACCEPTS: float N(R(Rtdr((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytset_dashrotationscC s|iS(N(R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s ||_dS(s Set the "pad" of the TextWithDash, which is the extra spacing between the dash and the text, in canvas units. ACCEPTS: float N(R(Rtdp((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt set_dashpadscC s|iS(N(R(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s ||_dS(s Set the "push" of the TextWithDash, which is the extra spacing between the beginning of the dash and the specified position. ACCEPTS: float N(R(RR?((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt set_dashpushscC s&|i|d|i|ddS(sR Set the xy position of the TextWithDash. ACCEPTS: (x,y) iiN(RR(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC st||_dS(sQ Set the x position of the TextWithDash. ACCEPTS: float N(RR (RR1((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC st||_dS(sQ Set the y position of the TextWithDash. ACCEPTS: float N(RR (RR2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRscC s$ti|||ii|dS(s Set the Transformation instance used by this artist. ACCEPTS: a matplotlib.transform transformation instance N(Rt set_transformR (RRG((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRBscC s|iS(sreturn the figure instance(tfigure(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyt get_figurescC s$ti|||ii|dS(su Set the figure instance the artist belong to. ACCEPTS: a matplotlib.figure.Figure instance N(Rt set_figureR (Rtfig((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyREsN(RRRR RRR$RKR[RRR<RR:RR<RR>RR@RRARRRRBRDRE(((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRsL.      V           t AnnotationcB sueZdZdZd dd d dZeieiei e_dZ dZ dZ dZ dZRS( sq A Text class to make annotating things in the figure: Figure, Axes, Point, Rectangle, etc... easier cC s"d|id|id|ifS(NsAnnotation(%g,%g,%s)ii(RR(R((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR stdatac K s|djo |}n|djo |}n|\}} |_ti||| ||||_||_d|_||_||_dS(s Annotate the x,y point xy with text s at x,y location xytext (xytext if None defaults to xy and textcoords if None defaults to xycoords). arrowprops, if not None, is a dictionary of line properties (see matplotlib.lines.Line2D) for the arrow that connects annotation to the point. Valid keys are - 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: often times 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 matplotlib.patches.polygon xycoords and textcoords are strings that indicate the coordinates of xy and xytext. '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 left, bottom 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 N( RtxytextRR$Rt arrowpropstarrowtxycoordst textcoords( RRRRIRLRMRJRR1R2((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyR$s7        cC s[ti||\}}|idj o)|ii|\}}|p|}n||fS(N(RRJRKR(RteventRGttinfotatainfo((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRJAs cC sti||dS(sc Set the artist's clip Bbox ACCEPTS: a matplotlib.transform.Bbox instance N(Rt set_clip_box(RR((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRRIscC sf|djoM|ii}t|i|}t|i|}|i||fSn |djo|i\}}|idjo|i||dSn|i|||i\}}|i i i }||d9}||d9}||7}||7}||fSnX|djoV||}} | t i |}| t i|}|ii}|i||fSn|djo|i i i }|i ii\} } } } | | } | | }||d9}||d9}|djo| |}n|djo||}n||fSnD|djov|i ii\} } } } | | } | | }|djo| |}n|djo||}n||fSn|djo#|i i}|i||fSn|d jo|i i i }|iii\} } } } | | } | | }|djo| ||d}n| ||d}|djo|||d}n| ||d}||fSn|d jo|iii\} } } } | | } | | }|djo| |}n | |}|djo||}n | |}||fSn1|d jo#|ii}|i||fSndS( NRHs offset pointsgR@tpolars figure pointsis figure pixelssfigure fractions axes pointss axes pixelss axes fraction(taxest transDataRRRRMRRLt_get_xyRCtdpitgetRdRRRR=t transFiguret transAxes(RR1R2RRR2R3RWRRFRBRCRDRERG((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRVQs                                  cC s|i\}}|i|||i\|_|_|i\}}|i|||i\}}|io@||}}|i|i \}}}} |i i i } ||} || } d|| } d|| }g}|| | fD]}|t |||fq~}|i|d\}}g}|| |fD]}|t |||fqB~}|i|d\}}|ii}|idd}|idd}|idd}|id d }ti||||}ti||d ||d } || ti|}|| ti|}t|i i ||||f||||fd|d|d|||_|ii|indS( Ng?iRoit headwidthi tfracg?tshrinkgg@(RIRVRMR&RRRLRJR<R=RCRWRXtabstsortRRtpoptmathtatan2R!RRR RKRRt get_clip_box(RRjR1R2RRRBRCRDRERWRFRGtxctycRtvaltdsuRzRRoR[R\R]RR2R3((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pytupdate_positionss>$  !  : : #1 cC sE|i||idj o|ii|nti||dS(N(RhRKRRR(RRj((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRs N(RRRR RR$RRRRRJRRRVRhR(((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyRGs  ?   ` ,((Rt __future__RtreRatnumpyRdt matplotlibRRRRRRRRRt font_managerR tpatchesR R t transformsR R RRsRtmatplotlib.nxutilsR?RRRRRRtkwdocRRGR$(((s8/Users/cmoad/workspace/matplotlib/lib/matplotlib/text.pyss8   " # \G