Implement warning for Text3D's rotation/rotation_mode parameters (matplotlib#30600)

Co-authored-by: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>

Author: melwyncarlo

lib/mpl_toolkits/mplot3d/art3d.py

@@ -123,6 +123,16 @@ class Text3D(mtext.Text):
 
     def __init__(self, x=0, y=0, z=0, text='', zdir='z', axlim_clip=False,
                  **kwargs):
+        if 'rotation' in kwargs:
+            _api.warn_external(
+                "The `rotation` parameter has not yet been implemented "
+                "and is currently ignored."
+            )
+        if 'rotation_mode' in kwargs:
+            _api.warn_external(
+                "The `rotation_mode` parameter has not yet been implemented "
+                "and is currently ignored."
+            )
         mtext.Text.__init__(self, x, y, text, **kwargs)
         self.set_3d_properties(z, zdir, axlim_clip)
 

lib/mpl_toolkits/mplot3d/axes3d.py

@@ -1950,6 +1950,16 @@ def text(self, x, y, z, s, zdir=None, *, axlim_clip=False, **kwargs):
         `.Text3D`
             The created `.Text3D` instance.
         """
+        if 'rotation' in kwargs:
+            _api.warn_external(
+                "The `rotation` parameter has not yet been implemented "
+                "and is currently ignored."
+            )
+        if 'rotation_mode' in kwargs:
+            _api.warn_external(
+                "The `rotation_mode` parameter has not yet been implemented "
+                "and is currently ignored."
+            )
         text = super().text(x, y, s, **kwargs)
         art3d.text_2d_to_3d(text, z, zdir, axlim_clip)
         return text