开源组件photoView学习

2023-12-10 16:40
文章标签 学习 组件 开源 photoview

本文主要是介绍开源组件photoView学习,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

功能特性

 支持放缩超出边界,多点触控和双击事件

 滚动和滑动

 和ViewPager等能完美兼容

 矩阵变化等有回调,方便前台其他展示的改变

 单击,长按都有回调提醒

源码剖析

那么怎么来学习他的源码呢,我们从以下几个部分来说吧

 代码目录结构

 

 

从上面结构图中我们能知道他的功能总体划分,有了一个总体的认识啦。

 

 样例

 下面我们再来梳理一下他的调用流程,以一个简单的例子开始吧。

第一个是指定图片旋转90°

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. photo.setRotationTo(90);  
第二个是拖拽移动

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. ImageView mImageView = (ImageView) findViewById(R.id.iv_photo);  
  2. mCurrMatrixTv = (TextView) findViewById(R.id.tv_current_matrix);  
  3.   
  4. Drawable bitmap = getResources().getDrawable(R.drawable.wallpaper);  
  5. mImageView.setImageDrawable(bitmap);  
  6.   
  7. // The MAGIC happens here!  
  8. mAttacher = new PhotoViewAttacher(mImageView);  
  9.   
  10. // Lets attach some listeners, not required though!  
  11. mAttacher.setOnMatrixChangeListener(new MatrixChangeListener());  
  12. mAttacher.setOnPhotoTapListener(new PhotoTapListener());  

然后我们一步一步的跟踪,流程也清晰起来,来我们一起看看

 

 时序图


 好了,说了那么多,我们还没真正的开始看功能点的代码,下面呢,我们从代码级来分析一个个问题。我觉得根据问题来看代码,我们的主意力就会非常集中,在项目代码极其庞大的时候,是非常有效的办法,当然在像这样的小项目中呢,我们把问题铺的很多,问题解决了,代码其实也看的差不多了,好了,废话不多说了,先来第一个问题吧。

 

 1.图片的继承关系,是View还是ImageView,怎么改变图片的效果的?

结论:图片是继承了ImageView,根据Matrix矩阵改变显示drawable的显示效果的,我们都知道ImageView的展示模式有好几种分别是

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. private static final ScaleType[] sScaleTypeArray = {  
  2.     ScaleType.MATRIX,  
  3.     ScaleType.FIT_XY,  
  4.     ScaleType.FIT_START,  
  5.     ScaleType.FIT_CENTER,  
  6.     ScaleType.FIT_END,  
  7.     ScaleType.CENTER,  
  8.     ScaleType.CENTER_CROP,  
  9.     ScaleType.CENTER_INSIDE  
  10. };  

我们把它设置为矩阵模式,那其他模式是不是不支持了呢,当然不是了,牛逼的地方就在他使用这几种模式,而把这几种模式在程序中模拟换算出来,设置还是矩阵模式。

 

 2.是怎么进行缩小放大操作?

还记得在结构图里面的标注吗,有个手势的,对的就是她了,放大的话,他有个最大比例的,缩小呢,也有个最小比例的,当放手的时候,会有个动画效果。

具体看

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. // If the user has zoomed less than min scale, zoom back  
  2. // to min scale  
  3. if (getScale() < mMinScale) {  
  4.     RectF rect = getDisplayRect();  
  5.     if (null != rect) {  
  6.         v.post(new AnimatedZoomRunnable(getScale(), mMinScale,  
  7.                 rect.centerX(), rect.centerY()));  
  8.         handled = true;  
  9.     }  
  10. }  

当放缩比最小比例时,执行了 AnimatedZoomRunnable ,在看

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. @Override  
  2. public void run() {  
  3.     ImageView imageView = getImageView();  
  4.     if (imageView == null) {  
  5.         return;  
  6.     }  
  7.   
  8.     float t = interpolate();  
  9.     float scale = mZoomStart + t * (mZoomEnd - mZoomStart);  
  10.     float deltaScale = scale / getScale();  
  11.   
  12.     mSuppMatrix.postScale(deltaScale, deltaScale, mFocalX, mFocalY);  
  13.     checkAndDisplayMatrix();  
  14.   
  15.     // We haven't hit our target scale yet, so post ourselves again  
  16.     if (t < 1f) {  
  17.         Compat.postOnAnimation(imageView, this);  
  18.     }  
  19. }  

