大网数据广告活动
Web 标准与前端开发

CanvasRenderingContext2D:rotate() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.rotate()`** 方法用于在变换矩阵中增加旋转。

Canvas 2D API 的 CanvasRenderingContext2D.rotate() 方法用于在变换矩阵中增加旋转。

语法

rotate(angle)

横坐标轴按 alpha 角旋转的直角坐标系

参数

  • angle
    • : 顺时针旋转的弧度。如果你想通过角度值计算,可以使用公式: degree * Math.PI / 180 。

旋转中心点一直是 canvas 的原点。如果想改变中心点,你可以通过 CanvasRenderingContext2D.translate 方法移动画布。

返回值

无(undefined)。

示例

旋转形状

此示例将矩形旋转了 45°。注意,旋转的中心是画布的左上角,而不是相对于任何形状的位置。

HTML

<canvas id="canvas"></canvas>

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

// 变换原点
ctx.arc(0, 0, 5, 0, 2 * Math.PI);
ctx.fillStyle = "blue";
ctx.fill();

// 未旋转的矩形
ctx.fillStyle = "gray";
ctx.fillRect(100, 0, 80, 20);

// 旋转的矩形
ctx.rotate((45 * Math.PI) / 180);
ctx.fillStyle = "red";
ctx.fillRect(100, 0, 80, 20);

// 将变换矩阵重置为单位矩阵
ctx.setTransform(1, 0, 0, 1, 0, 0);

结果

旋转中心是蓝色的。未旋转的矩形为灰色,而旋转后的矩形为红色。

旋转形状

围绕中心旋转形状

此示例围绕形状的中心点旋转一个形状。为此,矩阵应用以下步骤:

  1. 首先,CanvasRenderingContext2D.translate() 将矩阵的原点移动到形状的中心。
  2. rotate() 按所需的角度旋转矩阵。
  3. 最后,translate() 将矩阵的原点移回到其起始点。这是通过应用形状中心坐标值相反数来完成的。

HTML

<canvas id="canvas"></canvas>

JavaScript

该形状是一个矩形,其角落在 (80, 60),宽度为 140,高度为 30。其水平中心位于 (80 + 140 / 2),即 150。其垂直中心位于 (60 + 30 / 2),即 75。因此,中心点在 (150, 75)。

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

// 未旋转的矩形
ctx.fillStyle = "gray";
ctx.fillRect(80, 60, 140, 30);

// 矩阵变换
ctx.translate(150, 75);
ctx.rotate(Math.PI / 2);
ctx.translate(-150, -75);

// 旋转后的矩形
ctx.fillStyle = "red";
ctx.fillRect(80, 60, 140, 30);

结果

未旋转的矩形是灰色的,旋转后的矩形是红色的。

围绕中心旋转形状

规范

浏览器兼容性

参见

  • 定义此方法的接口:CanvasRenderingContext2D

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。