CanvasRenderingContext2D
.arc()
是 Canvas 2D API 绘制圆弧路径的方法。 圆弧路径的圆心在 (x, y) 位置,半径为 r ,根据anticlockwise (默认为顺时针)指定的方向从 startAngle 开始绘制,到 endAngle 结束。
语法
void ctx.arc(x, y, radius, startAngle, endAngle, anticlockwise);
Parameters
x
- 圆弧中心(圆心)的 x 轴坐标。
y
- 圆弧中心(圆心)的 y 轴坐标。
radius
- 圆弧的半径。
startAngle
- 圆弧的起始点, x轴方向开始计算,单位以弧度表示。
endAngle
- 圆弧的终点, 单位以弧度表示。
anticlockwise
可选- 可选的
Boolean
值 ,如果为true
,逆时针绘制圆弧,反之,顺时针绘制。
示例
使用 arc
方法
这是一段绘制圆的简单的代码片段。
HTML
<canvas id="canvas"></canvas>
JavaScript
var canvas = document.getElementById("canvas"); var ctx = canvas.getContext("2d"); ctx.beginPath(); ctx.arc(75, 75, 50, 0, 2 * Math.PI); ctx.stroke();
修改下面的代码并在线查看 canvas 的变化:
不同的形状演示
在此例中,使用 arc() 尽可能地绘制不同的形状。
var canvas = document.getElementById('canvas'); var ctx = canvas.getContext('2d'); // Draw shapes for (i=0;i<4;i++){ for(j=0;j<3;j++){ ctx.beginPath(); var x = 25+j*50; // x coordinate var y = 25+i*50; // y coordinate var radius = 20; // Arc radius var startAngle = 0; // Starting point on circle var endAngle = Math.PI+(Math.PI*j)/2; // End point on circle var clockwise = i%2==0 ? false : true; // clockwise or anticlockwise ctx.arc(x,y,radius,startAngle,endAngle, clockwise); if (i>1){ ctx.fill(); } else { ctx.stroke(); } } }
Screenshot | Live sample |
---|---|
规范描述
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard CanvasRenderingContext2D.arc |
Living Standard |
浏览器兼容性
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Gecko-specific 注解
从 Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)开始:
anticlockwise
参数是可选的,- 描述了 radius 为负数会抛出
IndexSizeError
错误(“索引或长度为负数,或者超过允许的数值”)。
参见
- 接口定义,
CanvasRenderingContext2D