https://github.com/zjupure/glidewebpdecoder

A Glide WebpDecoder Intergration Library for decoding and displaying webp images
https://github.com/zjupure/glidewebpdecoder

android animated-webp glide webp

Last synced: 4 days ago
JSON representation

A Glide WebpDecoder Intergration Library for decoding and displaying webp images

• Host: GitHub
• URL: https://github.com/zjupure/glidewebpdecoder
• Owner: zjupure
• License: apache-2.0
• Created: 2017-12-13T02:59:40.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2023-10-02T03:06:59.000Z (about 1 year ago)
• Last Synced: 2024-03-19T09:00:36.903Z (8 months ago)
• Topics: android, animated-webp, glide, webp
• Language: C
• Homepage:
• Size: 8.9 MB
• Stars: 726
• Watchers: 14
• Forks: 89
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## GlideWebpDecoder

[![license](http://img.shields.io/badge/license-Apache2.0-brightgreen.svg?style=flat)](https://github.com/zjupure/GlideWebpDecoder/blob/master/LICENSE)

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.github.zjupure/webpdecoder/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.github.zjupure/webpdecoder)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/zjupure/GlideWebpDecoder/pulls)

GlideWebpDecoder is a [Glide](https://github.com/bumptech/glide) integration library for decoding and displaying webp images on Android platforms. It is based on [libwebp](https://github.com/webmproject/libwebp) project and takes some implementation from [Fresco](https://github.com/facebook/fresco) and [GlideWebpSupport](https://github.com/roths/GlideWebpSupport) as references.

## Features

* play animated webp images on all Android versions

* show transparent or lossless webp images on Android devices lower than 4.2.1 (BitmapFactory support webp decode on 4.2+ android system so we have no need to handle)

## Dependency Integration

Library is available in MavenCentral. If you build with Gradle, just add the following dependencies to your `build.gradle` file.

Different Glide version is corresponding to different GlideWebpDecoder due to the annotation processor compatibility. The version rule of GlideWebpDecoder is "{major_version}.{glide_version}".

For example, if you use glide 4.16.0, the corresponding version of GlideWebpDecoder should be 2.6.4.16.0

Library will only follow the latest three version of Glide. If you use a lower version glide, please clone the project and modify it yourself.

**Notice**

Since Glide 4.10.0 has migrate to AndroidX, so your project must use AndroidX with Glide 4.10.0+. 

WebpDecoder with AndroidX support starts from version 1.6.{GLIDE_VERSION} and won't support glide version below 4.10.0 anymore.

**Attention**

Since [JCenter is being taken down on May 1 2021](https://jfrog.com/blog/into-the-sunset-bintray-jcenter-gocenter-and-chartcenter/) and then close their service, so the library has migrate artifacts to [Maven Central](https://search.maven.org/). See issue [#76](https://github.com/zjupure/GlideWebpDecoder/issues/76) for more detail.

Changes:

* library group id has changed from `com.zlc.glide` to `com.github.zjupure`

* add `mavenCentral()` in your `build.gradle` to fetch this library

* only 2.0 version with glide 4.10~4.16 has been migrated and older version not support anymore

If your project use old library version below 2.0, you should upgrade the library to the latest 2.0 version.

```gradle

def GLIDE_VERSION = "4.16.0"

// webpdecoder

implementation "com.github.zjupure:webpdecoder:2.6.${GLIDE_VERSION}"

// glide 4.10.0+

implementation "com.github.bumptech.glide:glide:${GLIDE_VERSION}"

annotationProcessor "com.github.bumptech.glide:compiler:${GLIDE_VERSION}"

```

Then you are free to use GlideWebpDecoder just like using other Glide integration library.

## Usage

Basic usage see [Glide](https://github.com/bumptech/glide) API [documents](https://bumptech.github.io/glide/)

If you want to use `BitmapTransformation` or library [glide-transformations](https://github.com/wasabeef/glide-transformations), please use `WebpDrawableTransformation` to wrap your original `BitmapTransformation` when loading image with Glide request.

Code Snippet as follow. Run sample project to see other Glide built-in transformation effect.

```

Transformation circleCrop = new CircleCrop();

GlideApp.with(mContext)

        .load(url)

        .optionalTransform(circleCrop)

        .optionalTransform(WebpDrawable.class, new WebpDrawableTransformation(circleCrop))

        .into(imageView);

```

## Proguard

The library use native code to decode webp, so you should put the following lines to your `proguard.cfg` and keep the jni interface.

```pro

-keep public class com.bumptech.glide.integration.webp.WebpImage { *; }

-keep public class com.bumptech.glide.integration.webp.WebpFrame { *; }

-keep public class com.bumptech.glide.integration.webp.WebpBitmapFactory { *; }

```

## Acknowledgement

* [libwebp](https://github.com/webmproject/libwebp)

* [Fresco](https://github.com/facebook/fresco)

* [GlideWebpSupport](https://github.com/roths/GlideWebpSupport)

## License

The Library is [Apache-2.0-licensed](https://github.com/zjupure/GlideWebpDecoder/blob/master/LICENSE), part code is [MIT-licensed](https://github.com/facebook/fresco/blob/master/LICENSE) see [Fresco](https://github.com/facebook/fresco) for detail.