3 ƽh 5@sdZddlmZddlmZddlmZddlmZ GdddZ Gdd d eZ Gd d d e Z d d Z Gddde Ze edZGddde Ze edZGddde ZGddde ZdS)z Defines classes for path effects. The path effects are supported in `~.Text`, `~.Line2D` and `~.Patch`. .. seealso:: :doc:`/tutorials/advanced/patheffects_guide` ) RendererBase)colors)patches) transformsc@s4eZdZdZd ddZddZddZdd d Zd S)AbstractPathEffectz A base class for path effects. Subclasses should override the ``draw_path`` method to add effect functionality. cCs ||_dS)z Parameters ---------- offset : pair of floats The offset to apply to the path, measured in points. N)_offset)selfoffsetr .withEffectcs(tj||||||j||||dS)N)superr$)r rrr%r&r')r/r r r$sz3_subclass_with_normal..withEffect.draw_path)r)r*r+r$ __classcell__r r )r/r withEffectsrMwithz* A shortcut PathEffect for applying `.z` and then drawing the original Artist. With this class you can use :: artist.set_path_effects([path_effects.withzN()]) as a shortcut for :: artist.set_path_effects([path_effects.zA(), path_effects.Normal()]) )r)r+r,r$) effect_classrMr r r _subclass_with_normals   rPcs*eZdZdZdfdd ZddZZS) Strokez0A line based PathEffect which re-draws a stroke.rc stj|||_dS)z 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)rKr _gc)r r r7)r/r r r s zStroke.__init__cCsF|j}|j||j||j}|j||||j|||jdS)zDraw the path with updated gc.N)rCcopy_propertiesr rRr$rrestore)r rrr%r&r'gc0r r r r$s  zStroke.draw_pathrr)rV)r)r*r+r,r r$rLr r )r/r rQs rQ)rOcs*eZdZdZd fdd ZddZZS) SimplePatchShadowz#A simple shadow via a filled patch.N333333?c sJtj||dkr||_n tj||_|dkr4d}||_||_||_dS)a Parameters ---------- offset : pair of floats The offset of the shadow in points. shadow_rgbFace : color The shadow color. alpha : float, default: 0.3 The alpha transparency of the created shadow patch. http://matplotlib.1069221.n5.nabble.com/path-effects-question-td27630.html rho : float, default: 0.3 A scale factor to apply to the rgbFace color if `shadow_rgbFace` is not specified. **kwargs Extra keywords are stored and passed through to :meth:`AbstractPathEffect._update_gc`. Ng333333?)rKr _shadow_rgbFacemcolorsto_rgba_alpha_rhorR)r r shadow_rgbFacealpharhor7)r/r r r s  zSimplePatchShadow.__init__c Cs|j}|j||jdkrP|p"ddd\}}} ||j||j| |jf} n|j} |jd|j|j|jd|j||j }|j ||||j || |j dS)z Overrides the standard draw_path to add the shadow offset and necessary color changes for the shadow. N?noner)rbrbrb) rCrSrZr^set_foreground set_alphar]r:r rRr$rrT) r rrr%r&r'rUrgbr_r r r r$s     zSimplePatchShadow.draw_pathrXrj)rkNNrY)r)r*r+r,r r$rLr r )r/r rWs #rWcs*eZdZdZd fdd ZddZZS) SimpleLineShadowzA simple shadow via a line.rXr333333?c s>tj||dkr||_n tj||_||_||_||_dS)a Parameters ---------- offset : pair of floats The offset to apply to the path, in points. shadow_color : color, default: 'black' The shadow color. A value of ``None`` takes the original artist's color with a scale factor of *rho*. alpha : float, default: 0.3 The alpha transparency of the created shadow patch. rho : float, default: 0.3 A scale factor to apply to the rgbFace color if `shadow_rgbFace` is ``None``. **kwargs Extra keywords are stored and passed through to :meth:`AbstractPathEffect._update_gc`. N)rKr _shadow_colorr[r\r]r^rR)r r Z shadow_colorr`rar7)r/r r r %s  zSimpleLineShadow.__init__c Cs|j}|j||jdkrT|jp&ddd\}}} ||j||j| |jf} n|j} |j| |j|j|j||j }|j ||||j ||j dS)z Overrides the standard draw_path to add the shadow offset and necessary color changes for the shadow. N?rc)rororo) rCrSrnZget_foregroundr^rerfr]r rRr$rrT) r rrr%r&r'rUrgrhrir_r r r r$Cs    zSimpleLineShadow.draw_pathrjrXrj)rprrmrm)r)r*r+r,r r$rLr r )r/r rl"srlcs*eZdZdZdfdd ZddZZS) PathPatchEffectza Draws a `.PathPatch` instance whose Path comes from the original PathEffect artist. rc s"tj|dtjgf||_dS)a 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". )r N)rKr mpatchesZ PathPatchpatch)r r r7)r/r r r as zPathPatchEffect.__init__cCsV||j_|jj||j||jj|j|j}|rF|jj||jj|dS)N) rs_pathZ set_transformrZ set_clip_boxZget_clip_rectangleZ get_clip_pathZ set_clip_pathZdraw)r rrr%r&r'Z clip_pathr r r r$ps zPathPatchEffect.draw_pathrr)ru)r)r*r+r,r r$rLr r )r/r rq[srqN)r,Zmatplotlib.backend_basesrZ matplotlibrr[rrrrrrr"rJrPrQZ withStrokerWZwithSimplePatchShadowrlrqr r r r s    7W  B 9