ó m[c@`s>dZddlmZmZmZmZddlZddlmZddl m Z ddl m Z ddl mZdefd „ƒYZd efd „ƒYZd efd „ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdS(u¯ Defines classes for path effects. The path effects are supported in :class:`~matplotlib.text.Text`, :class:`~matplotlib.lines.Line2D` and :class:`~matplotlib.patches.Patch`. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(t RendererBase(tcolors(tpatches(t transformstAbstractPathEffectcB`s8eZdZdd„Zd„Zd„Zdd„ZRS(uƒ A base class for path effects. Subclasses should override the ``draw_path`` method to add effect functionality. gcC`s||_tjƒ|_dS(u Parameters ---------- offset : pair of floats The offset to apply to the path, measured in points. N(t_offsett mtransformstAffine2Dt _offset_trans(tselftoffset((s5lib/python2.7/site-packages/matplotlib/patheffects.pyt__init__s cC`sI|j|jdƒ}|j|jdƒ}||jjƒj||ƒS(u(Apply the offset to the given transform.ii(tpoints_to_pixelsR R tcleart translate(R trenderert transformtoffset_xtoffset_y((s5lib/python2.7/site-packages/matplotlib/patheffects.pyt_offset_transform$scC`sœ|jƒ}|jddƒ}|r4|j|nxatj|ƒD]P\}}t|d|dƒ}t|ƒsŠtdj |ƒƒ‚n||ƒqDW|S(uÆ Update the given GraphicsCollection with the given dictionary of properties. The keys in the dictionary are used to identify the appropriate set_ method on the gc. udashesuset_uUnknown property {0}N( tcopytpoptNonet set_dashestsixt iteritemstgetattrtcallabletAttributeErrortformat(R tgct new_gc_dicttdashestktvt set_method((s5lib/python2.7/site-packages/matplotlib/patheffects.pyt _update_gc+s  cC`s1t|tƒr|j}n|j||||ƒS(uÆ Derived should override this method. The arguments are the same as :meth:`matplotlib.backend_bases.RendererBase.draw_path` except the first argument is a renderer. (t isinstancetPathEffectRenderert _renderert draw_path(R RR"ttpathtaffinetrgbFace((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,?s (ggN(t__name__t __module__t__doc__RRR(RR,(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRs   R*cB`sbeZdZd„Zd„Zd„Zd d„Zd„Zd„Z d„Z d„Z d „Z RS( ux Implements a Renderer which contains another renderer. This proxy then intercepts draw calls, calling the appropriate :class:`AbstractPathEffect` draw method. .. note:: Not all methods have been overridden on this RendererBase subclass. It may be necessary to add further methods to extend the PathEffects capabilities further. cC`s||_||_dS(u÷ Parameters ---------- path_effects : iterable of :class:`AbstractPathEffect` The path effects which this renderer represents. renderer : :class:`matplotlib.backend_bases.RendererBase` instance N(t _path_effectsR+(R t path_effectsR((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRYs cC`s |jjƒS(N(R+tnew_gc(R ((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR5escC`s|j||jƒS(N(t __class__R+(R R4((s5lib/python2.7/site-packages/matplotlib/patheffects.pytcopy_with_path_effecthscC`s4x-|jD]"}|j|j||||ƒq WdS(N(R3R,R+(R R"R-R.R/t path_effect((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,ksc O`szt|jƒdkr4tj|||||||ŽSx?|jD]4}|j|gƒ}|j||||||Žq>WdS(Ni(tlenR3Rt draw_markersR7( R R"t marker_patht marker_transtpathtargstkwargsR8R((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR:ps cO`stt|jƒdkr1tj||||||ŽSx<|jD]1}|j|gƒ}|j|||||Žq;WdS(Ni(R9R3Rtdraw_path_collectionR7(R R"tmaster_transformtpathsR>R?R8R((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR@ƒs  cC`s|jj|ƒS(N(R+R(R tpoints((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR–sc C`sZ|j||||||ƒ\}} |jƒ} |jdƒ|j||| d| ƒdS(NgR/(t_get_text_path_transformtget_rgbt set_linewidthR,( R R"txtytstproptangletismathR=Rtcolor((s5lib/python2.7/site-packages/matplotlib/patheffects.pyt_draw_text_as_path™s   cC`s0|dkrt|j|ƒStj||ƒSdS(Nu _text2pathuflipyuheightuwidth(u _text2pathuflipyuheightuwidth(RR+tobjectt__getattribute__(R tname((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRP¡s N( R0R1R2RR5R7RR,R:R@RRNRP(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR*Ls        tNormalcB`seZdZRS(uŽ The "identity" PathEffect. The Normal PathEffect's sole purpose is to draw the original artist with no special path effect. (R0R1R2(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRR¨stStrokecB`s#eZdZdd„Zd„ZRS(u0A line based PathEffect which re-draws a stroke.icK`s#tt|ƒj|ƒ||_dS(u± The path will be stroked with its gc updated with the given keyword arguments, i.e., the keyword arguments should be valid gc parameter values. N(tsuperRSRt_gc(R RR?((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR´scC`sd|jƒ}|j|ƒ|j||jƒ}|j||ƒ}|j||||ƒ|jƒdS(u0 draw the path with updated gc. N(R5tcopy_propertiesR(RURR,trestore(R RR"R-R.R/tgc0ttrans((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,½s   (ii(R0R1R2RR,(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRS²s t withStrokecB`seZdZd„ZRS(uy Adds a simple :class:`Stroke` and then draws the original Artist to avoid needing to call :class:`Normal`. cC`s6tj||||||ƒ|j||||ƒdS(N(RSR,(R RR"R-R.R/((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,Òs(R0R1R2R,(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRZÌstSimplePatchShadowcB`s,eZdZddddd„Zd„ZRS(u#A simple shadow via a filled patch.iiþÿÿÿg333333Ó?cK`sƒtt|ƒj|ƒ|dkr.||_ntj|ƒ|_|dkrUd}n||_||_||_ t j ƒ|_ dS(u• Parameters ---------- offset : pair of floats The offset of the shadow in points. shadow_rgbFace : color The shadow color. alpha : float The alpha transparency of the created shadow patch. Default is 0.3. http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rho : float A scale factor to apply to the rgbFace color if `shadow_rgbFace` is not specified. Default is 0.3. **kwargs Extra keywords are stored and passed through to :meth:`AbstractPathEffect._update_gc`. g333333Ó?N( RTR[RRt_shadow_rgbFacetmcolorstto_rgbat_alphat_rhoRUR R t _offset_tran(R Rtshadow_rgbFacetalphatrhoR?((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRÙs       c C`sæ|j||ƒ}|jƒ}|j|ƒ|jdkrz|pCdd \}} } ||j| |j| |jf} n |j} |jdƒ|j|jƒ|j dƒ|j ||j ƒ}|j |||| ƒ|j ƒdS(u€ Overrides the standard draw_path to add the shadow offset and necessary color changes for the shadow. gð?iunoneiN(gð?gð?gð?(RR5RVR\RR`tset_foregroundt set_alphaR_RFR(RUR,RW( R RR"R-R.R/taffine0RXtrtgtbRb((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,s  '   (iiþÿÿÿN(R0R1R2RRR,(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR[×s  (twithSimplePatchShadowcB`seZdZd„ZRS(u„ Adds a simple :class:`SimplePatchShadow` and then draws the original Artist to avoid needing to call :class:`Normal`. cC`s6tj||||||ƒ|j||||ƒdS(N(R[R,(R RR"R-R.R/((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,$s(R0R1R2R,(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRkstSimpleLineShadowcB`s,eZdZddddd„Zd„ZRS(uA simple shadow via a line.iiþÿÿÿukg333333Ó?cK`sntt|ƒj|ƒ|dkr.||_ntj|ƒ|_||_||_||_ t j ƒ|_ dS(u½ Parameters ---------- offset : pair of floats The offset to apply to the path, in points. shadow_color : color The shadow color. Default is black. A value of ``None`` takes the original artist's color with a scale factor of `rho`. alpha : float The alpha transparency of the created shadow patch. Default is 0.3. rho : float A scale factor to apply to the rgbFace color if `shadow_rgbFace` is ``None``. Default is 0.3. **kwargs Extra keywords are stored and passed through to :meth:`AbstractPathEffect._update_gc`. N( RTRlRRt _shadow_colorR]R^R_R`RUR R Ra(R Rt shadow_colorRcRdR?((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR+s     c C`så|j||ƒ}|jƒ}|j|ƒ|jdkr€|jƒpIdd \}} } ||j| |j| |jf} n |j} d} |j| ƒ|j|j ƒ|j ||j ƒ}|j |||| ƒ|j ƒdS(u€ Overrides the standard draw_path to add the shadow offset and necessary color changes for the shadow. gð?iN(gð?gð?gð?(RR5RVRmRtget_foregroundR`ReRfR_R(RUR,RW( R RR"R-R.R/RgRXRhRiRjRbt fill_color((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,Ps  '  (iiþÿÿÿ(R0R1R2RR,(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRl)s$tPathPatchEffectcB`s#eZdZdd„Zd„ZRS(u| Draws a :class:`~matplotlib.patches.PathPatch` instance whose Path comes from the original PathEffect artist. icK`s2tt|ƒjd|ƒtjg||_dS(uŒ Parameters ---------- offset : pair of floats The offset to apply to the path, in points. **kwargs : All keyword arguments are passed through to the :class:`~matplotlib.patches.PathPatch` constructor. The properties which cannot be overridden are "path", "clip_box" "transform" and "clip_path". RN(RTRqRtmpatchest PathPatchtpatch(R RR?((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRrs cC`s}|j||ƒ}||j_|jj|ƒ|jj|jƒƒ|jƒ}|ri|jj|Œn|jj|ƒdS(N( RRtt_patht set_transformt set_clip_boxtget_clip_rectanglet get_clip_patht set_clip_pathtdraw(R RR"R-R.R/t clip_path((s5lib/python2.7/site-packages/matplotlib/patheffects.pyR,s  (ii(R0R1R2RR,(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyRqls (R2t __future__RRRRRtmatplotlib.backend_basesRt matplotlibRR]RRrRR RORR*RRRSRZR[RkRlRq(((s5lib/python2.7/site-packages/matplotlib/patheffects.pyts" :\  G C