Merge pull request #28201 from AnsonTran/deprecate-get-vector

QuLogic · web-flow · commit 68c87d7cf0da · 2024-05-10T14:12:49.000-04:00
Deprecate `Poly3DCollection.get_vector`
diff --git a/doc/api/next_api_changes/deprecations/28201-AT.rst b/doc/api/next_api_changes/deprecations/28201-AT.rst
@@ -0,0 +1,3 @@
+``Poly3DCollection.get_vector``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+... is deprecated with no replacement.
diff --git a/lib/mpl_toolkits/mplot3d/art3d.py b/lib/mpl_toolkits/mplot3d/art3d.py
@@ -14,7 +14,7 @@
 from contextlib import contextmanager
 
 from matplotlib import (
-    artist, cbook, colors as mcolors, lines, text as mtext,
+    _api, artist, cbook, colors as mcolors, lines, text as mtext,
     path as mpath)
 from matplotlib.collections import (
     Collection, LineCollection, PolyCollection, PatchCollection, PathCollection)
@@ -948,7 +948,11 @@ def set_zsort(self, zsort):
         self._sort_zpos = None
         self.stale = True
 
+    @_api.deprecated("3.10")
     def get_vector(self, segments3d):
+        return self._get_vector(segments3d)
+
+    def _get_vector(self, segments3d):
         """Optimize points for projection."""
         if len(segments3d):
             xs, ys, zs = np.vstack(segments3d).T
@@ -974,7 +978,7 @@ def set_verts(self, verts, closed=True):
             Whether the polygon should be closed by adding a CLOSEPOLY
             connection at the end.
         """
-        self.get_vector(verts)
+        self._get_vector(verts)
         # 2D verts will be updated at draw time
         super().set_verts([], False)
         self._closed = closed

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+``Poly3DCollection.get_vector``
	`2`	`+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~`
	`3`	`+... is deprecated with no replacement.`