Removed documentation tag, because as of now this also changes the function signature.

IMHO the correct way forward would be to create similar data setters for all Artists.

I don't think this is exactly what you mean but see also:#19573

I'm sceptical on the default zdir.

It works when using the default zdir='z' at artist creation time, but can be surprising otherwise. Note that not specifying zdir in set_3d_properties in the second plot rotates the data.

That's a compelling example. Note that many of the other artistsset_3d_properties do default tozdir='z' so perhaps it is those that should be changed?

Text3D does it almost right:

Why almost? What more would you want there? Privatizingset_3d_properties?

For now I removed the addition of default argument forzdir. But something probably should be done about the inconsistency of the variousset_3d_properties function signatures. Though what is not clear to me.

One other thing that this PR should definitely do make sure all of theset_3d_properties have docstrings (ideally similar ones) so that I don't become culpable for the aforementioned inconsistency.

But for that I think there should be a consistent phrase used to describezdir. I didn't add one because I'm confused by what it should be, and as I noted in#19573 (comment) there are several different descriptions of it already floating around.

Text3D does it almost right:

Why almost? What more would you want there? Privatizingset_3d_properties?

IIRC that and not having a defaultzdir='z' onset_3d_properties().

But something probably should be done about the inconsistency of the various set_3d_properties function signatures. Though what is not clear to me.

Let's make them private first. Otherwise, this will become quite a song and dance with deprecations.

But that'S is for a separate PR.

But for that I think there should be a consistent phrase used to describezdir. I didn't add one because I'm confused by what it should be, and as I noted in#19573 (comment) there are several different descriptions of it already floating around.

We promote artists from 2D to 3D by adding a dimension.zdir defines how that is done. The effect is most obvious for artists that do not have a real third dimension, e.g. the bars inhttps://matplotlib.org/devdocs/gallery/mplot3d/bars3d.html. Thezdir is the normal to the plane in which this 2D-representation is drawn. Forbar(x, y, z) the first two values are interpreted in this 2D subspace, the third value defines the position of that 2D-image alongzdir. That means that forzdir='x', the valuesx, y are on the axis-plane yz.

Special caseLine3D: As this is not pseudo-3D, there should usually not be a reason to use a differentzdir. But it might be helpful if you plot it along with other data, e.g.bar(x, y, z, zdir='x'); plot(x, y, z, zdir='x').

Special caseText3D: The text direction is in the plane normal tozdir. The characters are rendered along the text direction, but always facing the camera; i.e. you cannot look at the text "from the side/back".

Since this Pull Request has not been updated in 60 days, it has been marked "inactive." This does not mean that it will be closed, though it may be moved to a "Draft" state. This helps maintainers prioritize their reviewing efforts. You can pick the PR back up anytime - please ping us if you need a review or guidance to move the PR forward! If you do not plan on continuing the work, please let us know so that we can either find someone to take the PR over, or close it.

The docstring here was added in#23536, so closing this PR. Thank you for the initial work on this!