Skip to content

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

Merged
timhoffm merged 5 commits into
matplotlib:mainfrom
melwyncarlo:issue_30563
Dec 18, 2025
Merged

Implement warning for Text3D's rotation/rotation_mode parameters#30600
timhoffm merged 5 commits into
matplotlib:mainfrom
melwyncarlo:issue_30563

Conversation

@melwyncarlo

Copy link
Copy Markdown
Contributor

PR summary

Currently, the rotation and rotation_mode parameters are ignored for the Text3D class.
This affects code that accesses the class directly, as well as via the Axes3D.text function.

There is no implementation for the true 3D rotation of text in the current codebase.
It only rotates the text about the axis going through the display screen (set via the zdir parameter).
Implementing it is a serious undertaking which can't be achieved in a short matter of time.

Nevertheless, the parameters for it do exist in the public API which confuses users when they don't work as intended.
Therefore, a warning would be beneficial to warn the user about those two parameters being ignored/unimplemented.

This issue provisionally closes #30563.

Comment thread lib/mpl_toolkits/mplot3d/art3d.py Outdated
Comment thread lib/mpl_toolkits/mplot3d/art3d.py Outdated
Comment thread lib/mpl_toolkits/mplot3d/art3d.py Outdated
@QuLogic QuLogic changed the title Unimplemented warning for Text3D's rotation/rotation_mode parameters Implement warning for Text3D's rotation/rotation_mode parameters Sep 26, 2025
@scottshambaugh

Copy link
Copy Markdown
Contributor

Hi @melwyncarlo, are you still interested in working on this PR? It looks like only a one-line change is needed to get it in a good state.

@timhoffm

Copy link
Copy Markdown
Member

I've just committed the change. We don't have to go through review cycles to fix an unused import.

@timhoffm timhoffm merged commit 57ad96d into matplotlib:main Dec 18, 2025
32 of 38 checks passed
@QuLogic QuLogic added this to the v3.11.0 milestone Dec 19, 2025
andreas16700 added a commit to andreas16700/matplotlib that referenced this pull request Jan 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: 3D text does not respect rotation to make it parallel with a given zdir axis

4 participants