A lightweight image loading library for Android backed by Kotlin Coroutines.
Optimal: Pixel performs optimizations with memory caching, downsampling the image in memory by image view size (pixel by pixel), re-using Bitmaps, automatically pause/cancel requests (Signature requests), and more.
Light: Pixel adds less than ~250 methods for now to your APK (for apps that already use coroutines), which is considerably less than Glide,Fresco,Picasso and Coil.
Easy to use: Pixel's API uses Kotlin's language features and classic design for simplicity and minimal boilerplate.
Modern: Pixel is Kotlin-first and interoperable with Java.
- Signature Loads
- Image Loading (For now image loading from network is supported only)
- Modern (Kotlin Co-routines for structured concurrency and low latency)
- Reliable (No 3rd party library used)
- Supports JAVA
- It only downloads the image per width and height of image view per pixel hence the name and pauses all loads when UI is not available.
- Signature Download (Same image download with same requested width and height will cancel previous such download in progress)
- Synchronous load cancellation.
- UI Responsive.
Gradle
implementation 'io.pixel.android:pixel:0.0.2'
Maven
<dependency>
<groupId>io.pixel.android</groupId>
<artifactId>pixel</artifactId>
<version>0.0.2</version>
<type>pom</type>
</dependency>
For complete usage in Kotlin and Java clone the project in Android Studio and run the sample app included.
Load an Image
Pixel.load("https://images.unsplash.com/photo-1492684223066-81342ee5ff30?ixlib=rb-1.2.1&auto=format&fit=crop&w=1000&q=80", iv)
Load an Image with options
//Loads an image with a placeholder resource.
Pixel.load("image path", iv3, PixelOptions.Builder().setPlaceholderResource(R.drawable.ic_loading_android).build())
/**Loads an image of 30x30 pixels with a placeholder resource.
For best result, know the size of image from source and don't provide size less than size of image view
**/
Pixel.load("image path", holder.iv, PixelOptions.Builder().setPlaceholderResource(R.drawable.ic_loading_android)
.setImageSize(30, 30).build())
Cancel an image load
// cancels the load
Pixel.load("https://images.unsplash.com/photo-1492684223066-81342ee5ff30?ixlib=rb-1.2.1&auto=format&fit=crop&w=1000&q=80", iv1).cancel()
Load JSON Object (Till Version 0.0.2)
Pixel.loadJsonObject("https://jsonplaceholder.typicode.com/todos/1") {
// do something with it here
}
Load JSON Array (Till Version 0.0.2)
Pixel.loadJsonArray("https://jsonplaceholder.typicode.com/users") {
// do something with it here.
}
Configure and clear memory cache
// Set image memory cache to 48000 KBS which is 48MBS
PixelConfiguration.setImageMemoryCacheSize(48000)
// Set JSON memory cache to 16000 KBS which is 16MBS
PixelConfiguration.setJSONMemoryCacheSize(16000)
// Clear image cache
PixelConfiguration.clearImageCache()
// Clear JSON cache
PixelConfiguration.clearDocumentCache()
// Clear all caches
PixelConfiguration.clearCaches()
Logging
// Enable logging behavior
PixelConfiguration.setLoggingEnabled(true)
// Disable logging behavior (Default)
PixelConfiguration.setLoggingEnabled(false)
- Min SDK 14
- Compile SDK 29+
Pixel is completely compatible with R8 and doesn't require adding any extra rules.
If you use Proguard, you may need to add rules for Coroutines
Read more on medium.
See release notes here.
This library is maintained and under development as new features are periodically added.
Issues can be reported here.
The idea of employing Kotlin Coroutines that drive the working of this library partly came from Coil.
Copyright 2020 Pixel Contributors
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
https://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.