Merge branch '3d_dynamic_masking' of github.com:scottshambaugh/matplotlib into 3d_dynamic_masking

scottshambaugh · scottshambaugh · commit d1c41de15d6b · 2024-08-31T08:34:57.000-06:00
diff --git a/doc/missing-references.json b/doc/missing-references.json
@@ -324,8 +324,8 @@
       "lib/matplotlib/quiver.py:docstring of matplotlib.artist.Quiver.set:45",
       "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Barbs:212",
       "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Quiver:251",
-      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of matplotlib.artist.Path3DCollection.set:49",
-      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of matplotlib.artist.Poly3DCollection.set:47"
+      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of matplotlib.artist.Path3DCollection.set:47",
+      "lib/mpl_toolkits/mplot3d/art3d.py:docstring of matplotlib.artist.Poly3DCollection.set:45"
     ],
     "matplotlib.collections._MeshData.set_array": [
       "lib/matplotlib/axes/_axes.py:docstring of matplotlib.axes._axes.Axes.pcolormesh:164",
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -1902,6 +1902,8 @@ def text(self, x, y, z, s, zdir=None, *, axlim_clip=False, **kwargs):
             See `.get_dir_vector` for a description of the values.
         axlim_clip : bool, default: False
             Whether to hide text that is outside the axes view limits.
+
+            .. versionadded:: 3.10
         **kwargs
             Other arguments are forwarded to `matplotlib.axes.Axes.text`.
 
@@ -1934,6 +1936,8 @@ def plot(self, xs, ys, *args, zdir='z', axlim_clip=False, **kwargs):
             When plotting 2D data, the direction to use as z.
         axlim_clip : bool, default: False
             Whether to hide data that is outside the axes view limits.
+
+            .. versionadded:: 3.10
         **kwargs
             Other arguments are forwarded to `matplotlib.axes.Axes.plot`.
         """
@@ -1972,6 +1976,8 @@ def fill_between(self, x1, y1, z1, x2, y2, z2, *,
         polygons that are filled. All points must be the same length N, or a
         single value to be used for all points.
 
+        .. versionadded:: 3.10
+
         Parameters
         ----------
         x1, y1, z1 : float or 1D array-like
@@ -2012,6 +2018,8 @@ def fill_between(self, x1, y1, z1, x2, y2, z2, *,
         axlim_clip : bool, default: False
             Whether to hide data that is outside the axes view limits.
 
+            .. versionadded:: 3.10
+
         **kwargs
             All other keyword arguments are passed on to `.Poly3DCollection`.
 
@@ -2157,6 +2165,8 @@ def plot_surface(self, X, Y, Z, *, norm=None, vmin=None,
         axlim_clip : bool, default: False
             Whether to hide patches with a vertex outside the axes view limits.
 
+            .. versionadded:: 3.10
+
         **kwargs
             Other keyword arguments are forwarded to `.Poly3DCollection`.
         """
@@ -2305,6 +2315,8 @@ def plot_wireframe(self, X, Y, Z, *, axlim_clip=False, **kwargs):
             Whether to hide lines and patches with vertices outside the axes
             view limits.
 
+            .. versionadded:: 3.10
+
         rcount, ccount : int
             Maximum number of samples used in each direction.  If the input
             data is larger, it will be downsampled (by slicing) to these
@@ -2452,6 +2464,8 @@ def plot_trisurf(self, *args, color=None, norm=None, vmin=None, vmax=None,
             The lightsource to use when *shade* is True.
         axlim_clip : bool, default: False
             Whether to hide patches with a vertex outside the axes view limits.
+
+            .. versionadded:: 3.10
         **kwargs
             All other keyword arguments are passed on to
             :class:`~mpl_toolkits.mplot3d.art3d.Poly3DCollection`
@@ -2595,6 +2609,8 @@ def contour(self, X, Y, Z, *args,
             position in a plane normal to *zdir*.
         axlim_clip : bool, default: False
             Whether to hide lines with a vertex outside the axes view limits.
+
+            .. versionadded:: 3.10
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
@@ -2642,6 +2658,8 @@ def tricontour(self, *args,
             position in a plane normal to *zdir*.
         axlim_clip : bool, default: False
             Whether to hide lines with a vertex outside the axes view limits.
+
+            .. versionadded:: 3.10
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
         *args, **kwargs
@@ -2699,6 +2717,8 @@ def contourf(self, X, Y, Z, *args,
             position in a plane normal to *zdir*.
         axlim_clip : bool, default: False
             Whether to hide lines with a vertex outside the axes view limits.
+
+            .. versionadded:: 3.10
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
         *args, **kwargs
@@ -2739,6 +2759,8 @@ def tricontourf(self, *args, zdir='z', offset=None, axlim_clip=False, **kwargs):
             position in a plane normal to zdir.
         axlim_clip : bool, default: False
             Whether to hide lines with a vertex outside the axes view limits.
+
+            .. versionadded:: 3.10
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
         *args, **kwargs
@@ -2797,6 +2819,8 @@ def add_collection3d(self, col, zs=0, zdir='z', autolim=True, *,
             Whether to update the data limits.
         axlim_clip : bool, default: False
             Whether to hide the scatter points outside the axes view limits.
+
+            .. versionadded:: 3.10
         """
         had_data = self.has_data()
 
@@ -2878,6 +2902,8 @@ def scatter(self, xs, ys,
             independently.
         axlim_clip : bool, default: False
             Whether to hide the scatter points outside the axes view limits.
+
+            .. versionadded:: 3.10
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
         **kwargs
@@ -2937,6 +2963,8 @@ def bar(self, left, height, zs=0, zdir='z', *args,
             When plotting 2D data, the direction to use as z ('x', 'y' or 'z').
         axlim_clip : bool, default: False
             Whether to hide bars with points outside the axes view limits.
+
+            .. versionadded:: 3.10
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
         **kwargs
@@ -3029,6 +3057,8 @@ def bar3d(self, x, y, z, dx, dy, dz, color=None,
         axlim_clip : bool, default: False
             Whether to hide the bars with points outside the axes view limits.
 
+            .. versionadded:: 3.10
+
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
@@ -3187,6 +3217,8 @@ def quiver(self, X, Y, Z, U, V, W, *,
         axlim_clip : bool, default: False
             Whether to hide arrows with points outside the axes view limits.
 
+            .. versionadded:: 3.10
+
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
@@ -3328,6 +3360,8 @@ def voxels(self, *args, facecolors=None, edgecolors=None, shade=True,
         axlim_clip : bool, default: False
             Whether to hide voxels with points outside the axes view limits.
 
+            .. versionadded:: 3.10
+
         **kwargs
             Additional keyword arguments to pass onto
             `~mpl_toolkits.mplot3d.art3d.Poly3DCollection`.
@@ -3576,6 +3610,8 @@ def errorbar(self, x, y, z, zerr=None, yerr=None, xerr=None, fmt='',
         axlim_clip : bool, default: False
             Whether to hide error bars that are outside the axes limits.
 
+            .. versionadded:: 3.10
+
         Returns
         -------
         errlines : list
@@ -3893,6 +3929,8 @@ def stem(self, x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-',
         axlim_clip : bool, default: False
             Whether to hide stems that are outside the axes limits.
 
+            .. versionadded:: 3.10
+
         data : indexable object, optional
             DATA_PARAMETER_PLACEHOLDER
 
