# APNG4Android

**Repository Path**: wangfeigit/APNG4Android

## Basic Information

- **Project Name**: APNG4Android
- **Description**: 好用的Android动画播放库,内存占用低,支持APNG、WebP、Gif,提供Glide插件.
- **Primary Language**: Android
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2021-08-14
- **Last Updated**: 2021-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Animation Android
* Support APNG & Animated Webp & Gif in Android
* Efficient decoder
* Support Drawable usage and glide library module
* Support animation play control
* Support still image
* Low memory usage

## Changelog 2.5.0
* Migrate to Android X & update glide to 4.11.0

## Changelog 2.4.2
* Close debug logs

## Changelog 2.4.1
* Fix Glide plugin apng cannot play
* Optimize glide plugin's use case


## Changelog 2.4.0
* Add API to support get  any indexed frame as bitmap
* Glide plugin support transform animated webp to bitmap
* Fix scale type fitXY caused buffer not enough issue

## Changelog 2.3.0
* Fix WebPEncoder's bug

## Changelog 2.2.0
* Downgrade Glide to 4.8
* Android Support Migration

## Changelog 2.1.0
* Fix handling APNG dispose to previous error.

## Changelog 2.0.0
* Android X Migration
* Upgrade Glide to 4.11

## Changelog 1.3.3
* Fix problems of small probability
    * Avoid the posibility that render a recycled bitmap
    * Fix Null point Exception when new thread
    * Avoid buffer size smaller than the target bitmap

## Changelog 1.3.1
* Fix ANR when switch visibility of animation drawable quickly.

## Changelog 1.2.0
* Fix vp8x chunk alpha in reserve digits
* Fix webp glitch error on display

## Usages

### Add dependency in build.gradle

```gradle
repositories {
    jcenter()
}
```
#### Animated WebP
```gradle
dependencies {
    implementation 'com.github.penfeizhou.android.animation:awebp:2.4.2'
}
```
#### APNG
```gradle
dependencies {
    implementation 'com.github.penfeizhou.android.animation:apng:2.4.2'
}
```
#### Gif
```gradle
dependencies {
    implementation 'com.github.penfeizhou.android.animation:gif:2.4.2'
}
```
### Use

```java
// Load from asset file
AssetStreamLoader assetLoader = new AssetStreamLoader(context, "wheel.png");


// Load form Resource
ResourceStreamLoader resourceLoader = new ResourceStreamLoader(context, R.drawable.sample);


// Load from file
FileStreamLoader fileLoader = new FileStreamLoader("/sdcard/Pictures/1.webp");


// Create APNG Drawable
APNGDrawable apngDrawable = new APNGDrawable(assetLoader);

//Create Animated webp drawable
WebPDrawable webpDrawable = new WebPDrawable(assetLoader);

// Auto play
imageView.setImageDrawable(apngDrawable);


// Not needed.default controlled by content
apngDrawable.setLoopLimit(10);


// Implement Animatable2Compat
drawable.registerAnimationCallback(new Animatable2Compat.AnimationCallback() {
    @Override
    public void onAnimationStart(Drawable drawable) {
        super.onAnimationStart(drawable);
    }
});
```
## Glide support

### Add dependency in build.gradle

```gradle
repositories {
    maven {
        url "https://dl.bintray.com/osborn/Android"
    }
}
dependencies {
    implementation 'com.github.penfeizhou.android.animation:glide-plugin:2.4.2'
}
```
### Direct use

```java
Glide.with(imageView).load("https://misc.aotu.io/ONE-SUNDAY/SteamEngine.png").into(imageView);
Glide.with(imageView).load("https://isparta.github.io/compare-webp/image/gif_webp/webp/2.webp").into(imageView);
```