m[c@`s0dZddlmZmZmZmZddlZyddlZWnek rcddl ZnXddl Z ddl m Z ddlmZmZmZddlmZmZmZddlmZmZmZmZmZddlmZdd lmZdd l m!Z!m"Z"dd l#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)dd l*m+Z+ddl,m-Z-m.Z.ddlm/Z0ddl1m2Z3ddlm4Z4yddl5m6Z6e7Z8Wnek re9Z8nXdZ:dZ;defdYZ2defdYZ<ej=defdYZ>dS(u An agg http://antigrain.com/ backend Features that are implemented * capstyles and join styles * dashes * linewidth * lines, rectangles, ellipses * clipping to a rectangle * output to RGBA and PNG, optionally JPEG and TIFF * alpha blending * DPI scaling properly - everything scales properly (dashes, linewidths, etc) * draw polygon * freetype2 w/ ft2font TODO: * integrate screen dpi w/ ppi and text i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t OrderedDict(tradianstcostsin(tcbooktrcParamst __version__(t_BackendtFigureCanvasBasetFigureManagerBaset RendererBasetcursors(tmaxdict(tFigure(tfindfonttget_font(tLOAD_FORCE_AUTOHINTtLOAD_NO_HINTINGt LOAD_DEFAULTtLOAD_NO_AUTOHINT(tMathTextParser(tPath(tBboxtBboxBase(tcolors(t RendererAgg(t_png(tImageuv2.2cC`s<itt6tt6td6td6td6td6}|tdS(Nueitherunativeuautounoneu text.hinting(RtTrueRtFalseRRR (tmapping((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytget_hinting_flag;s RcB`s.eZdZeejddZejZ dZ dZ dZ dZ dZdZd Zd Zdd Zd Zedd ZdZdddZdZdZdZdZdZdZdZdZ dZ!dddZ"dZ#dZ$RS(u The renderer handles all the drawing primitives using a graphics context instance that controls the colors/styles u2.2cC`sdS(Ni((tself((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytdebugMscC`stj|||_||_||_tt|t|||_g|_|j t d|_ t j dd|j|j|_dS(NuAggi(Rt__init__tdpitwidththeightt _RendererAggtintt _renderert_filter_rendererst_update_methodsRtmathtext_parserRt from_boundstbbox(R$R(R)R'((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR&_s    !  cC`s"i|jd6|jd6|jd6S(Nuwidthuheightudpi(R(R)R'(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt __getstate__mscC`s#|j|d|d|ddS(Nuwidthuheightudpi(R&(R$tstate((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt __setstate__rscC`stdrtStSdS(Nu text.hinting(R RR(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt_get_hinting_flagus cO`s|jj||S(N(R,t draw_markers(R$tkltkw((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR6}scO`s|jj||S(N(R,tdraw_path_collection(R$R7R8((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR9scC`s^|jj|_|jj|_|jj|_|jj|_|jj|_|jj|_dS(N(R,tdraw_quad_meshtdraw_gouraud_triangletdraw_gouraud_trianglest draw_imagetcopy_from_bboxtget_content_extents(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR.s cC`st|j}|d|j|d|dg|d|d|j|dgg}|j|}tj||fS(Niiii(R?R)R>tnptarray(R$textentsR1tregion((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyttostring_rgba_minimizeds   &cC`std}|jjd}|dkr||kr|jr|dkr|jdkrtj||}ttj||}tj d||} tj | } | dd| d*|| dlib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRPs2 !      cC`s|jj||j|\}}} } } } } | tt|}| tt|}tj|||}tj|||}|jj | ||d||dS(u> Draw the math text using matplotlib.mathtext iN( R/tparseR'RRRR@troundR,tdraw_text_image(R$RRtxtytstproptangletoxtoyR(R)tdescentt font_imagetused_characterstxdtyd((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt draw_mathtexts 0c C`s]|r"|j||||||St} |j|} | dkrJdSt|dkrt|dkr| jt|d| n| j|dd| | jdt d| j d} | j \} } | d} | d} | t t |}| tt |}|jj| tj||| tj||| d||dS( u! Render the text iitflagsit antialiasedutext.antialiasedgP@N(RpR#t _get_agg_fontRHtlentordt load_chartset_texttdraw_glyphs_to_bitmapR t get_descenttget_bitmap_offsetRRRR,RcR@Rb(R$RRRdReRfRgRhtismathtmtextRqtfonttdtxotyoRnRo((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt draw_texts$  $   cC`s|dkr^|j}|j}|j}|j||d|\}}} ||| fS|r|jj||j|\} } } } }}}| | |fSt}|j|}|j|dd||j \}}|j } |d}|d}| d} ||| fS(u Get the width, height, and descent (offset from the bottom to the baseline), in display coords, of the string *s* with :class:`~matplotlib.font_manager.FontProperties` *prop* uTeXuTeX!trenderergRqgP@(uTeXuTeX!( tget_size_in_pointstget_texmanagertget_text_width_height_descentR/RaR'R#RsRwtget_width_heightRy(R$RfRgR{tsizet texmanagertfontsizetwthR~RiRjR(R)RktfontsRmRqR}((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs&     0      uTeX!c C`s|j} |j} | j|| |j} tj| dtj} |j|||\} } }|tt |}|t t |}tj ||}tj ||}|j j | ||||dS(Ngo@(RRtget_greyR'R@RAtuint8RRRRRbR,Rc(R$RRRdReRfRgRhR{R|RRtZRRR~RnRo((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytdraw_texs  cC`s|j|jfS(u4return the canvas width and height in display coords(R(R)(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytget_canvas_width_heightscC`sEt|}t|}|j|j}|j||j|S(uK Get the font for text instance t, cacheing for efficiency (RRtclearRtset_sizeR'(R$RgtfnameR}R((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRss     cC`s||jdS(uj convert point measures to pixes using dpi and the pixels per inch of the display gR@(R'(R$tpoints((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytpoints_to_pixels scC`s |jjS(N(R,t tostring_rgb(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR'scC`s |jjS(N(R,t tostring_argb(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR*scC`s |jjS(N(R,t buffer_rgba(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR-scC`s|jjdS(N(R,R(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR0scC`stS(N(R (R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytoption_image_nocomposite3scC`stS(uI agg backend doesn't support arbitrary scaling of image. (R!(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytoption_scale_image9sc C`s|dk s|dk r|dkr?|j\}}}}n9t|trf|j\}}}}n|\}}}}|dkr||}} n |\}} |jj|t|t|t|t|t|t| n|jj|dS(u: Restore the saved region. If bbox (instance of BboxBase, or its extents) is given, only the region specified by the bbox will be restored. *xy* (a tuple of two floasts) optionally specifies the new position (the LLC of the original region, not the LLC of the bbox) where the region will be restored. >>> region = renderer.copy_from_bbox() >>> x1, y1, x2, y2 = region.get_extents() >>> renderer.restore_region(region, bbox=(x1+dx, y1, x2, y2), ... xy=(x1-dx, y1)) N(RHt get_extentst isinstanceRRBR,trestore_regionR+( R$RCR1txytx1ty1tx2ty2RiRj((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR?s   +cC`sK|jj|jtt|jt|j|j|_|jdS(uX Start filtering. It simply create a new canvas (the old one is saved). N( R-tappendR,R*R+R(R)R'R.(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt start_filterbscC`s:t|jt|j}}|j\}}|\}}}} |jj|_|j|dkr6| dkr6tj |tj } || j | |dfd|j \} } } |j } | jjdkrtj| dtj } n| ddd} |jj| || ||| | | ndS(u Save the plot in the current canvas as a image and apply the *post_processing* function. def post_processing(image, dpi): # ny, nx, depth = image.shape # image (numpy array) has RGBA channels and has a depth of 4. ... # create a new_image (numpy array of 4 channels, size can be # different). The resulting image may have offsets from # lower-left corner of the original image return new_image, offset_x, offset_y The saved renderer is restored and the returned image from post_processing is plotted (using draw_image) on it. iigo@ufNi(R+R(R)RDR-tpopR,R.R@t fromstringRtreshapeR'tnew_gctdtypetkindtasarrayR=(R$tpost_processingR(R)tbuffertboundstltbRRtimgRiRjRR((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt stop_filterks   N(%t__name__t __module__t__doc__tpropertyRt deprecatedR%t threadingtRLocktlockR&R2R4R5R6R9R.RDRHRPRpR!RRRRRsRRRRRRRRRR(((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRGs:          #          # tFigureCanvasAggcB`seZdZdZd d dZdZedZdZ dZ dZ dZ e Z d Zd Zerd ZeZd ZeZnRS(u The canvas the figure renders into. Calls the draw and print fig methods, creates the renderers, etc... Attributes ---------- figure : `matplotlib.figure.Figure` A high-level Figure instance cC`s|j}|j|S(N(t get_rendererR>(R$R1R((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR>s cC`s|j}|j|||S(N(RR(R$RCR1RR((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs cC`sj|jdt|_tjj|j}z*|jj|jt t |jWdtjj XdS(u4 Draw the figure using the renderer tclearedN( RR RRRtacquirettoolbartfiguretdrawtsuperRtrelease(R$R((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs  cC`s|jjj\}}}}|||jjf}y|j|jfWntk r]t}nX|j|k}|rt|||jj|_||_n|r|jj n|jS(N( RR1RR't_lastKeyRtAttributeErrorR RR(R$RRRRRtkeytneed_new_renderer((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs  cC`s |jjS(uGet the image as an RGB byte string `draw` must be called at least once before this function will work and to update the renderer for any subsequent changes to the Figure. Returns ------- bytes (RR(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs cC`s |jjS(uGet the image as an ARGB byte string `draw` must be called at least once before this function will work and to update the renderer for any subsequent changes to the Figure. Returns ------- bytes (RR(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs cC`s |jjS(uGet the image as an RGBA byte string `draw` must be called at least once before this function will work and to update the renderer for any subsequent changes to the Figure. Returns ------- bytes (RR(R$((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs cO`stj||j}|j}|jj|_t|tjr[t|d}t }n |}t }z|j |j j Wd|r|jn||_XdS(Nuwb(RRRR'RRtsixt string_typestopenR R!twriteR,Rtclose(R$tfilename_or_objtargstkwargsRt original_dpitfileobjR((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt print_raws     c O`stj||j}|j}|jj|_dtd}ti|d6}|jdd}|dk r|j |nzAt j |d)} t j |j| |jjd|WdQXWd||_XdS(Numatplotlib version u, http://matplotlib.org/uSoftwareumetadatauwbtmetadata(RRRR'RR RRRHtupdateRt open_file_cmRt write_pngR,( R$RRRRRt version_strRt user_metadatatfh((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt print_pngs    cC`sstj||j}|j}|jj|_z1|jjt|jt|j ff}Wd||_X|S(N( RRRR'RR,RR+R(R)(R$RRtresult((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytprint_to_buffers    % c `s!|j\}}jdtr(dStjd||dddd}tjtd}tg|d D]}t |d ^qj} tj d || } | j ||fd d d ddgD} | j d tdd| kr | d| df| dlib/python2.7/site-packages/matplotlib/backends/backend_agg.pys Ds uqualityuoptimizeu progressiveudpiusavefig.jpeg_qualitytformatujpeg(RRR!Rt frombuffertmcolorstto_rgbaR ttupleR+tnewtpastet setdefaulttsave( R$RRRtbufRtimagetrgbaRdtcolort backgroundtoptions((Rs>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt print_jpg&s!-  cO`sz|j\}}|jdtr(dStjd||dddd}|jj|jjf}|j|ddd|S( NudryrunuRGBAurawiiRutiffR'(RRR!RRRR'R(R$RRRRRRR'((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyt print_tifPs!N(RRRR>RHRRR!RRRRRt print_rgbaRRt_has_pilRt print_jpegRt print_tiff(((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyRs"        ' t _BackendAggcB`seZeZeZRS((RRRt FigureCanvasR t FigureManager(((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pyR[s(?Rt __future__RRRRRRt ImportErrortdummy_threadingtnumpyR@t collectionsRtmathRRRt matplotlibRR R tmatplotlib.backend_basesR R R RRtmatplotlib.cbookRtmatplotlib.figureRtmatplotlib.font_managerRRtmatplotlib.ft2fontRRRRtmatplotlib.mathtextRtmatplotlib.pathRtmatplotlib.transformsRRRRt matplotlib.backends._backend_aggRR*RtPILRR RR!tbackend_versionR#RtexportR(((s>lib/python2.7/site-packages/matplotlib/backends/backend_agg.pytsB"   ("    O