Name: PhotoView
Owner: Namshi
Description: Implementation of ImageView for Android that supports zooming, by various touch gestures.
Created: 2015-10-06 07:32:51.0
Updated: 2018-05-04 23:36:11.0
Pushed: 2015-10-06 14:37:32.0
Size: 16717
Language: Java
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Branch Develop: Branch Master:
PhotoView aims to help produce an easily usable implementation of a zooming Android ImageView.
The sample application (the source is in the repository) has been published onto Google Play for easy access:
Minimum code for Gradle integration, place code in your build.gradle
ndencies {
mpile 'com.commit451:PhotoView:1.2.4'
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:
eView mImageView;
oViewAttacher mAttacher;
rride
ic void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Any implementation of ImageView can be used!
mImageView = (ImageView) findViewById(R.id.iv_photo);
// Set the Drawable displayed
Drawable bitmap = getResources().getDrawable(R.drawable.wallpaper);
mImageView.setImageDrawable(bitmap);
// Attach a PhotoViewAttacher, which takes care of all of the zooming functionality.
mAttacher = new PhotoViewAttacher(mImageView);
f you later call mImageView.setImageDrawable/setImageBitmap/setImageResource/etc then you just need to call
acher.update();
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:
ic class HackyProblematicViewGroup extends ProblematicViewGroup {
public HackyProblematicViewGroup(Context context) {
super(context);
}
@Override
public boolean onInterceptTouchEvent(MotionEvent ev) {
try {
return super.onInterceptTouchEvent(ev);
} catch (IllegalArgumentException e) {
e.printStackTrace();
return false;
}
}
Development happens in develop branch of this repository, and Pull Requests should be filled against that branch. Any Pull Request against master will be rejected
Copyright 2011, 2012 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 applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.