From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../createimagedata/index.html | 107 +++++++++++++++++++++ 1 file changed, 107 insertions(+) create mode 100644 files/zh-cn/web/api/canvasrenderingcontext2d/createimagedata/index.html (limited to 'files/zh-cn/web/api/canvasrenderingcontext2d/createimagedata') diff --git a/files/zh-cn/web/api/canvasrenderingcontext2d/createimagedata/index.html b/files/zh-cn/web/api/canvasrenderingcontext2d/createimagedata/index.html new file mode 100644 index 0000000000..a02adf6183 --- /dev/null +++ b/files/zh-cn/web/api/canvasrenderingcontext2d/createimagedata/index.html @@ -0,0 +1,107 @@ +--- +title: CanvasRenderingContext2D.createImageData() +slug: Web/API/CanvasRenderingContext2D/createImageData +tags: + - API + - Canvas + - CanvasRenderingContext2D +translation_of: Web/API/CanvasRenderingContext2D/createImageData +--- +
{{APIRef}}
+ +

CanvasRenderingContext2D.createImageData() 是 Canvas 2D API 创建一个新的、空白的、指定大小的 {{domxref("ImageData")}} 对象。 所有的像素在新对象中都是透明的。

+ +

语法

+ +
ImageData ctx.createImageData(width, height);
+ImageData ctx.createImageData(imagedata);
+
+ +

参数

+ +
+
width
+
{{domxref("ImageData")}} 新对象的宽度。
+
height
+
{{domxref("ImageData")}} 新对象的高度。
+
imagedata
+
从现有的 {{domxref("ImageData")}} 对象中，复制一个和其宽度和高度相同的对象。图像自身不允许被复制。
+
+ +

返回值

+ +

指定了宽度和高度的，新的 {{domxref("ImageData")}} 对象。 新对象使用透明的像素进行填充。

+ +

抛出错误

+ +
+
IndexSizeError
+
如果宽度或者高度变量值为零，会抛出此异常。
+
+ +

示例

+ +

使用 createImageData 方法

+ +

这是一段简单地使用 createImageData 方法的代码片段。 获取更多信息，请看 canvas像素控制 和 {{domxref("ImageData")}} 对象。

+ +

HTML

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

JavaScript

+ +
var canvas = document.getElementById("canvas");
+var ctx = canvas.getContext("2d");
+ctx.rect(10, 10, 100, 100);
+ctx.fill();
+
+console.log(ctx.createImageData(100, 100));
+// ImageData { width: 100, height: 100, data: Uint8ClampedArray[40000] }
+
+ +

规范

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('HTML WHATWG', "scripting.html#dom-context-2d-createimagedata", "CanvasRenderingContext2D.createImageData")}}{{Spec2('HTML WHATWG')}} 
+ +

浏览器兼容

+ + + +

{{Compat("api.CanvasRenderingContext2D.createImageData")}}

+ +

兼容性注解

+ + + +

参见

+ + -- cgit v1.2.3-54-g00ecf