| commit | d76f655fc29c5b3858d6657f22a5c656c3143767 | [log] [tgz] |
|---|---|---|
| author | Sam Judd <sam@bu.mp> | Tue Jul 16 16:41:10 2013 -0700 |
| committer | Sam Judd <sam@bu.mp> | Wed Jul 17 18:18:01 2013 -0700 |
| tree | 35a5ea5c36868d5974fa3158a692f75c878c8046 | |
| parent | 4d2a2db41999cb6f2c79a6b63a93ea6e2adc49b9 [diff] |
Create a simple static interface for Glide Allows most of the functionality of the library without having to directly create and manage an ImageManager and ImagePresenters. Doesn't currently allow for all functionality and is somewhat less efficient because it encourages allocations of unneeded objects, but it is easier to use and should cover enough cases to be useful.
Glide is an image loading library for Android that wraps image loading, resizing, memory and disk caching, and bitmap recycling into one simple and easy to use interface.
Glide works best for long lists or grids where every item contains an image or images, but it's also effective for almost any case where you need to fetch, resize, and display a remote image.
If you only have local assets or very infrequently display remote assets and never display remote or resized assets in a list, then Glide is probably overkill for you.
Also you probably shouldn't bother if you're not writing an Android app...
Anyone who displays large numbers of images can benefit from Glide.
Glide abstracts away most of the complications with image view recycling in lists, as well as resizing and caching images.
Glide is also unobtrusive. It doesn't require you to change any xml or create any subclasses.
Finally Glide is performant. Image loading is fast without using lots of cpu or causing jerk inducing garbage collections.
The only thing you need to implement is a simple interface that fetches a path for a given model. You then need an ImageManager instance which manages loading images from paths in the background, and an ImagePresenter instance per image view. To use Glide in an adapter for a list, your code will look something like this:
public class MyAdapter extends BaseAdapter { private final ImageManager imageManager; public MyAdapter(Context context) { imageManager = new ImageManager.Builder(context).build(); } ... @Override public View getView(int position, View recycled, ViewGroup container) { final MyModel current = myModels.get(position); final ImagePresenter<MyModel> presenter; if (recycled == null) { recycled = myInflater.inflate(R.layout.my_image_view, container, false); presenter = new ImagePresenter.Builder<MyModel>() .setImageView((ImageView) recycled) .setPathLoader(new MyPathLoader()) .setImageLoader(new CenterCrop(imageManager)) .build(); recycled.setTag(presenter); } else { presenter = (ImagePresenter<MyModel>) recycled.getTag(); } presenter.setModel(current); } }
The ImagePresenter will ensure that the view only displays the most recent model. It also determines the exact size of the image and passes that to both the PathLoader and the ImageLoader.
This means that you can fetch the correctly sized image directly or Glide can resize each image to the right size even if you don't know the size at compile time (because you're using layout weights for example).
Behind the scenes the ImageManager will load resize the image from disk using a background thread and then cache that resized image in memory and on disk. This means that you don't have to waste cpu and memory displaying images that are larger than your view. On newer devices (SDK >= 11), the ImageManager will also recycle bitmaps and prevent the garbage collection pauses that typically go along with bitmap allocation.
Fewer garbage collections, less memory per image, and less cpu time dedicated to resizing each image on the fly means dramatically smoother scrolling and faster image loading.
Glide is an Android library project so its fairly straightforward to add it. Either add this repo as a submodule or otherwise check out this repository in your project and then follow the steps in the Android docs to add it as a library project: http://developer.android.com/tools/projects/projects-cmdline.html#ReferencingLibraryProject
Intellij and Eclipse instructions coming soon.
For more concrete examples see the wiki for tutorials and/or the sample flickr app.
Glide has been in use at Bump for about six months in two of our Android apps. The API is mostly stable though there may be some superficial changes. Comments/bugs/questions/pull requests welcome!