移动端 H5图片裁剪插件,内置简单手势操作
前面曾经写过一篇《H5图片裁剪升级版》,但里面需要借助第三方手势库,这次就不需要使用手势库,全部封装在代码中。
下图是裁剪的展示,下面就做了拖放和裁剪,没有做缩放,在插件中需要用到大量的计算。veImage的源码可以在此处浏览。
一、原理
1)拖动、缩放、裁剪都是借助Canvas实现的。Canvas的基础概念可以参考《让自己也能使用Canvas》。
2)拖动是通过设置Canvas画布左上角的起点实现的。使用CanvasRenderingContext2D.translate方法。
3)缩放是通过设置目标画布上绘制图像的宽度和高度实现的。使用CanvasRenderingContext2D.drawImage方法。
4)裁剪是通过计算比例后(效果图中的画布尺寸与实际网页中的画布尺寸不符),在原画布上面截取计算后的尺寸,画到一张新画布中,新画布的宽高就是需要截取的宽高。
5)拖动、缩放是需要计算两个坐标的差值,而这两个坐标是通过e.touches获取到,这个参数可以参考《触屏touch事件记录》。
6)将画布的起始点,设置在画布的中心,也就是宽高的一半。这样设置后,缩放的效果看上去就是向四周缩放。否则效果是固定在图片左上角,然后缩放,如下图所示。
二、参数
参数目前就3个。
1)Canvas:画布,可以通过DOM获取到。
2)Image:图片,Image对象,这里先做的简单点,不是传地址。
3)relativeWidth:相对宽度,裁剪的时候可计算比例。
HTML代码如下:
<canvas id="captureCanvas2" class="car-img car-canvas"></canvas>
JavaScript代码如下:
var imgEdit2; var img = new Image(); img.src = 'img/car-demo2.jpg'; img.onload = function() { imgEdit2 = new veImage({canvas:document.getElementById('captureCanvas2'), image:this}); };
三、事件绑定
拖动、缩放涉及的事件是touchstart,touchmove,touchend。
给Canvas画布添加上述事件,模拟出手势效果。
事件绑定用到了“handleEvent”方式绑定。前面的《Slider图片滑动插件》也是用相同的方式绑定。
/** * 绑定事件 */ veImagePrototype._bind = function() { this.canvas.addEventListener(events.start, this); this.canvas.addEventListener(events.move, this); this.canvas.addEventListener(events.end, this); }; /** * 高级的绑定方法 */ veImagePrototype.handleEvent = function(e) { switch (e.type) { case events.start: this.startEvt(e); break; case events.move: this.moveEvt(e); break; case events.end: this.endEvt(e); break; } };
四、拖动与缩放
1)touchstart
1. 在touchstart事件中记录开始的坐标。
2. 通过手指的数量,设置当前的模式,简单处理,1根手指是拖动,2根手指是缩放。
this.start = _finger(e.touches);//记录开始的坐标 this._mode(e.touches);//模式初始化
2)touchmove
1. 记录移动中的坐标。
2. 当模式是1的时候,才做拖动。
3. 原先是通过手指数量来判断,拖动还是缩放,不过后面发现缩放后,移除手指的时候,会出现一个手指还停留在页面上,导致位移一段距离。如下图所示:
e.preventDefault(); //禁止滚动 var fingers = _finger(e.touches); //记录移动中的坐标 //不能仅仅通过手指数量来判断 因为当缩放后,移除手指的时候,会出现一个手指还停留在页面上,导致位移 if (this.mode == 1) { //位移 this._translate(fingers); } else if (this.mode == 2) { //缩放 this._zoom(fingers); } //将start的坐标复为移动中的坐标 时时计算偏移值,不然会变得非常大,图片在移动中会飞出画面 this.start = fingers;
3)移动计算
1. 最普通的计算方式,移动中的坐标点减去刚开始触屏的坐标点。
2. 向左或上移动,就是负数。
//计算手指的位移 this._draw( fingers[0].x - this.start[0].x, fingers[0].y - this.start[0].y );
4)缩放计算
1. 先计算上一次手指两个X轴和Y轴之间的距离。
2. 再计算当前的手指两个X轴和Y轴之间的距离。
3. 都取绝对值,缩放率分母是上一次手指,分子是当前手指两个X轴和Y轴之间的距离。
//上一次手指两个X轴和Y轴之间的距离 var lastOffset = { x: Math.abs(this.start[0].x - this.start[1].x), y: Math.abs(this.start[0].y - this.start[1].y) }; if (lastOffset.x == 0 || lastOffset.y == 0) { //防止分母是0 return; } //缩放不需要坐标轴偏移 但计算缩放值 需要偏移值 //缩放率分母是上一次手指,分子是当前手指两个X轴和Y轴之间的距离 this._draw( 0, 0, Math.abs(fingers[0].x - fingers[1].x) / lastOffset.x, Math.abs(fingers[0].y - fingers[1].y) / lastOffset.y );
五、画图
1)清空画并保存状态
1. 如果不清空画布,那么刚刚拖动的图片还会在画布上,形成了拖影。
2. 保存状态(CanvasRenderingContext2D.save)是为了下面能够还原到清空的画布。
//清空画布 擦除之前绘制的所有内容 不清空的话会显示各个步骤的画布 this.context.clearRect(0, 0, this.canvas.width, this.canvas.height); this.context.save(); //保存状态
2)拖动消息
拖动是由translate实现的,先计算原点和偏移值的和,再设置画布的原点。
this.origin.x += dx || 0; //计算X轴坐标 this.origin.y += dy || 0; //计算Y轴坐标 this.context.translate(this.origin.x, this.origin.y); //位移
3)缩放效果
缩放是通过改变目标画布的宽高实现的。
zoomWidth = zoomWidth || 1; zoomHeight = zoomHeight || 1; var zoom = zoomWidth > zoomHeight ? zoomWidth : zoomHeight; //统一按一个比例做缩放 this.dWidth *= zoom; //宽度缩放 this.dHeight *= zoom; //高度缩放
4)画图
由drawImage实现。语法如下:
1. sx, sy, sWidth, sHeight分别是图片的坐标点和宽高。
2. dx, dy, dWidth, dHeight分别是画布缩放后的中心点和缩放后的宽高。
3. 由于原点是在画布的中心点,所以要画到合适的位置,dx, dy就需要用负数坐标点。
this.context.drawImage( this.image, 0, 0, this.image.width, this.image.height, -this.dWidth / 2, -this.dHeight / 2, this.dWidth, this.dHeight ); //目标画布的中心点
5)还原状态
如果不还原(restore),就会像下图那样,上一张图还在画布中,也不能拖动或缩放了。
由于前面translate设置了原点,所以下一次画的时候会从这个原点开始。
将原点设置的小一些,就会像下图那样,出现谍影,上图其实也是谍影,只是已经超出画布了,所以看不到。
this.origin = { x: 30, y: 30 };
六、裁剪
1)新建一张画布
裁剪后的图片画到这张新画布中。
var canvas = document.createElement("canvas"), context = canvas.getContext("2d");
2)计算比例
例如效果图上画布的宽是750,那么裁剪的尺寸是相对于750来说的,而实际画布的宽度可能是360,那么这个时候就要做比例计算了。
rate = this.canvas.width / this.opts.relativeWidth;
3)计算尺寸
在获取到比例后,计算真实画布中的坐标和尺寸。
x *= rate; y *= rate; canvas.width = w * rate; canvas.height = h * rate; context.drawImage( this.canvas, x, y, canvas.width, canvas.height, 0, 0, canvas.width, canvas.height );