66
77from matplotlib import _api
88
9-
9+ @ _api . deprecate ( "3.10" )
1010def world_transformation (xmin ,xmax ,
1111ymin ,ymax ,
1212zmin ,zmax ,pb_aspect = None ):
@@ -37,6 +37,7 @@ def rotation_about_vector(v, angle):
3737return _rotation_about_vector (v ,angle )
3838
3939
40+ @_api .deprecate ("3.10" )
4041def _rotation_about_vector (v ,angle ):
4142"""
4243 Produce a rotation matrix for an angle in radians about a vector.
@@ -93,6 +94,7 @@ def _view_axes(E, R, V, roll):
9394return u ,v ,w
9495
9596
97+ @_api .deprecate ("3.10" )
9698def _view_transformation_uvw (u ,v ,w ,E ):
9799"""
98100 Return the view transformation matrix.
@@ -142,6 +144,7 @@ def persp_transformation(zfront, zback, focal_length):
142144return _persp_transformation (zfront ,zback ,focal_length )
143145
144146
147+ @_api .deprecate ("3.10" )
145148def _persp_transformation (zfront ,zback ,focal_length ):
146149e = focal_length
147150a = 1 # aspect ratio
@@ -159,6 +162,7 @@ def ortho_transformation(zfront, zback):
159162return _ortho_transformation (zfront ,zback )
160163
161164
165+ @_api .deprecate ("3.10" )
162166def _ortho_transformation (zfront ,zback ):
163167# note: w component in the resulting vector will be (zback-zfront), not 1
164168a = - (zfront + zback )
@@ -170,6 +174,7 @@ def _ortho_transformation(zfront, zback):
170174return proj_matrix
171175
172176
177+ @_api .deprecate ("3.10" )
173178def _proj_transform_vec (vec ,M ):
174179vecw = np .dot (M ,vec )
175180w = vecw [3 ]
@@ -178,6 +183,7 @@ def _proj_transform_vec(vec, M):
178183return txs ,tys ,tzs
179184
180185
186+ @_api .deprecate ("3.10" )
181187def _proj_transform_vec_clip (vec ,M ):
182188vecw = np .dot (M ,vec )
183189w = vecw [3 ]
@@ -189,6 +195,7 @@ def _proj_transform_vec_clip(vec, M):
189195return txs ,tys ,tzs ,tis
190196
191197
198+ @_api .deprecate ("3.10" )
192199def inv_transform (xs ,ys ,zs ,invM ):
193200"""
194201 Transform the points by the inverse of the projection matrix, *invM*.
@@ -203,10 +210,12 @@ def inv_transform(xs, ys, zs, invM):
203210return vecr [0 ],vecr [1 ],vecr [2 ]
204211
205212
213+ @_api .deprecate ("3.10" )
206214def _vec_pad_ones (xs ,ys ,zs ):
207215return np .array ([xs ,ys ,zs ,np .ones_like (xs )])
208216
209217
218+ @_api .deprecate ("3.10" )
210219def proj_transform (xs ,ys ,zs ,M ):
211220"""
212221 Transform the points by the projection matrix *M*.
@@ -220,6 +229,7 @@ def proj_transform(xs, ys, zs, M):
220229alternative = "proj_transform" )(proj_transform )
221230
222231
232+ @_api .deprecate ("3.10" )
223233def proj_transform_clip (xs ,ys ,zs ,M ):
224234"""
225235 Transform the points by the projection matrix
@@ -235,6 +245,7 @@ def proj_points(points, M):
235245return _proj_points (points ,M )
236246
237247
248+ @_api .deprecate ("3.10" )
238249def _proj_points (points ,M ):
239250return np .column_stack (_proj_trans_points (points ,M ))
240251
@@ -244,6 +255,7 @@ def proj_trans_points(points, M):
244255return _proj_trans_points (points ,M )
245256
246257
258+ @_api .deprecate ("3.10" )
247259def _proj_trans_points (points ,M ):
248260xs ,ys ,zs = zip (* points )
249261return proj_transform (xs ,ys ,zs ,M )