# apng-drawable

**Repository Path**: mirrors_line/apng-drawable

## Basic Information

- **Project Name**: apng-drawable
- **Description**: A lightweight and fast Animated Portable Network Graphics (APNG) image decoder for Android
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-25
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ApngDrawable

[![Maven Central](https://img.shields.io/maven-central/v/com.linecorp/apng)](https://search.maven.org/artifact/com.linecorp/apng)

ApngDrawable is fast and light weight Animated Portable Network Graphics(APNG) image decoder library for Android platform.
ApngDrawable is written in Kotlin and C++.

## How to use

Use Gradle to build the library. Download it from [Maven Central](https://search.maven.org/artifact/com.linecorp/apng) and add configurations in the `build.gradle` file as follows.

```build.gradle
// In your top-level project's `build.gradle`
allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

// In your app project's `build.gradle`
dependencies {
  implementation 'com.linecorp:apng:x.y.z'
}
```

If using Kotlin Gradle DSL, add configurations in the `build.gradle.kts` file as follows.

```build.gradle.kts
// In your top-level project's `build.gradle.kts`
allprojects {
    repositories {
        mavenCentral()
    }
}

// In your app project's `build.gradle.kts`
dependencies {
  implementation("com.linecorp:apng:x.y.z")
}
```

## Getting started

You can decode from a lot of source types, e.g. File, InputStream and Resources.

```kotlin
// Decode from File
val drawable1 = ApngDrawable.decode(File("path/to/file"))

// Decode from InputStream
val drawable2 = File("path/to/file").inputStream().use {
    ApngDrawable.decode(it)
}

// Decode from Resources
val drawable3 = ApngDrawable.decode(context.resources, R.raw.apng_image)
```

You can find a more advanced way of using the library from the [example](https://github.com/line/apng-drawable/tree/master/sample-app).

## How to build

Note: This operation is necessary when building from code. It's not necessary if you are reading using `implementation` as shown in "[How to use]".

The patched `libpng` sources aren't included in the repository.
You need to download `libpng` and apply APNG patch first.

```sh
$ cat libpng_version | xargs ./download_libpng_and_apply_apng_patch.sh
$ ./gradlew :sample-app:assembleDebug
```


## How to contribute to ApngDrawable

See [CONTRIBUTING.md](CONTRIBUTING.md)

If you believe you have discovered a vulnerability or have an issue related to security, please contact the maintainer directly or send us a email to dl_oss_dev@linecorp.com before sending a pull request.

## License

```
Copyright 2018 LINE Corporation

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

   http://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.
```