HTML5 Canvas像素处理使用接口介绍

内容概要：本文通过简单的代码实例，以及略猥琐的图片demo，展示了canvas在图像像素数据操作方面的常用接口。至于如何利用这几个接口实现更复杂的效果，则会在后续章节里继续讲述。
一、canvas图片填充； 2、设置/获取canvas图片数据； 3、创建canvas图片数据；4、关于imageData.data的一点补充； 5、写在后面
一、canvas图片填充

复制代码

代码如下:

/**
* @description
* @param {Number} x 图像起始绘制点距离canvas最左侧的距离
* @param {Number} y 图像起始绘制点距离canvas最顶部的距离
* @param {Number} width 最终图像在canvas上绘制出来的宽度
* @param {Number} height 最终图像在canvas上绘制出来的高度
*/
context.drawImage(image, x, y, width, height)

demo_01如下：
<canvas id="draw_image_canvas" style="background:#ccc;"></canvas>

复制代码

代码如下:

function $(id) { return document.getElementById(id); }
function getImage(url, callback){
var img = document.createElement('img');
img.onload = function(){
callback && callback(this);
};
img.src = url;
document.body.appendChild(img);
}
function drawImage(){
var url = 'xiangjishi.png';
var canvas = $('draw_image_canvas');
var context = canvas.getContext('2d');
getImage(url, function(img){
canvas.width = img.width;
canvas.height = img.height;
var offsetX = 20;
var offsetY = 20;
var drawWidth = img.width/4;
var drawHeight = img.height/4;
context.drawImage(img, offsetX, offsetY, drawWidth, drawHeight);
});
}
drawImage();

demo说明：加载xiangjishi.png，加载完成后，从相对于画布左上角坐标(0, 0)处开始，将xiangjishi.png绘制在画布上，效果如下：

看到这里，可能对于 context.drawImage(image, x, y, width, height) 里四个参数的含义理解还不是特别清楚，可以简单把几个参数修改下看看效果：

复制代码

代码如下:

var offsetX = 20;
var offsetY = 20;
var drawWidth = img.width/2;
var drawHeight = img.height/2;
context.drawImage(img, offsetX, offsetY, drawWidth, drawHeight);

修改后的demo效果如下，结合上面API的说明，应该不难理解四个参数所代表的含义
 

复制代码

代码如下:

context.drawImage(image, x, y, width, height)

二、获取/设置canvas图片数据

复制代码

代码如下:

/**
* @description 获取canvas特定区域的像素点信息
* @param {Number} x 获取信息的起始点距离canvas最左侧的距离
* @param {Number} y 获取信息的起始距离canvas最顶部的距离
* @param {Number} width 获取的宽度
* @param {Number} height 最终的高度
*/
context.getImageData(x, y, width, height)

该方法返回一个ImageData对象，该对象主要有三个属性：
imageData.width：每行有多少个元素
imageData.height：每列有多少个元素
imageData.data：一维数组，存储了从canvas中获取的每个像素的RGBA值。该数组为每个像素点保存了四个值——红、绿、蓝和alpha透明度。每个值都在0～255之间。因此，canvas上的每个像素在这个数组中就变成了四个整数值。数组的填充顺序从左到右，从上到下。

复制代码

代码如下:

/**
* @description 用特定的imageData设置canvas特定区域的像素信息
* @param {Number} x 从canvas的x点处开始设置
* @param {Number} y 从canvas的y点处开始设置
* @param {Number} width 获取的宽度
* @param {Number} height 最终的高度
*/
context.putImageData(imageData, x, y)

下面结合demo_2来说明getImageData()的用法以及各自参数的对应的含义
DEMO_02 源代码如下，在demo_01的基础上稍事修改：

复制代码

代码如下:

<canvas id="draw_image_canvas" style="background:#ccc;"></canvas>
<canvas id="get_image_canvas" style="background:#ccc;"></canvas>

复制代码

代码如下:

function getAndSetImageData(){
var url = 'xiangjishi.png';
getImage(url, function(img){
$('draw_image_canvas').width = img.width;
$('draw_image_canvas').height = img.height;
var context = $('draw_image_canvas').getContext('2d');
context.drawImage(img, 0, 0, img.width, img.height);
//获取像素信息
var offsetX = img.width/2;
var offsetY = img.height/2;
var getImgWidth = img.width/2;
var getImgHeight = img.height/2;
var imgageData = context.getImageData(offsetX, offsetY, getImgWidth, getImgHeight);
//设置像素信息，此处先忽略具体代码，知道是把上面获取的像素信息原封不动放到另一canvas里即可
var startX = 0;
var startY = 0;
var ct = $('get_image_canvas').getContext('2d');
$('get_image_canvas').width = img.width;
$('get_image_canvas').height = img.height;
ct.putImageData(imgageData, startX, startY);
});
}

demo_2 展示效果如下：

 
到这里，基本能够清除getImageData方法四个参数对应的含义。putImageData参数的理解也不难，demo_2的代码略加修改后看下效果就知道了

复制代码

代码如下:

function getAndSetImageData(){
var url = 'xiangjishi.png';
getImage(url, function(img){
$('draw_image_canvas').width = img.width;
$('draw_image_canvas').height = img.height;
var context = $('draw_image_canvas').getContext('2d');
context.drawImage(img, 0, 0, img.width, img.height);
//获取像素信息
var offsetX = img.width/2;
var offsetY = img.height/2;
var getImgWidth = img.width/2;
var getImgHeight = img.height/2;
var imgageData = context.getImageData(offsetX, offsetY, getImgWidth, getImgHeight);
//设置像素信息
var startX = img.width/2; //这里原先为0
var startY = img.width/2; //这里原先为0
var ct = $('get_image_canvas').getContext('2d');
$('get_image_canvas').width = img.width;
$('get_image_canvas').height = img.height;
ct.putImageData(imgageData, startX, startY);
});
}

demo_3展示效果如下，可是试着把几个参数自己改一下试下，可能会有更好的理解：

 
三、创建canvas图片数据

复制代码

代码如下:

/**
* @description 预先创建一组图像数据，并绑定在canvas对象上
* @param {Number} width 创建的宽度
* @param {Number} height 创建的高度
*/
context.createImageData(width, height)

接口比较简单，创建的数据可以像用getImageData获取到的数据那样进行同样的处理，这里仅需要注意的是：这组图像数据不一定会反映canvas的当前状态。
四、关于imageData的一点补充
再《HTML5高级程序设计》以及很多文章里面，都把imageData.data当作一个数组来讲，但其实：

复制代码

代码如下:

imageData.data返回的并不是真正的数组，而是一个类数组的对象，可以将imageData.data的类型打印出来
console.log(Object.prototype.toString.call(imgageData.data)); //输出：[object Uint8ClampedArray]

然后再将imageData.data的具体内容打印出来，内容较长，仅截取最前面以及最后面的一段，可以看出：
imageData.data其实是一个对象，其索引从0开始，一直到width*height*4-1。

为什么不直接用数组存放？因为数组的长度有个上限，假设为limitLength，超过limitLength的元素，均以键值的方式存储，如 data[limitLength + 100] 其实是 data['limitLength + 100 + '']（limitLength具体值记不得了，有兴趣的童鞋可以查下）
至于最后面的byteLength、byteOffset、buffer属性，未深究，此处不展开以防误导读者。
五、写在后面
水平有限，如有疏误，敬请指出