# PinchToZoom

**Repository Path**: applibgroup/PinchToZoom

## Basic Information

- **Project Name**: PinchToZoom
- **Description**: OHOS ImageView pinch-to-zoom made easy.
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-13
- **Last Updated**: 2022-01-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![Build](https://github.com/applibgroup/PinchToZoom/actions/workflows/main.yml/badge.svg)](https://github.com/applibgroup/PinchToZoom/actions/workflows/main.yml)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=applibgroup_PinchToZoom&metric=alert_status)](https://sonarcloud.io/dashboard?id=applibgroup_PinchToZoom)

# PinchToZoom
OHOS's ImageView/PhotoView pinch-to-zoom made easy

# Source
This library has been inspired by [martinwithaar\\PinchToZoom](https://github.com/martinwithaar/PinchToZoom).

## Get it

1. For using PinchToZoom module in sample app, include the source code and add the below dependencies in entry/build.gradle to generate hap/support.har.
```
implementation project(path: ':pinchtozoom')
implementation 'io.openharmony.tpc.thirdlib:PhotoView:1.1.1'
```
2. For using PinchToZoom module in separate application using har file, add the har file in the entry/libs folder and add the dependencies in entry/build.gradle file.
```
 implementation fileTree(dir: 'libs', include: ['*.har'])
 implementation 'io.openharmony.tpc.thirdlib:PhotoView:1.1.1'
```
3. For using PinchToZoom module from a remote repository in separate application, add the below dependencies in entry/build.gradle file.
```
implementation 'dev.applibgroup:pinchtozoom:1.0.0'
implementation 'io.openharmony.tpc.thirdlib:PhotoView:1.1.1'
```

## Overview
PinchToZoom for HarmonyOs is a simple yet feature complete library for adding pinch-to-zoom functionality to an *ImageView*. It has sleek easing animations that make it stand out in quality and ease of use.

### Features
* Pinch-to-zoom
* Double-tap to quickly zoom-in and out
* Drag while zoomed in
* Animated drag & zoom release easing
* Does not extend the *ImageView* class so is usable with custom *ImageView* implementations
* Fully customizable

## Integrate
Adding pinch-to-zoom functionality to your *ImageView* is easy as this:
```java
PhotoView photoView = (PhotoView) view.findComponentById(ResourceTable.Id_image);
photoView.setTouchEventListener(new ImageMatrixTouchHandler(getContext());
```

## Customization
The *ImageMatrixTouchHandler* class has multiple getter/setter methods that allow for changing the behavior and animation settings.