# ImageViewZoom

**Repository Path**: zdy09/ImageViewZoom

## Basic Information

- **Project Name**: ImageViewZoom
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 35
- **Created**: 2023-04-25
- **Last Updated**: 2023-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ImageViewZoom

## 简介

> ImageViewZoom 支持加载 Resource 或 PixelMap 图片，支持设置图像显示类型功能，支持缩放功能，支持平移功能，双击放大功能，可以监听图片大小，资源变化事件，支持清除显示图片功能。

## 效果展示

![avatar](screenshot/效果展示.gif)

## 下载安装

```shell
ohpm install @ohos/imageviewzoom 
```

OpenHarmony ohpm 环境配置等更多内容，请参考[如何安装 OpenHarmony ohpm 包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_har_usage.md)

## 使用说明

ets 代码依赖

```
import {ImageViewTouch, DisplayType} from "@ohos/imageviewzoom"
import {PixelMapUtils} from "./PixelMapUtils"
...
//创建model对象
@State private model: ImageViewTouch.Model = new ImageViewTouch.Model();
...
//使用ImageViewTouch组件
ImageViewTouch({ model: $model });
...
```

## 接口说明

1. 设置图片资源

   `public setImageSrc(src ?: Resource | PixelMap, matrix ?: object, minZoom ?: number, maxZoom ?: number): void`

2. 设置默认图像显示类型

   `public setDisplayType(type: DisplayType)`

   DisplayType.NONE：图像默认不缩放。
   DisplayType.FIT_TO_SCREEN：图像将始终使用此视图的边界呈现。
   DisplayType.FIT_IF_BIGGER：仅当大于此视图的边界时才会缩放图像。
   DisplayType.FIT_HEIGHT：图像将被缩放以适合设备的高度。
   DisplayType.FIT_WIDTH：图像将被缩放以适合设备的宽度。

3. 清除当前显示的图片

   `public dispose(): void`

4. 设置是否能够双击

   `public setDoubleTapEnabled(value: boolean): void`

5. 设置是否能够缩放

   `public setScaleEnabled(value: boolean): void`

6. 设置是否能够滚动

   `public setScrollEnabled(value: boolean): void`

7. 设置图片资源变化监听事件

   `public setOnDrawableChangedListener(listener: OnDrawableChangeListener): void`

8. 设置图片大小变化监听事件

   `public setOnLayoutChangeListener(listener: OnLayoutChangeListener): void`

## 约束与限制

在下述版本验证通过：

- DevEco Studio: 3.1 Beta2(3.1.0.400) SDK: API9 Release(3.2.11.9)
- 适配DevEco Studio: 4.0 Canary1(4.0.0.112), SDK: API10 (4.0.7.3)

## 目录结构

```
|---- ImageViewZoom
|     |---- entry  # 示例代码文件夹
|     |---- ImageViewZoom  # ImageViewZoom库文件夹
|        |----src
|           |----main
|              |----ets
|                 |---- components
|                       |---- utils  # 工具库
|                             |---- IDisposable.ets  # 提供清除图片接口
|                       |---- ImageViewTouch.ets  # 自定义控件
|           |---- index.ets  # 对外接口
|     |---- README.MD  # 安装使用方法
|     |---- LICENSE #证书
```

## 贡献代码

使用过程中发现任何问题都可以提 [Issue](https://gitee.com/openharmony-sig/ImageViewZoom/issues) 给我们，当然，我们也非常欢迎你给我们发 [PR](https://gitee.com/openharmony-sig/ImageViewZoom/pulls) 。

## 开源协议

本项目基于 [Apache License 2.0](https://gitee.com/openharmony-sig/ImageViewZoom/blob/master/LICENSE) ，请自由地享受和参与开源。