这句话Compat.postOnAnimation(imageView,  this );也就是执行一次当前 Runnable ,然后每次都会改变矩阵值,接着就会更新 drawable的显示矩阵了,是一个持续的属性动画的过程。

 3.拖拽移动的时候,怎么能保证不超过图片的边缘呢?

 上面我们说了,是靠矩阵来改变效果的,那么一张原始图片(大小固定)在经过变换后产生的矩阵后,新的大小能不能得到呢,答案是肯定了,矩阵给我们提供了对应的方法Matrix.mapRect(RectF rect),好了,那程序是不是这样实现的呢?看获取显示最终矩阵矩形的代码

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1.     /** 
  2.      * Helper method that maps the supplied Matrix to the current Drawable 
  3.      * 
  4.      * @param matrix - Matrix to map Drawable against 
  5.      * @return RectF - Displayed Rectangle 
  6.      */  
  7.     private RectF getDisplayRect(Matrix matrix) {  
  8.         ImageView imageView = getImageView();  
  9.    
  10.         if (null != imageView) {  
  11.             Drawable d = imageView.getDrawable();  
  12.             if (null != d) {  
  13.                 mDisplayRect.set(00, d.getIntrinsicWidth(),  
  14.                         d.getIntrinsicHeight());  
  15.                 matrix.mapRect(mDisplayRect);  
  16.                 return mDisplayRect;  
  17.             }  
  18.         }  
  19.         return null;  
  20. }  

哈哈, 是吧。 就是这样做的。


  4.图片的滑行操作是做的呢?

 这个和放缩的实现差不多,使用了FlingRunnable,只是ScrollerProxy来计算更新的数值,ScrollerProxy又是一个什么东东呢?看代码的话,会发现其实就是OverScroller或者是Scroller的兼容代理,根据不同的版本选择不同的Scroller。

 

 5.怎么处理滑动,拖动,放缩触摸事件的呢?

 细心的同学会发现上面的结构图中还有一个手势包,其实里面就是处理这个的。

里面有个接口GestureDetector,也是跟Scroller差不多,有个兼容不同版本的生成器,统一生成GestureDetector,也就是不同版本的实现。

在CupcakeGestureDetector的onTouchEvent中,能够找到具体怎么处理事件的逻辑。

 

6.首先来看看怎么拖拽的?

 在MotionEvent.ACTION_MOVE Action事件中, 发现拖动的距离大于系统认为可以拖动的值的时候,那么怎么来取这个值呢

来看代码

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. final ViewConfiguration configuration = ViewConfiguration  
  2.         .get(context);  
  3. mMinimumVelocity = configuration.getScaledMinimumFlingVelocity();  
  4. mTouchSlop = configuration.getScaledTouchSlop();  

这样就取到了那个系统值,然后就是判断了

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. // Use Pythagoras to see if drag length is larger than  
  2. // touch slop  
  3. mIsDragging = FloatMath.sqrt((dx * dx) + (dy * dy)) >= mTouchSlop;  
