77from matplotlib import _api
88
99
10+ @_api .deprecated ("3.10" )
1011def world_transformation (xmin ,xmax ,
1112ymin ,ymax ,
1213zmin ,zmax ,pb_aspect = None ):
@@ -37,6 +38,7 @@ def rotation_about_vector(v, angle):
3738return _rotation_about_vector (v ,angle )
3839
3940
41+ @_api .deprecated ("3.10" )
4042def _rotation_about_vector (v ,angle ):
4143"""
4244 Produce a rotation matrix for an angle in radians about a vector.
@@ -93,6 +95,7 @@ def _view_axes(E, R, V, roll):
9395return u ,v ,w
9496
9597
98+ @_api .deprecated ("3.10" )
9699def _view_transformation_uvw (u ,v ,w ,E ):
97100"""
98101 Return the view transformation matrix.
@@ -142,6 +145,7 @@ def persp_transformation(zfront, zback, focal_length):
142145return _persp_transformation (zfront ,zback ,focal_length )
143146
144147
148+ @_api .deprecated ("3.10" )
145149def _persp_transformation (zfront ,zback ,focal_length ):
146150e = focal_length
147151a = 1 # aspect ratio
@@ -159,6 +163,7 @@ def ortho_transformation(zfront, zback):
159163return _ortho_transformation (zfront ,zback )
160164
161165
166+ @_api .deprecated ("3.10" )
162167def _ortho_transformation (zfront ,zback ):
163168# note: w component in the resulting vector will be (zback-zfront), not 1
164169a = - (zfront + zback )
@@ -170,6 +175,7 @@ def _ortho_transformation(zfront, zback):
170175return proj_matrix
171176
172177
178+ @_api .deprecated ("3.10" )
173179def _proj_transform_vec (vec ,M ):
174180vecw = np .dot (M ,vec )
175181w = vecw [3 ]
@@ -178,6 +184,7 @@ def _proj_transform_vec(vec, M):
178184return txs ,tys ,tzs
179185
180186
187+ @_api .deprecated ("3.10" )
181188def _proj_transform_vec_clip (vec ,M ):
182189vecw = np .dot (M ,vec )
183190w = vecw [3 ]
@@ -189,6 +196,7 @@ def _proj_transform_vec_clip(vec, M):
189196return txs ,tys ,tzs ,tis
190197
191198
199+ @_api .deprecated ("3.10" )
192200def inv_transform (xs ,ys ,zs ,invM ):
193201"""
194202 Transform the points by the inverse of the projection matrix, *invM*.
@@ -203,10 +211,12 @@ def inv_transform(xs, ys, zs, invM):
203211return vecr [0 ],vecr [1 ],vecr [2 ]
204212
205213
214+ @_api .deprecated ("3.10" )
206215def _vec_pad_ones (xs ,ys ,zs ):
207216return np .array ([xs ,ys ,zs ,np .ones_like (xs )])
208217
209218
219+ @_api .deprecated ("3.10" )
210220def proj_transform (xs ,ys ,zs ,M ):
211221"""
212222 Transform the points by the projection matrix *M*.
@@ -220,6 +230,7 @@ def proj_transform(xs, ys, zs, M):
220230alternative = "proj_transform" )(proj_transform )
221231
222232
233+ @_api .deprecated ("3.10" )
223234def proj_transform_clip (xs ,ys ,zs ,M ):
224235"""
225236 Transform the points by the projection matrix
@@ -235,6 +246,7 @@ def proj_points(points, M):
235246return _proj_points (points ,M )
236247
237248
249+ @_api .deprecated ("3.10" )
238250def _proj_points (points ,M ):
239251return np .column_stack (_proj_trans_points (points ,M ))
240252
@@ -244,6 +256,7 @@ def proj_trans_points(points, M):
244256return _proj_trans_points (points ,M )
245257
246258
259+ @_api .deprecated ("3.10" )
247260def _proj_trans_points (points ,M ):
248261xs ,ys ,zs = zip (* points )
249262return proj_transform (xs ,ys ,zs ,M )