html4 画布,-HTML 参考手册- (HTML5 标准)--HTML 画布

# HTML5 参考手册 #

--------------------

## 描述 ##

HTML5 <canvas> 标签用于绘制图像(通过脚本，通常是 JavaScript)。

不过，<canvas> 元素本身并没有绘制能力(它仅仅是图形的容器) - 您必须使用脚本来完成实际的绘图任务。

getContext() 方法可返回一个对象，该对象提供了用于在画布上绘图的方法和属性。

本手册提供完整的 getContext("2d") 对象的属性和方法，可用于在画布上绘制文本、线条、矩形、圆形等等。

--------------------

## 浏览器支持 ##

Internet Explorer 9、Firefox、Opera、Chrome 和 Safari 支持 <canvas> 标签的属性及方法。

注意:Internet Explorer 8 及更早的IE版本不支持 <canvas> 元素。

--------------------

## 颜色、样式和阴影 ##

| | || ------------- | --------------------- || 属性 | 描述 || fillStyle | 设置或返回用于填充绘画的颜色、渐变或模式。 || strokeStyle | 设置或返回用于笔触的颜色、渐变或模式。 || shadowColor | 设置或返回用于阴影的颜色。 |

| shadowBlu| 设置或返回用于阴影的模糊级别。 || shadowOffsetX | 设置或返回阴影与形状的水平距离。 || shadowOffsetY | 设置或返回阴影与形状的垂直距离。 |

| | || ---------------------- | --------------------- || 方法 | 描述 || createLinearGradient() | 创建线性渐变(用在画布内容上)。 || createPattern() | 在指定的方向上重复指定的元素。 || createRadialGradient() | 创建放射状/环形的渐变(用在画布内容上)。 || addColorStop() | 规定渐变对象中的颜色和停止位置。 |

## 线条样式 ##

| | || ---------- | --------------------- || 属性 | 描述 || lineCa| 设置或返回线条的结束端点样式。 || lineJoin | 设置或返回两条线相交时，所创建的拐角类型。 || lineWidth | 设置或返回当前的线条宽度。 |

| miterLimit | 设置或返回最大斜接长度。 |

## 矩形 ##

| | || ------------ | --------------- || 方法 | 描述 || rect() | 创建矩形。 || fillRect() | 绘制"被填充"的矩形。 || strokeRect() | 绘制矩形(无填充)。 || clearRect() | 在给定的矩形内清除指定的像素。 |

## 路径 ##

| | || ------------------ | ---------------------------------- || 方法 | 描述 || fill() | 填充当前绘图(路径)。 |

| stroke() | 绘制已定义的路径。 || beginPath() | 起始一条路径，或重置当前路径。 || moveTo() | 把路径移动到画布中的指定点，不创建线条。 || closePath() | 创建从当前点回到起始点的路径。 || lineTo() | 添加一个新点，然后在画布中创建从该点到最后指定点的线条。 || clip() | 从原始画布剪切任意形状和尺寸的区域。 || quadraticCurveTo() | 创建二次贝塞尔曲线。 || bezierCurveTo(| 创建三次贝塞尔曲线。 || arc() | 创建弧/曲线(用于创建圆形或部分圆)。 || arcTo() | 创建两切线之间的弧/曲线。 || isPointInPath(| 如果指定的点位于当前路径中，则返回 true，否则返回 false。 |

## 转换 ##

| | || -------------- | ------------------------------ || 方法 | 描述 |

| scale() | 缩放当前绘图至更大或更小。 || rotate() | 旋转当前绘图。 |

| translate(| 重新映射画布上的 (0,0) 位置。 || transform(| 替换绘图的当前转换矩阵。 |

| setTransform() | 将当前转换重置为单位矩阵。然后运行 transform()。 |

## 文本 ##

| | || ------------ | --------------------- || 属性 | 描述 || font | 设置或返回文本内容的当前字体属性。 || textAlig| 设置或返回文本内容的当前对齐方式。 || textBaseline | 设置或返回在绘制文本时使用的当前文本基线。 |

| | || ------------- | --------------- || 方法 | 描述 |

| fillText(| 在画布上绘制"被填充的"文本。 || strokeText() | 在画布上绘制文本(无填充)。 || measureText() | 返回包含指定文本宽度的对象。 |

## 图像绘制 ##

| | || ----------- | --------------- || 方法 | 描述 |

| drawImage() | 向画布上绘制图像、画布或视频。 |

## 像素操作 ##

| | |

| ------ | -------------------------------- || 属性 | 描述 || width | 返回 ImageData 对象的宽度。 |

| height | 返回 ImageData 对象的高度。 |

| data | 返回一个对象，其包含指定的 ImageData 对象的图像数据。 |

| | || ----------------- | ----------------------------------- || 方法 | 描述 || createImageData() | 创建新的、空白的 ImageData 对象。 |

| getImageData(| 返回 ImageData 对象，该对象为画布上指定的矩形复制像素数据。 || putImageData(| 把图像数据(从指定的 ImageData 对象)放回画布上。 |

## 合成 ##

| | |

| ------------------------ | ---------------------- || 属性 | 描述 || globalAlpha | 设置或返回绘图的当前 alpha 或透明值。 || globalCompositeOperation | 设置或返回新图像如何绘制到已有的图像上。 |

## 其他 ##

| | || ------------- | ---------------- || 方法 | 描述 || save() | 保存当前环境的状态。 || restore() | 返回之前保存过的路径状态和属性。 || createEvent() |   || getContext() |   || toDataURL() |   |