Skip to content
A lightweight and fast Animated Portable Network Graphics (APNG) image decoder for Android
Kotlin C++ CMake C Shell
Branch: master
Clone or download
r-ralph Merge pull request #50 from r-ralph/v1.6.0
Bump up version to 1.6.0
Latest commit 84e8ec5 Jun 6, 2019

README.md

ApngDrawable

Download

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 JCenter and add configurations in the build.gradle file as follows.

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

// 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.

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

// 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.

// 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.

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.

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

How to contribute to ApngDrawable

See CONTRIBUTING.md

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.
You can’t perform that action at this time.