一、效果图
image
二、支持功能
- 本地与网络图片
- 可用于各大图片加载框架（Fresco，Glide，Picasso）
- 图片缩放
- 放大后的图片惯性滑动
- 下拉缩小退出
三、核心实现方法
3.1 缩放 Matrix.postScale(float sx, float sy, float px, float py)
参数解析：
- sx: 目标宽度 / 现有宽度
- sy: 目标高度 / 现有高度
- (px,py): 缩放焦点坐标
使用示例：
/**
* 缩放手势监听
*/
private ScaleGestureDetector.OnScaleGestureListener mOnScaleGestureListener = new ScaleGestureDetector.SimpleOnScaleGestureListener() {
@Override
public boolean onScale(ScaleGestureDetector detector) {
float scaleFactor = detector.getScaleFactor();
float wantScale = mScale * scaleFactor;
if (wantScale >= MIN_SCALE) {
mScale = wantScale;
focusX = detector.getFocusX();
focusY = detector.getFocusY();
mMatrix.postScale(scaleFactor, scaleFactor, focusX, focusY);
invalidate();
}
return true;
}
};
3.2 移动 Matrix.postTranslate(float dx, float dy)
参数解析：
- dx: 目标位置X坐标 - 当前位置X坐标
- sy: 目标位置Y坐标 - 当前位置Y坐标
使用示例：
/**
* 简单手势监听
*/
private GestureDetector.SimpleOnGestureListener mOnGestureListener = new GestureDetector.SimpleOnGestureListener() {
...
@Override
public boolean onScroll(MotionEvent e1, MotionEvent e2, float distanceX, float distanceY) {
if (!isAlwaysSingleTouch) {
return true;
}
mMatrix.postTranslate(-distanceX, -distanceY);
invalidate();
return false;
}
...
};
3.3 将Matrix的操作关联到ImageView上
View提供onDraw的方法，可以操作到Canvas，Canvas提供concat的方法来关联Matrix。每次针对Matrix有操作之后调用invalidate()刷新一下onDraw()即可。这就是个操作配置，而且是View早就提供好了的配置。
调用示例：
@Override
protected void onDraw(Canvas canvas) {
int saveCount = canvas.save();
canvas.concat(mMatrix);
super.onDraw(canvas);
canvas.restoreToCount(saveCount);
}
3.4 惯性滑动 OverScroller.fling(int startX, int startY, int velocityX, int velocityY,int minX, int maxX, int minY, int maxY)
参数解析：
- (startX, startY): 初始位置坐标
- (velocityX, velocityY): XY方向的初始速度
- (minX, maxX, minY, maxY): 限定了移动后的位置边界
使用示例：
/**
* 惯性滑动工具类
* 使用fling方法开始滑动
* 使用stop方法停止滑动
*/
private class FlingUtil implements Runnable {
private int mLastFlingX = 0;
private int mLastFlingY = 0;
private OverScroller mScroller;
private boolean mEatRunOnAnimationRequest = false;
private boolean mReSchedulePostAnimationCallback = false;
/**
* RecyclerView使用的惯性滑动插值器
* f(x) = (x-1)^5 + 1
*/
private final Interpolator sQuinticInterpolator = new Interpolator() {
@Override
public float getInterpolation(float t) {
t -= 1.0f;
return t * t * t * t * t + 1.0f;
}
};
public FlingUtil() {
mScroller = new OverScroller(getContext(), sQuinticInterpolator);
}
@Override
public void run() {
disableRunOnAnimationRequests();
final OverScroller scroller = mScroller;
if (scroller.computeScrollOffset()) {
final int y = scroller.getCurrY();
int dy = y - mLastFlingY;
final int x = scroller.getCurrX();
int dx = x - mLastFlingX;
mLastFlingY = y;
mLastFlingX = x;
constrainScrollBy(dx, dy);
postOnAnimation();
}
enableRunOnAnimationRequests();
}
public void fling(int velocityX, int velocityY) {
mLastFlingX = 0;
mLastFlingY = 0;
mScroller.fling(0, 0, velocityX, velocityY, Integer.MIN_VALUE, Integer.MAX_VALUE, Integer.MIN_VALUE, Integer.MAX_VALUE);
postOnAnimation();
}
public void stop() {
removeCallbacks(this);
mScroller.abortAnimation();
}
private void disableRunOnAnimationRequests() {
mReSchedulePostAnimationCallback = false;
mEatRunOnAnimationRequest = true;
}
private void enableRunOnAnimationRequests() {
mEatRunOnAnimationRequest = false;
if (mReSchedulePostAnimationCallback) {
postOnAnimation();
}
}
void postOnAnimation() {
if (mEatRunOnAnimationRequest) {
mReSchedulePostAnimationCallback = true;
} else {
removeCallbacks(this);
ViewCompat.postOnAnimation(ZoomImageView.this, this);
}
}
}
Scroller只提供在基于已有位置和已有速度下的位置计算，需要主动调用scroller.getCurrY()和scroller.getCurrX()方法去获取位置信息。
这里使用的是RecyclerView中的惯性滑动的实现方式。
四、三个必要的细节处理
在有了上面的4个方法，基本上一个可缩放的ImageView所需要的功能都可以实现了。但是，一些细节方面的问题也不可忽视，比如说：
- 移动不能超过图片的边缘
- 在ImageView的ScaleType为FIT_CENTER时，获取真实的图片内容的宽高，毕竟需要缩放的是图片的内容
- 图片是否移动到最左侧或最右侧，用于ViewPager中的滑动判断
4.1 边缘处理
在移动前，校验此次的移动是否会造成图片内容是否会移动超出边界。Canvas关联的Matrix是针对整个ImageView的，我们需要知道ImageView中图片部分在ImageView中的初始位置信息,如图：
image
在得到图片内容在初始状态下的展示区域Rect(a,b,c,d)后，使用Matrix提供的Matrix.mapRect(Rect)方法，可以得到经历缩放后的展示区域。得到内容缩放后的展示区域后，与ImageView的展示区域Rect(0,0,W,H)作比较便可得出是否超出边界。
示例方法：
/**
* 获得缩放移动后的图片内容的位置区域
*
* @param matrix
* @return RectF
*/
private RectF getScaledRect(Matrix matrix) {
RectF rectF = new RectF(mImageRectF);
//转化为缩放后的相对位置
matrix.mapRect(rectF);
return rectF;
}
/**
* 针对边缘问题，约束移动
*
* @param dx
* @param dy
*/
private void constrainScrollBy(float dx, float dy) {
RectF rectF = getScaledRect(mMatrix);
float scaleImageWidth = rectF.width();
float scaleImageHeight = rectF.height();
if (scaleImageWidth > mWidth) {
//right
if (rectF.right + dx < mWidth) {
dx = -rectF.right + mWidth;
}
//left
if (rectF.left + dx > 0) {
dx = -rectF.left;
}
} else {
//center
dx = -rectF.left + ((float) mWidth - scaleImageWidth) / 2;
}
if (scaleImageHeight > mHeight) {
//bottom
if (rectF.bottom + dy < mHeight) {
dy = -rectF.bottom + mHeight;
}
//top
if (rectF.top + dy > 0) {
dy = -rectF.top;
}
} else {
//center
dy = -rectF.top + ((float) mHeight - scaleImageHeight) / 2;
}
mMatrix.postTranslate(dx, dy);
invalidate();
checkBorder();
}
4.2 获取ImageView中内容的宽高
针对不同的网络加载框架有不同的操作方式，这里一Fresco位示例：
PipelineDraweeControllerBuilder提供setControllerListener方法，可以设置一个图片加载的监听。
示例代码：
private ControllerListener controllerListener = new BaseControllerListener<ImageInfo>() {
@Override
public void onFinalImageSet(String id, @Nullable ImageInfo imageInfo, @Nullable Animatable anim) {
if (imageInfo == null) {
return;
}
int preWidth = imageInfo.getWidth();
int preHeight = imageInfo.getHeight();
if (preWidth != mWidth || preHeight != mHeight) {
//获取到最新的图片内容的宽高
mWidth = preWidth;
mHeight = preHeight;
}
}
@Override
public void onIntermediateImageSet(String id, @Nullable ImageInfo imageInfo) {
Log.d("zhufeng", "Intermediate image received");
}
@Override
public void onFailure(String id, Throwable throwable) {
throwable.printStackTrace();
}
};
public void loadImage(int resizeX, int resizeY, Uri uri) {
ImageRequest request = ImageRequestBuilder
.newBuilderWithSource(uri)
.setResizeOptions(new ResizeOptions(resizeX, resizeY))
.build();
PipelineDraweeController controller = (PipelineDraweeController) Fresco.newDraweeControllerBuilder().setControllerListener(controllerListener).setOldController(getController()).setImageRequest(request).build();
setController(controller);
}
4.3 处理与ViewPager的滑动冲突
需要明确：
- 左滑时，当图片内容到达右侧边界，进行图片切换的处理（事件交由ViewPager处理）
- 右滑时，当图片内容到达左侧边界，进行图片切换的处理（事件交由ViewPager处理）
- 剩下的ImageView自己处理
ImageView中的处理：
在约束移动的时候标记图片是否已经触及左右边界。并提供方法：
/**
* 用于ViewPager滑动拦截
*
* @param direction
* @return
*/
public boolean canScroll(int direction) {
return !((direction < 0 && isRightSide()) || (direction > 0 && isLeftSide()));
}
ViewPager中的处理：
在canScroll方法中进行状态判断。重写ViewPager：
/**
* 相册ViewPager
*
* @author zhufeng on 2017/10/22
*/
public class AlbumViewPager extends ViewPager {
...
@Override
protected boolean canScroll(View v, boolean checkV, int dx, int x, int y) {
if (v instanceof ZoomImageView) {
return ((ZoomImageView) v).canScroll(dx) || super.canScroll(v, checkV, dx, x, y);
}
return super.canScroll(v, checkV, dx, x, y);
}
...
}
网友评论