README.md · Rikimaru/LargeImage

# LargeImage

## 简介
加载可以执行缩放（放大和缩小）和滚动操作的图像，图像放大之后可以拖动查看。

详细功能：
1.加载图像。
2.支持缩放。
3.支持拖动查看大图。

# 下载安装

```javascript
ohpm install @ohos/largeimage
```

## 使用说明

```typescript
import {LargeImage} from '@ohos/largeimage'; // 导入库的代码

@Entry
@Component
struct Index {
  @State model: LargeImage.Model  = new LargeImage.Model() //创建模型
  @State rotate:number =0;
    
  private aboutToAppear() { 
    this.model.setImage($r('app.media.card')); // 设置图片资源
    this.model.setMaxScale(2); // 设置图片最大缩放比例
  }

build() {
    Stack({ alignContent: Alignment.Bottom }) {
      LargeImage({ model: this.model }) // 加载大图对象
          Image($r('app.media.rotate'))
              .width(30)
              .height(30)
              .margin({ top: 6 ,left:10,right:20})
              .onClick((event: ClickEvent) => {
                this.rotate +=90;
                this.model.setOrientation(this.rotate) // 设置图片旋转角度
              })
    }
  }
}

```

## 接口说明

| 接口名                                       | 参数                          | 返回值 | 说明                     |
| -------------------------------------------- | ----------------------------- | ------ | ------------------------ |
| setImage                                     | src: Resource                 | void   | 设置图像资源             |
| setZoomEnabled                               | zoomEnabled: boolean          | void   | 设置是否可以缩放图像。   |
| setPanEnabled                                | panEnabled: boolean           | void   | 设置是否可以平移图像。   |
| setMaxScale                                  | maxScale: number              | void   | 设置图像的最大缩放比例。 |
| setOrientation                               | degrees: number               | void   | 设置图像旋转角度         |
| getLoadedImageWidth<br/>getLoadedImageHeight | 无                            | number | 获取源图像的宽度和高度   |
| setSingleTapListener                         | listener: OnSingleTapListener | void   | 设置单击事件监听器       |
| setLongPressListener                         | listener: OnLongPressListener | void   | 设置长按事件监听器       |
| setDoubleTapListener                         | listener: OnDoubleTapListener | void   | 设置双击事件监听器       |

## 约束与限制
在下述版本验证通过：

- DevEco Studio: 4.0 (4.0.3.512), SDK: API10 (4.0.10.9)
- DevEco Studio: 4.0 Canary1(4.0.0.112), SDK: API10 (4.0.7.2)

## 贡献代码

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

## 开源协议

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

Rikimaru/LargeImage

简介

发行版

贡献者

近期动态

Rikimaru/LargeImage .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

Rikimaru/LargeImage