Add configuration of Shadow and pie shadow

oscargus · oscargus · commit 23f9569af8b5 · 2023-03-26T16:47:46.000+02:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3126,8 +3126,9 @@ def pie(self, x, explode=None, labels=None, colors=None,
             If set to ``None``, labels are not drawn but are still stored for
             use in `.legend`.
 
-        shadow : bool, default: False
-            Draw a shadow beneath the pie.
+        shadow : bool or dict, default: False
+            If bool, whether to draw a shadow beneath the pie. If dict, draw a shadow
+            passing the properties in the dict to `.Shadow`.
 
         startangle : float, default: 0 degrees
             The angle by which the start of the pie is rotated,
@@ -3255,7 +3256,11 @@ def get_next_color():
             if shadow:
                 # Make sure to add a shadow after the call to add_patch so the
                 # figure and transform props will be set.
-                shad = mpatches.Shadow(w, -0.02, -0.02, label='_nolegend_')
+                shadow_dict = {
+                    'ox': -0.02, 'oy': -0.02, 'shade': 0.3, 'label': '_nolegend_'}
+                if isinstance(shadow, dict):
+                    shadow_dict.update(shadow)
+                shad = mpatches.Shadow(w, **shadow_dict)
                 self.add_patch(shad)
 
             if labeldistance is not None:
diff --git a/lib/matplotlib/patches.py b/lib/matplotlib/patches.py
@@ -615,12 +615,12 @@ def __str__(self):
         return f"Shadow({self.patch})"
 
     @_docstring.dedent_interpd
-    def __init__(self, patch, ox, oy, **kwargs):
+    def __init__(self, patch, ox, oy, *, shade=0.3, **kwargs):
         """
         Create a shadow of the given *patch*.
 
         By default, the shadow will have the same face color as the *patch*,
-        but darkened.
+        but darkened. The darkness can be controlled by *shade*.
 
         Parameters
         ----------
@@ -629,6 +629,9 @@ def __init__(self, patch, ox, oy, **kwargs):
         ox, oy : float
             The shift of the shadow in data coordinates, scaled by a factor
             of dpi/72.
+        shade : float, default: 0.3
+            How the darkness of the shadow relates to the original color. If 0, the
+            shadow is black, if 1, the shadow has the same color as the *patch*.
         **kwargs
             Properties of the shadow patch. Supported keys are:
 
@@ -640,7 +643,9 @@ def __init__(self, patch, ox, oy, **kwargs):
         self._shadow_transform = transforms.Affine2D()
 
         self.update_from(self.patch)
-        color = .3 * np.asarray(colors.to_rgb(self.patch.get_facecolor()))
+        if not 0 <= shade <= 1:
+            raise ValueError("shade must be between 0 and 1.")
+        color = shade * np.asarray(colors.to_rgb(self.patch.get_facecolor()))
         self.update({'facecolor': color, 'edgecolor': color, 'alpha': 0.5,
                      # Place shadow patch directly behind the inherited patch.
                      'zorder': np.nextafter(self.patch.zorder, -np.inf),
