# subsampling-scale-image-view

**Repository Path**: wangyingjun01/subsampling-scale-image-view

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 24
- **Created**: 2022-04-18
- **Last Updated**: 2022-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# subsampling-scale-image-view

## 简介

>深度缩放视图，图像显示，手势平移缩放双击等

![img](img.gif)



## 下载安装
```shell
npm install @ohos/subsampling-scale-image-view --save
```
OpenHarmony npm环境配置等更多内容，请参考 [如何安装OpenHarmony npm包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_npm_usage.md) 。

## 使用说明

### 生成SubsamplingScaleImageView

   ```
   import {SubsamplingScaleImageView} from '@ohos/subsampling-scale-image-view';
   ...
   //创建model对象
   @State model: SubsamplingScaleImageView.Model  = new SubsamplingScaleImageView.Model()
   
   //设置图片源
    private aboutToAppear() {
    this.model.setImage($r('app.media.sanmartino'));
    }
   ...
   //使用SubsamplingScaleImageView组件
   SubsamplingScaleImageView({ model: this.model })
   ...
   ```
## 接口说明

1. 设置图片资源

   ```
   public setImage(src: string | PixelMap | Resource)
   public setImage(src: string | PixelMap | Resource, previewSource: string | Resource)
   public setImage(src: string | PixelMap | Resource, state: ImageViewState)
   ```
2. 设置图片是否可缩放
   ```
   setZoomEnabled(zoomEnabled: boolean)
   ```
3. 设置图片是否可平移
   ```
   public setPanEnabled(panEnabled: boolean)
   ```
4. 设置图片最大缩放比
   ```
   public setMaxScale(maxScale: number)
   ```
5. 设置图片旋转角度
   ```
   public setOrientation(degrees: number)
   ```
6. 获取图片高宽
   ```
   public getSWidth()  
   public getSHeight()
   ```
7. 单击监听器
   ```
   public setSingleTapListener(listener: OnSingleTapListener)
   ```
8. 长按监听器  
   ```
   public setLongPressListener(listener: OnLongPressListener)
   ```
9. 双击监听器
   ```
   public setDoubleTapListener(listener: OnDoubleTapListener)
   ```


## 目录结构
````
|---- subsampling-scale-image-view 
    |---- entry
    |     |---- pages  # 示例代码文件夹       
    |---- SubsamplingScaleImageView  
    |     |---- components  # 库文件夹               
    |     |     |---- SubsamplingScaleImageView.ets  # 自定义组件                         |---- index.ets  # 对外接口
    |     |     |---- ImageViewState.ets  # 组件状态数据封装类                 
    |     |---- README.MD  # 安装使用方法
````

## 贡献代码
使用过程中发现任何问题都可以提 [Issue](https://gitee.com/hihopeorg/subsampling-scale-image-view/issues) 给我们，当然，我们也非常欢迎你给我们发 [PR](https://gitee.com/hihopeorg/subsampling-scale-image-view/pulls) 。

## 开源协议
本项目基于 [Apache-2.0 License](https://gitee.com/hihopeorg/subsampling-scale-image-view/blob/master/LICENSE) ，请自由地享受和参与开源。