An open API service indexing awesome lists of open source software.

https://github.com/justdvnsh/twodscrollablezoomablelayout

An android library which lets you add a view with two dimensional scrolling (X & Y) and zoom.
https://github.com/justdvnsh/twodscrollablezoomablelayout

android android-application android-architecture android-java android-library android-ui hacktoberfest hacktoberfest2021 image-view image-viewer java java-8 java-libra library

Last synced: 3 months ago
JSON representation

An android library which lets you add a view with two dimensional scrolling (X & Y) and zoom.

Awesome Lists containing this project

README

          

[![MIT License][license-shield]][license-url]
[![LinkedIn][linkedin-shield]][linkedin-url]
[!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/justdvnsh)
[![Patreon][patreon-shield]][patreon-url]
[![Slack][slack-shield]][slack-url]



Two Dimensional Scroll View With Zoom


An awesome library to include Two Dimensional Scroll view with zooming capabilities in your app.


Explore the docs »




Report Bug
·
Request Feature


Table of Contents



  1. About The Project


  2. Getting Started


  3. Contributing

  4. License

  5. Contact

## About The Project

The project aims to solve a personal problem of including Two Dimensional Scrolling view with zoom.
A few my projects needed this feature to view the images just like a wallpaper app does to let you set the wallpaper.
However, the scroll views in the wallpapers simply scroll horizontally. My problem was that a lot of images were loosing their quality if they were set to the phone's height.
I didn't want that. For example, my [AnimeClassroom](https://github.com/justdvnsh/AnimeClassroom) has a manga reading feature. Now the images in mangas are very large both horizontally and vertically. If the height was set to match phone's height, the image lost its quality thus making it harder to read.
So, I made this Custom view to solve that problem. Now, I have converted this into a library so that it could be used in any project.

__WARNING! : THIS PROJECT IS STILL IN HEAVY DEVELOPMENT, THEREFORE YOU MAY ENCOUNTER BUGS. You can OPEN the ISSUE on GITHUB REPOSITORY.__

__NEW FEATURES WILL BE ADDED REGULARLY__

(Back to top)

## Getting Started

Simply fork the repo. Clone it into your machine and let AndroidStudio handle the rest.

## Installation

To include this library, follow the below steps.

Step 1 -> Add this line in ```root build.gradle``` at the end of repositories.

```
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```

Step 2 -> Add this line in your ```module build.gradle``` file.

```
dependencies {
implementation 'com.github.justdvnsh:TwoDScrollableZoomableLayout:0.0.2'
}
```

See the [open issues](https://github.com/justdvnsh/TwoDScrollableZoomableLayout/issues) for a full list of proposed features (and known issues).

(Back to top)

## Sample Video demonstration

[![Alternate Text]](https://drive.google.com/file/d/1L95IzOvjmh7dfpvyRp422-1FlAZrN0ro/view?usp=sharing)

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "feature-request".
Don't forget to give the project a star! Thanks again!

__NOTE -> Every PR will be reviewed before merging.__

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

#### PLEASE MAKE SURE TO REMOVE THE .idea/ files before pushing a commit

__Want to support me by buying me a coffee ?__ [!["Buy Me A Coffee"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/justdvnsh)

__Want to contribute to this project by supporting us through money ?__ [![Patreon][patreon-shield]][patreon-url]

__Want to join the discussions ?__ [![Slack][slack-shield]][slack-url]

(Back to top)

## License

Distributed under the MIT License. See `LICENSE.txt` for more information.

(back to top)

## Contact

Divyansh Dwivedi - [@justdvnsh](https://linkedin.com/in/justdvnsh) - justdvnsh2208@gmail.com

Project Link: [https://github.com/justdvnsh/TwoDScrollableZoomableLayout](https://github.com/justdvnsh/TwoDScrollableZoomableLayout)

Join Discussion at: [![Slack][slack-shield]][slack-url]

(Back to top)

[contributors-shield]: https://img.shields.io/github/contributors/othneildrew/Best-README-Template.svg?style=for-the-badge
[contributors-url]: https://github.com/othneildrew/Best-README-Template/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/othneildrew/Best-README-Template.svg?style=for-the-badge
[forks-url]: https://github.com/othneildrew/Best-README-Template/network/members
[stars-shield]: https://img.shields.io/github/stars/othneildrew/Best-README-Template.svg?style=for-the-badge
[stars-url]: https://github.com/othneildrew/Best-README-Template/stargazers
[issues-shield]: https://img.shields.io/github/issues/othneildrew/Best-README-Template.svg?style=for-the-badge
[issues-url]: https://github.com/othneildrew/Best-README-Template/issues
[license-shield]: https://img.shields.io/github/license/othneildrew/Best-README-Template.svg?style=for-the-badge
[license-url]: https://github.com/othneildrew/Best-README-Template/blob/master/LICENSE.txt
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
[linkedin-url]: https://linkedin.com/in/justdvnsh
[product-screenshot]: images/screenshot.png
[patreon-shield]: https://img.shields.io/badge/Patreon-F96854?style=for-the-badge&logo=patreon&logoColor=white
[patreon-url]: https://www.patreon.com/justdvnsh
[slack-shield]: https://img.shields.io/badge/Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white
[slack-url]: https://join.slack.com/t/animeclassroom/shared_invite/zt-wut0t5mp-Y4kF6OGyxLBpyNM0eU6psw