o i 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 ddZddZddZd d d Zd S)AbstractPathEffectz A base class for path effects. Subclasses should override the ``draw_path`` method to add effect functionality. rcCs ||_dS)z Parameters ---------- offset : pair of floats The offset to apply to the path, measured in points. N)_offset)selfoffsetr Q/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/matplotlib/patheffects.py__init__s zAbstractPathEffect.__init__cCstjt|j|jS)z(Apply the offset to the given transform.) mtransformsAffine2D translatemappoints_to_pixelsr )r rendererr r r _offset_transform s z$AbstractPathEffect._offset_transformcCsl|}|dd}|r|jdi||D]\}}t|d|d}t|s/td|||q|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. dashesNset_zUnknown property {0}r )copypop set_dashesitemsgetattrcallableAttributeErrorformat)r gc new_gc_dictrkv set_methodr r r _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_pathr rr tpathaffinergbFacer r r r)9s zAbstractPathEffect.draw_path)rN)__name__ __module__ __qualname____doc__rrr%r)r r r r rs   rc@sJeZdZdZddZddZdddZd d Zd d Zd dZ ddZ dS)r'aw 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 : `matplotlib.backend_bases.RendererBase` subclass N) _path_effectsr()r path_effectsrr r r rSs zPathEffectRenderer.__init__cCs|||jSr.) __class__r()r r4r r r copy_with_path_effect_sz(PathEffectRenderer.copy_with_path_effectNcCs$|jD] }||j||||qdSr.)r3r)r()r r r+r,r- path_effectr r r r)bs zPathEffectRenderer.draw_pathc Osht|jdkrtj|||||g|Ri|S|jD]}||g}|j||||g|Ri|qdSN)lenr3r draw_markersr6) r r marker_path marker_transpathargskwargsr7rr r r r;gs    zPathEffectRenderer.draw_markerscOsdt|jdkrtj||||g|Ri|S|jD]}||g}|j|||g|Ri|qdSr8)r:r3rdraw_path_collectionr6)r r master_transformpathsr?r@r7rr r r rAzs    z'PathEffectRenderer.draw_path_collectionc Cs@|||||||\}} |} |d|j||| | ddS)Nr)r-)_get_text_path_transformget_rgb set_linewidthr)) r r xyspropangleismathr> transformcolorr r r _draw_text_as_paths  z%PathEffectRenderer._draw_text_as_pathcCs |dvr t|j|St||S)N)flipyget_canvas_width_heightnew_gcr _text2pathheightwidth)rr(object__getattribute__)r namer r r rWs  z#PathEffectRenderer.__getattribute__r.) r/r0r1r2rr6r)r;rArOrWr r r r r'Fs   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/r0r1r2r r r r rYsrYcCs\Gddd|}d|j|_d|j|_d|jd|jd|jd|_|jj|j_|S)zO Create a PathEffect class combining *effect_class* and a normal draw. cseZdZfddZZS)z)_subclass_with_normal..withEffectcs(t||||||||||dSr.)superr)r*r5r r r)sz3_subclass_with_normal..withEffect.draw_path)r/r0r1r) __classcell__r r r[r withEffectsr]withz* 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/r1r2r)) effect_classr]r r r _subclass_with_normals r`c*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)rZr_gcr r r@r[r r rs  zStroke.__init__cCsF|}|||||j}||||||||dS)zDraw the path with updated gc.N)rRcopy_propertiesr%rdr)rrestore)r rr r+r,r-gc0r r r r)s  zStroke.draw_pathrcr/r0r1r2rr)r\r r r[r rbs rb)r_cs0eZdZdZ   d fdd ZddZZS) SimplePatchShadowz#A simple shadow via a filled patch.N333333?c sJt||dur||_nt||_|durd}||_||_||_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`. Nro)rZr_shadow_rgbFacemcolorsto_rgba_alpha_rhord)r r shadow_rgbFacealpharhor@r[r r rs   zSimplePatchShadow.__init__c Cs|}|||jdur(|pddd\}}} ||j||j| |jf} n|j} |d||j|d|||j }| |||| || | dS) Overrides the standard draw_path to add the shadow offset and necessary color changes for the shadow. N?rzrznoner) rRrfrprtset_foreground set_alpharsrFr%rdr)rrg r rr r+r,r-rhrgbrur r r r)s      zSimplePatchShadow.draw_path)rlNNrorjr r r[r rks%rkcs.eZdZdZ  d fdd ZddZZS) SimpleLineShadowzA simple shadow via a line.rlr"roc s>t||dur||_nt||_||_||_||_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)rZr _shadow_colorrqrrrsrtrd)r r shadow_colorrvrwr@r[r r r%s   zSimpleLineShadow.__init__c Cs|}|||jdur*|pddd\}}} ||j||j| |jf} n|j} || ||j|||j }| |||| || dS)rxNryr{) rRrfrget_foregroundrtr}r~rsr%rdr)rrgrr r r r)Cs     zSimpleLineShadow.draw_path)rlr"rororjr r r[r r"s rcra)PathPatchEffectza Draws a `.PathPatch` instance whose Path comes from the original PathEffect artist. rcc s&tj|dtjgfi||_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)rZrmpatches PathPatchpatchrer[r r ras zPathPatchEffect.__init__cCsV||j_|j||||j||}|r#|jj||j|dSr.) r_path set_transformr set_clip_boxget_clip_rectangle get_clip_path set_clip_pathdraw)r rr r+r,r- clip_pathr r r r)ps zPathPatchEffect.draw_pathrirjr r r[r r[srN)r2matplotlib.backend_basesr matplotlibrrqrrrrrr'rYr`rb withStrokerkwithSimplePatchShadowrrr r r r s    7W   B9