B ]t\;7@sdZddlmZddlmZddlmZddlmZ Gddde Z Gdd d eZ Gd d d e Z Gd d d e ZGdddeZGddde ZGdddeZGddde ZGddde ZdS)z Defines classes for path effects. The path effects are supported in :class:`~matplotlib.text.Text`, :class:`~matplotlib.lines.Line2D` and :class:`~matplotlib.patches.Patch`. ) RendererBase)colors)patches) transformsc@s4eZdZdZd ddZddZddZd d d Zd S)AbstractPathEffectz A base class for path effects. Subclasses should override the ``draw_path`` method to add effect functionality. ggcCs||_t|_dS)z Parameters ---------- offset : pair of floats The offset to apply to the path, measured in points. N)_offset mtransformsAffine2D _offset_trans)selfoffsetr5lib/python3.7/site-packages/matplotlib/patheffects.py__init__szAbstractPathEffect.__init__cCs6||jd}||jd}||j||S)z(Apply the offset to the given transform.r)points_to_pixelsrr clear translate)r renderer transformZoffset_xZoffset_yrrr_offset_transformsz$AbstractPathEffect._offset_transformcCsl|}|dd}|r$|jf|xB|D]6\}}t|d|d}t|s\td|||q.W|S)z 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. dashesNZset_zUnknown property {0})copypopZ set_dashesitemsgetattrcallableAttributeErrorformat)r gcZ new_gc_dictrkvZ set_methodrrr _update_gc&s   zAbstractPathEffect._update_gcNcCs t|tr|j}|||||S)z 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. ) isinstancePathEffectRenderer _renderer draw_path)r rr tpathaffinergbFacerrrr':s zAbstractPathEffect.draw_path)r)N)__name__ __module__ __qualname____doc__rrr#r'rrrrr s  rc@sZeZdZdZddZddZddZdd d Zd d Zd dZ ddZ ddZ ddZ dS)r%ax 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. cCs||_||_dS)z Parameters ---------- path_effects : iterable of :class:`AbstractPathEffect` The path effects which this renderer represents. renderer : :class:`matplotlib.backend_bases.RendererBase` instance N) _path_effectsr&)r path_effectsrrrrrTs zPathEffectRenderer.__init__cCs |jS)N)r&new_gc)r rrrr1`szPathEffectRenderer.new_gccCs|||jS)N) __class__r&)r r0rrrcopy_with_path_effectcsz(PathEffectRenderer.copy_with_path_effectNcCs(x"|jD]}||j||||qWdS)N)r/r'r&)r r r(r)r* path_effectrrrr'fs zPathEffectRenderer.draw_pathc Os`t|jdkr(tj|||||f||Sx2|jD](}||g}|j||||f||q0WdS)Nr)lenr/r draw_markersr3) r r Z marker_pathZ marker_transpathargskwargsr4rrrrr6ks    zPathEffectRenderer.draw_markerscOs\t|jdkr&tj||||f||Sx0|jD]&}||g}|j|||f||q.WdS)Nr)r5r/rdraw_path_collectionr3)r r Zmaster_transformpathsr8r9r4rrrrr:~s    z'PathEffectRenderer.draw_path_collectioncCs |j|S)N)r&r)r Zpointsrrrrsz#PathEffectRenderer.points_to_pixelsc Cs@|||||||\}} |} |d|j||| | ddS)Ng)r*)Z_get_text_path_transformZget_rgb set_linewidthr') r r xysZpropZangleZismathr7rZcolorrrr_draw_text_as_paths    z%PathEffectRenderer._draw_text_as_pathcCs$|dkrt|j|St||SdS)N)Z _text2pathZflipyZheightwidth)rr&object__getattribute__)r namerrrrCs z#PathEffectRenderer.__getattribute__)N) r+r,r-r.rr1r3r'r6r:rr@rCrrrrr%Gs   r%c@seZdZdZdS)Normalz The "identity" PathEffect. The Normal PathEffect's sole purpose is to draw the original artist with no special path effect. N)r+r,r-r.rrrrrEsrEcs*eZdZdZdfdd ZddZZS)Strokez0A line based PathEffect which re-draws a stroke.rrc st|||_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)superr_gc)r r r9)r2rrrs zStroke.__init__cCsH|}|||||j}|||}||||||dS)z0 draw the path with updated gc. N)r1copy_propertiesr#rIrr'restore)r rr r(r)r*gc0Ztransrrrr's   zStroke.draw_path)rG)r+r,r-r.rr' __classcell__rr)r2rrFs rFc@seZdZdZddZdS) withStrokezy Adds a simple :class:`Stroke` and then draws the original Artist to avoid needing to call :class:`Normal`. cCs(t|||||||||||dS)N)rFr')r rr r(r)r*rrrr'szwithStroke.draw_pathN)r+r,r-r.r'rrrrrNsrNcs*eZdZdZd fdd ZddZZS) SimplePatchShadowz#A simple shadow via a filled patch.N333333?c sTt||dkr||_n t||_|dkr4d}||_||_||_t |_ dS)a 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`. Ng333333?) rHr_shadow_rgbFacemcolorsto_rgba_alpha_rhorIr r _offset_tran)r r shadow_rgbFacealpharhor9)r2rrrs  zSimplePatchShadow.__init__c Cs|||}|}|||jdkr\|p.ddd\}} } ||j| |j| |jf} n|j} |d||j|d| ||j }| |||| | dS)z Overrides the standard draw_path to add the shadow offset and necessary color changes for the shadow. N)g?g?g?Znoner) rr1rJrTrXset_foreground set_alpharWr<r#rIr'rK) r rr r(r)r*affine0rLrgbrZrrrr's      zSimplePatchShadow.draw_path)rPNNrS)r+r,r-r.rr'rMrr)r2rrOs (rOc@seZdZdZddZdS)withSimplePatchShadowz Adds a simple :class:`SimplePatchShadow` and then draws the original Artist to avoid needing to call :class:`Normal`. cCs(t|||||||||||dS)N)rOr')r rr r(r)r*rrrr'szwithSimplePatchShadow.draw_pathN)r+r,r-r.r'rrrrrdsrdcs*eZdZdZd fdd ZddZZS) SimpleLineShadowzA simple shadow via a line.rQrRr!333333?c sHt||dkr||_n t||_||_||_||_t |_ dS)a 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) rHr _shadow_colorrUrVrWrXrIr r rY)r r Z shadow_colorr[r\r9)r2rrr&s  zSimpleLineShadow.__init__c Cs|||}|}|||jdkr`|p2ddd\}} } ||j| |j| |jf} n|j} d} || ||j| ||j }| |||| | dS)z Overrides the standard draw_path to add the shadow offset and necessary color changes for the shadow. N)g?g?g?r]) rr1rJrhZget_foregroundrXr^r_rWr#rIr'rK) r rr r(r)r*r`rLrarbrcrZZ fill_colorrrrr'Ks     zSimpleLineShadow.draw_path)rfr!rgrg)r+r,r-r.rr'rMrr)r2rre$s$recs*eZdZdZdfdd ZddZZS)PathPatchEffectz| Draws a :class:`~matplotlib.patches.PathPatch` instance whose Path comes from the original PathEffect artist. rrc 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)rHrmpatchesZ PathPatchpatch)r r r9)r2rrrms zPathPatchEffect.__init__cCsX|||}||j_|j||j||}|rH|jj||j|dS)N) rrl_pathZ set_transformZ set_clip_boxZget_clip_rectangleZ get_clip_pathZ set_clip_pathZdraw)r rr r(r)r*Z clip_pathrrrr'|s   zPathPatchEffect.draw_path)rj)r+r,r-r.rr'rMrr)r2rrigsriN)r.Zmatplotlib.backend_basesrZ matplotlibrrUrrkrr rBrr%rErFrNrOrdrerirrrrs    :\  G C