width

Summary

The number of physical device pixels per row in the image data.

Property of apis/canvas/ImageDataapis/canvas/ImageData

Syntax

Note: This property is read-only.

var result = ImageData.width;

Return Value

Returns an object of type unsigned longunsigned long

Examples

This example creates an ImageData object and reports its width, then draws the ImageData onto the canvas.

<canvas id="myCanvas" width="300" height="150" style="border:1px solid blue;"></canvas>
<p>. . .</p>
<script>
var can = document.getElementById("myCanvas");
var ctxt = can.getContext("2d");
var imgdata = ctxt.createImageData(150, 100);
alert(imgdata.width); // 150
for (var i = 0; i < imgdata.data.length; i += 4) {
 imgdata.data[i+0] = 255;
 imgdata.data[i+1] = 255;
 imgdata.data[i+2] = 0;
 imgdata.data[i+3] = 128;
}
ctxt.putImageData(imgdata, 10, 10);
</script>

Related specifications

W3C HTML Canvas 2D Specification

W3C Candidate Recommendation

Attributions

• Microsoft Developer Network: Windows Internet Explorer API reference Article