Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/koush/UrlImageViewHelper
Android library that sets an ImageView's contents from a url. Manages image downloading, caching, and makes your coffee too.
https://github.com/koush/UrlImageViewHelper
Last synced: 2 months ago
JSON representation
Android library that sets an ImageView's contents from a url. Manages image downloading, caching, and makes your coffee too.
- Host: GitHub
- URL: https://github.com/koush/UrlImageViewHelper
- Owner: koush
- License: other
- Created: 2011-04-12T19:57:36.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2014-06-19T18:18:25.000Z (over 10 years ago)
- Last Synced: 2024-10-12T16:18:43.616Z (3 months ago)
- Language: Java
- Homepage:
- Size: 2.65 MB
- Stars: 968
- Watchers: 79
- Forks: 262
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-android-person - UrlImageViewHelper
README
# This library has been deprecated, use ion instead:
http://github.com/koush/ion
## UrlImageViewHelper
UrlImageViewHelper will fill an ImageView with an image that is found at a URL.
### Sample Project
The sample will do a Google Image Search and load/show the results asynchronously.
### Download
Download [the latest JAR](http://repository.sonatype.org/service/local/artifact/maven/redirect?r=central-proxy&g=com.koushikdutta.urlimageviewhelper&a=urlimageviewhelper&v=LATEST
) or grab via Maven:
```xml
com.koushikdutta.urlimageviewhelper
urlimageviewhelper
(insert latest version)
```
### Usage
UrlImageViewHelper will automatically download and manage all the web images and ImageViews.
Duplicate urls will not be loaded into memory twice. Bitmap memory is managed by using
a weak reference hash table, so as soon as the image is no longer used by you,
it will be garbage collected automatically.
Usage is simple:
```java
UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png");
```
Want a placeholder image while it is being downloaded?
```java
UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png", R.drawable.placeholder);
```
Don't want to use a placeholder resource, but a drawable instead?
```java
UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png", drawable);
```
What if you want to preload images for snazzy fast loading?
```java
UrlImageViewHelper.loadUrlDrawable(context, "http://example.com/image.png");
```
What if you only want to cache the images for a minute?
```java
// Note that the 3rd argument "null" is an optional interstitial
// placeholder image.
UrlImageViewHelper.setUrlDrawable(imageView, "http://example.com/image.png", null, 60000);
```
UrlImageViewHelper is pretty smart. It can even load the photo for an Android contact
if given a Contact Content Provider URI.
```java
UrlImageViewHelper.setUrlDrawable(imageView, "content://com.android.contacts/contacts/1115", R.drawable.dummy_contact_photo);
```
### FAQ
**Does it work in list adapters when views are reused? (convertView)**
Yes.
### Featured Implementations
* [ROM Manager](https://play.google.com/store/apps/details?id=com.koushikdutta.rommanager&hl=en)
* [Carbon](https://play.google.com/store/apps/details?id=com.koushikdutta.backup&hl=en)
* Let me know if you use this library, so I can add it to the list!