TouchImageView for Android 使用与技术文档

1. 安装指南

在您的Android项目中使用TouchImageView之前，您需要先在项目的build.gradle文件中进行以下配置：

首先，确保您的项目依赖于JitPack仓库：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

接着，在dependencies部分添加TouchImageView的依赖：

dependencies {
    implementation 'com.github.MikeOrtiz:TouchImageView:1.4.1' // 使用支持库版本
    // 或者
    implementation 'com.github.MikeOrtiz:TouchImageView:$LAST_VERSION' // 使用Android X版本
}

2. 项目的使用说明

TouchImageView继承自ImageView，并支持所有ImageView的功能。除此之外，TouchImageView增加了捏合缩放、拖动、滑动、双击缩放等功能，以及其他动画增强。TouchImageView的目的是尽可能接近镜像Gallery应用中可缩放图片的功能。

以下是一些使用TouchImageView的示例：

• 单TouchImageView: 基本使用，包括OnTouchImageViewListener、getScrollPosition()、getZoomedRect()、isZoomed()和getCurrentZoom()的使用。
• ViewPager示例: 在ViewPager中放置TouchImageView，类似于Gallery应用。
• 镜像示例: 使用onTouchImageViewListener和setZoom()来镜像两个TouchImageView。
• 切换图片示例: 点击TouchImageView以循环切换图片，注意缩放状态在图片切换时保持不变。
• 切换ScaleType示例: 点击TouchImageView以循环遍历支持的ScaleTypes。
• 调整大小示例: 点击箭头按钮来改变TouchImageView的形状和大小，观察各种“调整大小”设置下视图的变化。

3. 项目API使用文档

以下是TouchImageView提供的一些API方法：

• getCurrentZoom(): 获取当前缩放值。这是相对于初始缩放的缩放值，而不是原始资源的缩放值。
• getMaxZoom(): 获取最大缩放倍数。
• getMinZoom(): 获取最小缩放倍数。
• AUTOMATIC_MIN_ZOOM: 设置最小缩放倍数，使得可以查看整个图片。
• getScrollPosition(): 返回当前滚动位置。
• getZoomedRect(): 返回表示缩放图片的RectF。
• isZoomed(): 如果图片处于初始未缩放状态，返回false；否则返回true。
• resetZoom(): 重置缩放和翻译到初始状态。
• setMaxZoom(float max): 设置最大缩放倍数。
• setMinZoom(float min): 设置最小缩放倍数。
• setMaxZoomRatio(float max): 设置最大缩放倍数，使其保持在最小缩放倍数的固定倍数。
• setScrollPosition(float focusX, float focusY): 设置滚动位置。
• setZoom(float scale): 设置缩放值。
• setZoom(float scale, float focusX, float focusY): 在指定点设置缩放值。
• setZoom(float scale, float focusX, float focusY, ScaleType scaleType): 在指定点设置缩放值，并指定ScaleType。
• setZoom(TouchImageView img): 将缩放参数设置为另一个TouchImageView的缩放参数。
• setViewSizeChangeFixedPixel(FixedPixel fixedPixel): 设置在TouchImageView调整大小时应保持固定的部分。
• setOrientationChangeFixedPixel(FixedPixel fixedPixel): 设置在屏幕旋转时应保持固定的部分。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明，通过在项目的build.gradle文件中添加JitPack仓库和相应的依赖即可完成安装。