BigImageViewer
项目地址： Piasy/BigImageViewer 
文章图片
简介：Big image viewer supporting pan and zoom, with very little memory usage and full featured image loading choices. Powered by Subsampling Scale Image View, Fresco, Glide, and Picasso. Big image viewer supporting pan and zoom, with very little memory usage and full featured image loading choices. Powered by Subsampling Scale Image View, Fresco, Glide, and Picasso.
Demo
Usage
Dependency
allprojects {
repositories {
maven {
url"http://dl.bintray.com/piasy/maven"
}
}
}compile 'com.github.piasy:BigImageViewer:1.2.7'// load with fresco
compile 'com.github.piasy:FrescoImageLoader:1.2.7'// load with glide
compile 'com.github.piasy:GlideImageLoader:1.2.7'// progress pie indicator
compile 'com.github.piasy:ProgressPieIndicator:1.2.7'
initialize
// MUST use app context to avoid memory leak!
// load with fresco
BigImageViewer.initialize(FrescoImageLoader.with(appContext));
// or load with glide
BigImageViewer.initialize(GlideImageLoader.with(appContext));
Note that if you've already used Fresco in your project, please change
Fresco.initialize intoBigImageViewer.initialize.Layout
You can disable display optimization using
optimizeDisplay attribute, orBigImageView.setOptimizeDisplay(false). Which will disable animation for long image, and the switch between thumbnail and origin image.Java
BigImageView bigImageView = (BigImageView) findViewById(R.id.mBigImage);
bigImageView.showImage(Uri.parse(url));
// you can show thumbnail before the big image is loaded
bigImageView.showImage(Uri.parse(thumbnail), Uri.parse(url));
Downloading progress
bigImageView.setProgressIndicator(new ProgressPieIndicator());
【Android|BigImageViewer】There is one built-in indicator,
ProgressPieIndicator, you can implement your own indicator easily, learn by example.Prefetch
You can prefetch images in advance, so it could be shown immediately when user want to see it.
BigImageViewer.prefetch(uris);
Save image into gallery
bigImageView.setImageSaveCallback(new ImageSaveCallback() {
@Override
public void onSuccess(String uri) {
Toast.makeText(LongImageActivity.this,
"Success",
Toast.LENGTH_SHORT).show();
}@Override
public void onFail(Throwable t) {
t.printStackTrace();
Toast.makeText(LongImageActivity.this,
"Fail",
Toast.LENGTH_SHORT).show();
}
});
bigImageView.saveImageIntoGallery();
Get current image file
String path = bigImageView.currentImageFile();
// only valid when image file is downloaded.
Init scale type
mBigImageView.setInitScaleType(BigImageView.INIT_SCALE_TYPE_CENTER_CROP);
| value | effect |
|---|---|
| centerInside | default, Scale the image so that both dimensions of the image will be equal to or less than the corresponding dimension of the view. The image is then centered in the view. This is the default behaviour and best for galleries. |
| centerCrop | Scale the image uniformly so that both dimensions of the image will be equal to or larger than the corresponding dimension of the view. The image is then centered in the view. |
| auto | determine the max scale and min scale by image size and view size, fit the image to screen and centered when loaded. |
Caveats
- Handle permission when you want to save image into gallery.
- When you want load local image file, you can create the Uri via
Uri.fromFile, but the path will be url encoded, and may cause the image loader fail to load it, consider usingUri.parse("file://" + file.getAbsolutePath()).
They both support pan and zoom. PhotoDraweeView and FrescoImageViewer both use Fresco to load image, which will cause extremely large memory usage when showing big images. Subsampling Scale Image View uses very little memory, but it can only show local image file.
This library show big image with Subsampling Scale Image View, so it only uses very little memory. And this library support using different image load libraries, so it's full featured!
If you are interested in how does this library work, you can refer to this issue, and Subsampling Scale Image View.
Performance Memory usage of different libraries:
| - | PhotoDraweeView | FrescoImageViewer | BigImageViewer |
|---|---|---|---|
| 4135*5134 | 80MB | 80MB | 2~20 MB |
- [x] GlideImageLoader
- [x] Save image file to gallery
- [x] Optimize long image showing effect, thanks for razerdp
- [x] Optimize "double tap to zoom" effect, thanks for razerdp
- [x] Loading animation
- [x] Downloading progress
- [x] Thumbnail support
- [ ] Component to display image list, with memory optimization
- [ ] Fail image
- [ ] Retry when fail
- [ ] PicassoImageLoader, track this issue
