當耐特

寫在前面

AlloyCrop 這個項目是8個月前發布的，作為AlloyFinger 的典型案例，發布之后被BAT等其他公司廣泛使用。但是發布之后，有兩個問題一直沒有抽出時間去解決:

• 裁剪圖像的分辨率太小，是否可配？
• pinch雙指放大的時候，放大的中心不是雙指中心，是否可以優化？

現在很高興地告訴大家，AlloyCrop 已經完全搞定了上面兩個問題，本文將解釋新版本的變化和AlloyCrop背后的原理。當然AlloyFinger的原理這里就不再闡述，以前有分享過 超小Web手勢庫AlloyFinger原理

• Github：https://github.com/AlloyTeam/AlloyCrop

先看全新的API變化。

API

new AlloyCrop({
    image_src: "img src",
    circle: true, // optional parameters , the default value is false
    width: 200, // crop width
    height: 100, // crop height
    output: 2, // output resolution --> 400*200
    ok: function (base64, canvas) { },
    cancel: function () { },
    ok_text: "yes", // optional parameters , the default value is ok
    cancel_text: "no" // optional parameters , the default value is cancel
});

與之前版本最主要的變化就是新增了 output 支持自定義倍率分辨率的圖像輸出。

output原理

crop: function () {
    this.calculateRect();
    this.ctx.drawImage(this.img, this.crop_rect[0], this.crop_rect[1], this.crop_rect[2], this.crop_rect[3], 0, 0, this.canvas.width, this.canvas.height);

},

其中 this.calculateRect() 是計算選取和圖片重疊在一起的矩形區域，drawImage 是把裁剪的區域繪制到 canvas 上。注意 canvas 的寬高是多少？且看:

this.canvas.width = option.width * this.output;
this.canvas.height = option.height * this.output;

所以就達到了自定義倍率分辨率的目的。當然這里圖片的失真又或者超分辨，都取決于 drawImage 插值過程。關于插值，以前特意對比過，使用三次卷積插值完爆了其他幾個,但是三次卷積插值速度也是最慢，所以瀏覽器內核要權衡效率和插值結果去實現 drawImage。

calculateRect計算裁剪區域

因為我們需要把圖片的某個區域繪制到整個canvas上。所以drawImage的后四個參數為（0, 0, this.canvas.width, this.canvas.height），然后我們需要去計算圖片裁剪的區域。

大概就分上面兩種情況，一種是完全包含，一種部分相交。

因為圖片會被放大或者縮小(scale)，所以情況會變得稍微復雜一點點。求出相交的矩形區域后，要對圖片scale進行校正，校正回到1的比例，才能用于drawImage。具體代碼參見 https://github.com/AlloyTeam/AlloyCrop/blob/master/alloy-crop.js#L227-L255

pinch 縮放優化

使用AlloyCrop是可以放大或者縮小再進行裁剪，怎么基于 pinch 的兩個手指的中間進行放大呢？所以的秘密都在這個multipointStart里。

• multipointStart是AlloyFinger拋出的多手指開始碰到屏幕的回調函數，通過evt.touches拿到前兩個手指的坐標去計算中心坐標
• 重置 originX 和 originY　到兩手指的中心
• 再重置 translateX 和 translateY　去抹平　originX和originY變更帶來的位移

 new AlloyFinger(this.croppingBox, {
	multipointStart: function (evt) {
	    //reset origin x and y
	    var centerX = (evt.touches[0].pageX + evt.touches[1].pageX) / 2;
	    var centerY = (evt.touches[0].pageY + evt.touches[1].pageY) / 2;
	    var cr = self.img.getBoundingClientRect();
	    var img_centerX = cr.left + cr.width / 2;
	    var img_centerY = cr.top + cr.height / 2;
	    var offX = centerX - img_centerX;
	    var offY = centerY - img_centerY;
	    var preOriginX = self.img.originX
	    var preOriginY = self.img.originY
	    self.img.originX = offX / self.img.scaleX;
	    self.img.originY = offY / self.img.scaleY;
	    //reset translateX and translateY
	    self.img.translateX += offX - preOriginX * self.img.scaleX;
	    self.img.translateY += offY - preOriginY * self.img.scaleX;
	    self.initScale = self.img.scaleX;
	},
	pinch: function (evt) {
	    self.img.scaleX = self.img.scaleY = self.initScale * evt.zoom;
	},
	pressMove: function (evt) {
	    self.img.translateX += evt.deltaX;
	    self.img.translateY += evt.deltaY;
	    evt.preventDefault();
	}
});

• 注意，translateX, translateY, translateZ, scaleX, scaleY, scaleZ, rotateX, rotateY, rotateZ, skewX, skewY, originX, originY, originZ 都是 css3transform 類庫 注入到DOM元素上的屬性。

Preview

Demo

Dependencies

• AlloyFinger
• css3transform

License

This content is released under the MIT License.