android的ScaleGestureDetector缩放类详解

文章由多出组合，它们来自：

http://elvajxw.iteye.com/blog/1308452

http://www.cnblogs.com/lknlfy/archive/2012/03/11/2390274.html

类概述

       根据接收的 MotionEvent,  侦测由多个触点（多点触控）引发的变形手势。callback 方法
ScaleGestureDetector.OnScaleGestureListener  会在特定手势事件发生时通知用户。
该类仅能和Touch事件引发的 MotionEvent 配合使用。使用该类需要为你的 View 创建
ScaleGestureDetector  实例确保在
onTouchEvent(MotionEvent)方法中调用  onTouchEvent  (MotionEvent). 
 在事件发生时，定义在 callback 中的方法会被调用。

（ScaleGestureDetector 为 Android2.2 新增的类，允许 Views 可以通过提供的MotionEvents 检测和处理包括多点触摸在内的手势变化信息。）

内部类

       interface  ScaleGestureDetector.OnScaleGestureListener
       手势发生时接收通知的监听器

class ScaleGestureDetector.SimpleOnScaleGestureListener      
       一个方便使用的类。 若仅想监听一部分尺寸伸缩事件，可继承该类。

  公共构造方法

public ScaleGestureDetector(Context context, ScaleGestureDetector.OnScaleGestureListener listener)

构造函数
       公共方法

public float getCurrentSpan ()

       返回手势过程中，组成该手势的两个触点的当前距离。
       返回值
       以像素为单位的触点距离。

  public long getEventTime ()

返回事件被捕捉时的时间。
       返回值
       以毫秒为单位的事件时间。

public float getFocusX ()

返回当前手势焦点的 X 坐标。 如果手势正在进行中，焦点位于组成手势的两个触点之间。 如果手势正在结束，焦点为仍留在屏幕上的触点的位置。若 isInProgress（）返回 false，该方法的返回值未定义。
       返回值
       返回焦点的 X 坐标值，以像素为单位。

public float getFocusY ()

       返回当前手势焦点的 Y 坐标。 如果手势正在进行中，焦点位于组成手势的两个触点之间。 如果手势正在结束，焦点为仍留在屏幕上的触点的位置。若 isInProgress（）返回 false，该方法的返回值未定义。
       返回值
       返回焦点的 Y 坐标值，以像素为单位。

  public float getPreviousSpan ()

返回手势过程中，组成该手势的两个触点的前一次距离。
       返回值
       两点的前一次距离，以像素为单位。

public float getScaleFactor ()

返回从前一个伸缩事件至当前伸缩事件的伸缩比率。该值定义为  (getCurrentSpan()  / getPreviousSpan())。
       返回值
       当前伸缩比率.

public long getTimeDelta ()

返回前一次接收到的伸缩事件距当前伸缩事件的时间差，以毫秒为单位。
       返回值
       从前一次伸缩事件起始的时间差，以毫秒为单位。

public boolean isInProgress ()

如果手势处于进行过程中，返回 true.
       返回值
       如果手势处于进行过程中，返回 true。否则返回 false。

简单示例：

新建工程MyScale，修改main.xml文件，在里面添加一个Button和一个SurfaceView，如下：

<?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent"
     android:orientation="vertical" >
 
     <Button
         android:id="@+id/button"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         android:text="显示图片"
         />
    
     <SurfaceView
         android:id="@+id/surfaceview"
         android:layout_width="fill_parent"
         android:layout_height="fill_parent"
         />
 
 </LinearLayout>

修改MyScaleActivity.java文件，主要是实现按钮的监听和定义一个类实现ScaleGestureDetector.OnScaleGestureListener接口：

package com.nan.scale;
 
 import android.app.Activity;
 import android.graphics.Bitmap;
 import android.graphics.BitmapFactory;
 import android.graphics.Canvas;
 import android.graphics.Color;
 import android.graphics.Matrix;
 import android.graphics.Rect;
 import android.os.Bundle;
 import android.view.MotionEvent;
 import android.view.ScaleGestureDetector;
 import android.view.SurfaceHolder;
 import android.view.SurfaceView;
 import android.view.View;
 import android.widget.Button;
 
 
 
 public class MyScaleActivity extends Activity
 {
     private Button mButton = null;
     private SurfaceView mSurfaceView = null;
     private SurfaceHolder mSurfaceHolder = null;
     private ScaleGestureDetector mScaleGestureDetector = null;
     private Bitmap mBitmap = null;   
    
     /** Called when the activity is first created. */
     @Override
     public void onCreate(Bundle savedInstanceState)
     {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);
        
         mSurfaceView = (SurfaceView)this.findViewById(R.id.surfaceview);
         mSurfaceHolder = mSurfaceView.getHolder(); 
         mScaleGestureDetector = new ScaleGestureDetector(this,new ScaleGestureListener());
         mButton = (Button)this.findViewById(R.id.button);
         //按钮监听
         mButton.setOnClickListener(new View.OnClickListener()
         {
            
             @Override
             public void onClick(View v)
             {
                 // TODO Auto-generated method stub
                 mBitmap = BitmapFactory.decodeResource(getResources(), R.drawable.mmm);
                 //锁定整个SurfaceView
                 Canvas mCanvas = mSurfaceHolder.lockCanvas();
                 //画图
                 mCanvas.drawBitmap(mBitmap, 0f, 0f, null);
                 //绘制完成，提交修改
                 mSurfaceHolder.unlockCanvasAndPost(mCanvas);
                 //重新锁一次
                 mSurfaceHolder.lockCanvas(new Rect(0, 0, 0, 0));
                 mSurfaceHolder.unlockCanvasAndPost(mCanvas);
             }
         });
        
     }
    
     @Override
     public boolean onTouchEvent(MotionEvent event)
     {           
         //返回给ScaleGestureDetector来处理
         return mScaleGestureDetector.onTouchEvent(event);
     }
    
    
     public class ScaleGestureListener implements ScaleGestureDetector.OnScaleGestureListener
     {
 
         @Override
         public boolean onScale(ScaleGestureDetector detector)
         {
             // TODO Auto-generated method stub
            
             Matrix mMatrix = new Matrix();       
             //缩放比例
             float scale = detector.getScaleFactor()/3;
             mMatrix.setScale(scale, scale);
            
             //锁定整个SurfaceView
             Canvas mCanvas = mSurfaceHolder.lockCanvas();
             //清屏
             mCanvas.drawColor(Color.BLACK);
             //画缩放后的图
             mCanvas.drawBitmap(mBitmap, mMatrix, null);
             //绘制完成，提交修改
             mSurfaceHolder.unlockCanvasAndPost(mCanvas);
             //重新锁一次
             mSurfaceHolder.lockCanvas(new Rect(0, 0, 0, 0));
             mSurfaceHolder.unlockCanvasAndPost(mCanvas);
            
             return false;
         }
 
         @Override
         public boolean onScaleBegin(ScaleGestureDetector detector)
         {
             // TODO Auto-generated method stub   
             //一定要返回true才会进入onScale()这个函数
             return true;
         }
 
         @Override
         public void onScaleEnd(ScaleGestureDetector detector)
         {
             // TODO Auto-generated method stub
            
         }
        
     }
     
 }