拖拽的时候可以通过监听器来传递拖拽的距离
[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. mListener.onDrag(dx, dy);  

 7.怎么判断是滑动呢?

 这里用到了一个不常使用的类VelocityTracker,看注释大致意思是帮助用来跟踪触摸轨迹的这么一个东东。 那么怎么来使用这个东东呢,当滑动的时候使用mVelocityTracker.addMovement(ev);来添加触摸轨迹,抬起的时候,mVelocityTracker.computeCurrentVelocity(1000); 这个方法的意思就是根据最近的1秒的时间来计算出当前手势的速度,还记得我们上面取得的那个系统认为拖动的那个值吗,我们还取了另外一个值,mMinimumVelocity对就是他。只要我们的速度超过他,也就可以认为滑动了。好吧。看实现

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. final float vX = mVelocityTracker.getXVelocity(), vY = mVelocityTracker  
  2.         .getYVelocity();  
  3.   
  4. // If the velocity is greater than minVelocity, call  
  5. // listener  
  6. if (Math.max(Math.abs(vX), Math.abs(vY)) >= mMinimumVelocity) {  
  7.     mListener.onFling(mLastTouchX, mLastTouchY, -vX,  
  8.             -vY);  
  9. }  
正如我们所说的那样吧。

 

 8.好吧继续,放缩是在哪处理的呢?

 好吧,又有新姿势了,ScaleGestureDetector,可以接收MotionEvent,来检测放缩的发生, 有个回调监听器ScaleGestureDetector.OnScaleGestureListener,看看程序中怎么实现的他的回调方法

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. @Override  
  2. public boolean onScale(ScaleGestureDetector detector) {  
  3.     float scaleFactor = detector.getScaleFactor();  
  4.   
  5.     if (Float.isNaN(scaleFactor) || Float.isInfinite(scaleFactor))  
  6.         return false;  
  7.   
  8.     mListener.onScale(scaleFactor,  
  9.             detector.getFocusX(), detector.getFocusY());  
  10.     return true;  
  11. }  
看到这是不是一切明了啊。呵呵。

 

 9.最后一个了,双击时间,长按事件呢?

 这个就简单些了, 因为我们经常会用到的GestureDetector,添加一个监听器就好了,来看看代码实现

[java]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. mGestureDetector = new GestureDetector(imageView.getContext(),  
  2.         new GestureDetector.SimpleOnGestureListener() {  
  3.   
  4.             // forward long click listener  
  5.             @Override  
  6.             public void onLongPress(MotionEvent e) {  
  7.                 if (null != mLongClickListener) {  
  8.                     mLongClickListener.onLongClick(getImageView());  
  9.                 }  
  10.             }  
  11.         });  
  12.   
  13. mGestureDetector.setOnDoubleTapListener(new DefaultOnDoubleTapListener(this));  

结语

好了,PhotoView这个开源项目,我们就剖析到这了, 牵涉到的东西还是蛮多的, 可以说是小巧精悍,很多知识点对我们都有很大的启发,后续大家如果还有什么问题,或者有不正确的地方, 可以提出来,共同探讨。

 

 Github地址

https://github.com/chrisbanes/PhotoView

这篇关于开源组件photoView学习的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/477674

相关文章

HarmonyOS学习(七)——UI(五)常用布局总结

自适应布局 1.1、线性布局(LinearLayout) 通过线性容器Row和Column实现线性布局。Column容器内的子组件按照垂直方向排列,Row组件中的子组件按照水平方向排列。 属性说明space通过space参数设置主轴上子组件的间距,达到各子组件在排列上的等间距效果alignItems设置子组件在交叉轴上的对齐方式,且在各类尺寸屏幕上表现一致,其中交叉轴为垂直时,取值为Vert

Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya(不是本人,claude AI)在社交媒体上分享了他在OpenAI学习到的15个Prompt撰写技巧。 以下是详细的内容: 提示精确化:在编写提示时,力求表达清晰准确。清楚地阐述任务需求和概念定义至关重要。例:不用"分析文本",而用"判断这段话的情感倾向:积极、消极还是中性"。 快速迭代:善于快速连续调整提示。熟练的提示工程师能够灵活地进行多轮优化。例:从"总结文章"到"用

JS常用组件收集

收集了一些平时遇到的前端比较优秀的组件,方便以后开发的时候查找!!! 函数工具: Lodash 页面固定: stickUp、jQuery.Pin 轮播: unslider、swiper 开关: switch 复选框: icheck 气泡: grumble 隐藏元素: Headroom

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画(下)

【课程链接】 AntV G6:深入图形与图形分组、自定义节点、节点动画(下)_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中,应该怎样去计算和绘制图形,如何给一个图形制作不间断的动画,以及在鼠标事件之后产生动画。(有点难,需要好好理解) <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06

学习hash总结

2014/1/29/   最近刚开始学hash,名字很陌生,但是hash的思想却很熟悉,以前早就做过此类的题,但是不知道这就是hash思想而已,说白了hash就是一个映射,往往灵活利用数组的下标来实现算法,hash的作用:1、判重;2、统计次数;

阿里开源语音识别SenseVoiceWindows环境部署

SenseVoice介绍 SenseVoice 专注于高精度多语言语音识别、情感辨识和音频事件检测多语言识别: 采用超过 40 万小时数据训练,支持超过 50 种语言,识别效果上优于 Whisper 模型。富文本识别:具备优秀的情感识别,能够在测试数据上达到和超过目前最佳情感识别模型的效果。支持声音事件检测能力,支持音乐、掌声、笑声、哭声、咳嗽、喷嚏等多种常见人机交互事件进行检测。高效推

如何在页面调用utility bar并传递参数至lwc组件

1.在app的utility item中添加lwc组件: 2.调用utility bar api的方式有两种: 方法一,通过lwc调用: import {LightningElement,api ,wire } from 'lwc';import { publish, MessageContext } from 'lightning/messageService';import Ca

零基础学习Redis(10) -- zset类型命令使用

zset是有序集合,内部除了存储元素外,还会存储一个score,存储在zset中的元素会按照score的大小升序排列,不同元素的score可以重复,score相同的元素会按照元素的字典序排列。 1. zset常用命令 1.1 zadd  zadd key [NX | XX] [GT | LT]   [CH] [INCR] score member [score member ...]

【机器学习】高斯过程的基本概念和应用领域以及在python中的实例

引言 高斯过程(Gaussian Process,简称GP)是一种概率模型,用于描述一组随机变量的联合概率分布,其中任何一个有限维度的子集都具有高斯分布 文章目录 引言一、高斯过程1.1 基本定义1.1.1 随机过程1.1.2 高斯分布 1.2 高斯过程的特性1.2.1 联合高斯性1.2.2 均值函数1.2.3 协方差函数(或核函数) 1.3 核函数1.4 高斯过程回归(Gauss

金融业开源技术 术语

金融业开源技术  术语 1  范围 本文件界定了金融业开源技术的常用术语。 本文件适用于金融业中涉及开源技术的相关标准及规范性文件制定和信息沟通等活动。