mdn / mdn/content

The figure doesn't show the direction of rotation

Open
#41,549 6 comments 0 reactions 0 assignees View on GitHub
Content:WebAPI
Dominant language
Markdown
Stars
11k
Forks
23.2k
Avg merge
2d 9h
Merged PRs (30d)
331

Description

### MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/rotate

### What specific section or headline is this issue about?

Syntax

### What information was incorrect, unhelpful, or incomplete?

The function `rotate(angle)` rotates (presumably) "in clockwise direction".
However, the angle shown in the diagram has arrows in both directions.
[Also the angle is suddenly called `alpha` instead of `angle`.]

However, since the coordinate system uses a flipped y-axis,
it is no longer obvious which way "in clockwise direction" is.

The explanation and diagram needs to match.
One way of getting rid of "clockwise" is to talk about rotating the x-axis towards the y-axis
in the direction where the rotation is least.

### What did you expect to see?

An angle indication with only one arrow.

### Do you have any supporting links, references, or citations?

Wikiepedia has a pate on "angular displacement".

https://en.wikipedia.org/wiki/Angular_displacement

Note that they are using a standard, righthanded coordinate system,
so their "clockwise" doesn't match yours "clockwise".

### Do you have anything more you want to share?

_No response_

### MDN metadata

Page report details

* Folder: `en-us/web/api/canvasrenderingcontext2d/rotate`
* MDN URL: https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/rotate
* GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/api/canvasrenderingcontext2d/rotate/index.md
* Last commit: https://github.com/mdn/content/commit/a7265fc3effa7c25b9997135104370c057a65293
* Document last modified: 2025-09-25T16:11:52.000Z

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.