+0
日增长
18,789
stars
3,893
forks
629
watchers
156
prs
697
issues
5
releases
README
PhotoView
PhotoView aims to help produce an easily usable implementation of a zooming Android ImageView.
![
Dependency
Add this in your root build.gradle file (not your module build.gradle file):
gradle
allprojects {
repositories {
maven { url "https://www.jitpack.io" }
}
}
buildscript {
repositories {
maven { url "https://www.jitpack.io" }
}
}
Then, add the library to your module build.gradle
gradle
dependencies {
implementation 'com.github.chrisbanes:PhotoView:latest.release.here'
}
Features
- Out of the box zooming, using multi-touch and double-tap.
- Scrolling, with smooth scrolling fling.
- Works perfectly when used in a scrolling parent (such as ViewPager).
- Allows the application to be notified when the displayed Matrix has changed. Useful for when you need to update your UI based on the current zoom/scroll position.
- Allows the application to be notified when the user taps on the Photo.
Usage
There is a sample provided which shows how to use the library in a more advanced way, but for completeness, here is all that is required to get PhotoView working:
xml
java
PhotoView photoView = (PhotoView) findViewById(R.id.photo_view);
photoView.setImageResource(R.drawable.image);
That's it!
Issues With ViewGroups
There are some ViewGroups (ones that utilize onInterceptTouchEvent) that throw exceptions when a PhotoView is placed within them, most notably ViewPager and DrawerLayout. This is a framework issue that has not been resolved. In order to prevent this exception (which typically occurs when you zoom out), take a look at HackyDrawerLayout and you can see the solution is to simply catch the exception. Any ViewGroup which uses onInterceptTouchEvent will also need to be extended and exceptions caught. Use the HackyDrawerLayout as a template of how to do so. The basic implementation is:
java
public class HackyProblematicViewGroup extends ProblematicViewGroup {
public HackyProblematicViewGroup(Context context) {
super(context);
}
@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
try {
return super.onInterceptTouchEvent(ev);
} catch (IllegalArgumentException e) {
//uncomment if you really want to see these errors
//e.printStackTrace();
return false;
}
}
}
Usage with Fresco
Due to the complex nature of Fresco, this library does not currently support Fresco. See this project as an alternative solution.
Subsampling Support
This library aims to keep the zooming implementation simple. If you are looking for an implementation that supports subsampling, check out this project
License
--------
Copyright 2018 Chris Banes
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicaTop issues
#168Zoom get reset when layout change22 comments · 2014-04-02#740Failed to resolve: com.github.chrisbanes:PhotoView:2.3.012 comments · 2020-02-09#363How to calculate a proper scale to fit screen's width?11 comments · 2016-05-19#357android:layout_centerInParent="true" not working in app10 comments · 2016-05-06#498How to show initially full image with PhotoView?9 comments · 2017-04-17#810Could not find com.github.chrisbanes:PhotoView:2.3.0. Required by: project :app Search in build.gradle files8 comments · 2021-09-29#708Bad works with viewpager28 comments · 2019-05-09#444Is there is any way to disable medium scale8 comments · 2016-10-27
Latest release
2.0.0 2.0.0 2017-03-18- MinSDK bumped to 14 - Listeners moved into their own classes outside of PhotoView - You should not need to have a reference to PhotoViewAttacher as most things can be called via the PhotoView itself. - PhotoView package change. Updated package will be com.github.chrisbanes.photoview.PhotoView