GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — DOC: Fix mouserotationstyle value for Shoemake's arcball by maaz7409 · Pull Request #32475 · matplotlib/matplotlib

Conversation

@maaz7409

@maaz7409 maaz7409 commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

PR summary

The "Rotation with mouse" section of doc/api/toolkits/mplot3d/view_angles.rst says Ken Shoemake's arcball is selected with mouserotationstyle: Shoemake. That value is rejected:

>>> mpl.rcParams['axes3d.mouserotationstyle'] = 'Shoemake'
ValueError: Key axes3d.mouserotationstyle: 'Shoemake' is not a valid value
for axes3d.mouserotationstyle; supported values are
['azel', 'trackball', 'sphere', 'arcball']

Shoemake was a valid value while #28841 was in review. Commit 89701eb ("Soften the arcball edge using a 'border' parameter") renamed the styles (arcball → sphere, Shoemake → arcball) and updated the validator, but missed this line. So Shoemake was never valid in a release (3.10.0 already rejects it).

The correct value is arcball. That is what the code runs for this style (axes3d.py, the else: # 'arcball' branch), and the rest of the page agrees: the summary table row, the example comment ('azel', 'trackball', 'sphere', or 'arcball') and the paragraph "Both arcballs (mouserotationstyle: sphere and mouserotationstyle: arcball)". The default matplotlibrc and the 3.10 what's new use arcball too.

This PR corrects it.

AI Disclosure

Claude Code (Claude Sonnet 5.5 (high) ) flagged this issue while reviewing docs.

PR quality check

  • Use an expressive title, e.g. "Fix title font property precedence"
  • [N/A] New and changed code is tested
  • [N/A] Plotting related features are demonstrated in an example
  • [N/A] New features and API changes have release notes
  • Documentation complies with general and docstring guidelines

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
@maaz7409
DOC: Fix mouserotationstyle value for Shoemake's arcball
8476077
@github-actions github-actions Bot added the Documentation: API files in lib/ and doc/api label Oct 13, 2026
@QuLogic QuLogic added this to the v3.11.3 milestone Oct 13, 2026
QuLogic
QuLogic approved these changes Oct 13, 2026
View reviewed changes
@QuLogic
QuLogic merged commit 23b5a0d into matplotlib:main Oct 13, 2026
24 checks passed

Uh oh!

There was an error while loading. Please reload this page.

@meeseeksmachine meeseeksmachine mentioned this pull request Oct 13, 2026
Backport PR #32475 on branch v3.11.x (DOC: Fix mouserotationstyle value for Shoemake's arcball) #32476
Merged
iccir pushed a commit that referenced this pull request Oct 14, 2026
@QuLogic @meeseeksmachine
Backport PR #32475: DOC: Fix mouserotationstyle value for Shoemake's …
acd9e69
…arcball
iccir added a commit that referenced this pull request Oct 14, 2026
@iccir
Merge pull request #32476 from meeseeksmachine/auto-backport-of-pr-32…
49caa5d
…475-on-v3.11.x

Backport PR #32475 on branch v3.11.x (DOC: Fix mouserotationstyle value for Shoemake's arcball)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@QuLogic QuLogic QuLogic approved these changes

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

Documentation: API files in lib/ and doc/api

Projects

None yet

Milestone

v3.11.3

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

2 participants

@maaz7409 @QuLogic
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402520 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.