Deprecate point_at_t and document that a BezierSegment can be called

oscargus · oscargus · commit ead211025d96 · 2025-05-18T15:53:39.000+02:00
diff --git a/doc/api/bezier_api.rst b/doc/api/bezier_api.rst
@@ -5,4 +5,5 @@
 .. automodule:: matplotlib.bezier
    :members:
    :undoc-members:
+   :special-members: __call__
    :show-inheritance:
diff --git a/doc/api/next_api_changes/deprecations/30070-OG.rst b/doc/api/next_api_changes/deprecations/30070-OG.rst
@@ -0,0 +1,4 @@
+``BezierSegment.point_at_t``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... is deprecated. Instead, it is possible to call the BezierSegment with an argument.
diff --git a/lib/matplotlib/bezier.py b/lib/matplotlib/bezier.py
@@ -190,6 +190,9 @@ class BezierSegment:
     """
     A d-dimensional Bézier segment.
 
+    A BezierSegment can be called with an argument, either a scalar or an array-like
+    object, to evaluate the curve at that/those location(s).
+
     Parameters
     ----------
     control_points : (N, d) array
@@ -223,6 +226,8 @@ def __call__(self, t):
         return (np.power.outer(1 - t, self._orders[::-1])
                 * np.power.outer(t, self._orders)) @ self._px
 
+    @_api.deprecated(
+        "3.11", alternative="Call the BezierSegment object with an argument.")
     def point_at_t(self, t):
         """
         Evaluate the curve at a single point, returning a tuple of *d* floats.
@@ -336,10 +341,9 @@ def split_bezier_intersecting_with_closedpath(
     """
 
     bz = BezierSegment(bezier)
-    bezier_point_at_t = bz.point_at_t
 
     t0, t1 = find_bezier_t_intersecting_with_closedpath(
-        bezier_point_at_t, inside_closedpath, tolerance=tolerance)
+        lambda t: tuple(bz(t)), inside_closedpath, tolerance=tolerance)
 
     _left, _right = split_de_casteljau(bezier, (t0 + t1) / 2.)
     return _left, _right
