# LargeImage

**Repository Path**: openharmony-tpc/LargeImage

## Basic Information

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

## Statistics

- **Stars**: 5
- **Forks**: 16
- **Created**: 2022-02-21
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 🚨 **重要提示 | IMPORTANT**
>
> **⚠️ 此代码仓已归档。新地址请访问 [LargeImage](https://gitcode.com/openharmony-tpc/LargeImage)。| ⚠️ This repository has been archived. For the new address, please visit [LargeImage](https://gitcode.com/openharmony-tpc/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.tiger')); // 设置图片资源
    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 NEXT Developer Beta3: 5.0(5.0.3.530), SDK: API12 (5.0.0.35(SP3))

## 目录结构
````
|---- LargeImage
|     |---- entry     # 示例代码文件夹
|     |---- library     # LargeImage库文件夹
|     		|---- LargeImage.ets     # LargeImage对外接口
|     |---- README.md # 安装使用方法    
````


## 贡献代码

使用过程中发现任何问题都可以提[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)，请自由地享受和参与开源。