https://github.com/felipecsl/gifimageview

Android ImageView that handles animated GIF images
https://github.com/felipecsl/gifimageview

android animation gif

Last synced: about 1 month ago
JSON representation

Android ImageView that handles animated GIF images

• Host: GitHub
• URL: https://github.com/felipecsl/gifimageview
• Owner: felipecsl
• License: mit
• Created: 2014-05-14T20:20:24.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2023-04-03T00:46:15.000Z (over 1 year ago)
• Last Synced: 2024-10-14T10:06:34.854Z (about 1 month ago)
• Topics: android, animation, gif
• Language: Kotlin
• Homepage:
• Size: 4.31 MB
• Stars: 1,164
• Watchers: 37
• Forks: 272
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# GifImageView

Android ImageView that handles Animated GIF images

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-GifImageView-brightgreen.svg?style=flat)](https://android-arsenal.com/details/1/1339)

[![Build Status](https://travis-ci.org/felipecsl/GifImageView.svg?branch=master)](https://travis-ci.org/felipecsl/GifImageView)

### Usage

In your ``build.gradle`` file:

```groovy

dependencies {

    implementation 'com.felipecsl:gifimageview:2.2.0'

}

```

In your `Activity` class:

```java

@Override protected void onCreate(final Bundle savedInstanceState) {

  super.onCreate(savedInstanceState);

  gifView = findViewById(R.id.gifImageView);

  gifView.setBytes(bitmapData);

}

@Override protected void onStart() {

  super.onStart();

  gifView.startAnimation();

}

@Override protected void onStop() {

  super.onStop();

  gifView.stopAnimation();

}

```

If you need to post-process the GIF frames, you can do that via ``GifImageView.setOnFrameAvailable()``.

You can see an example of that in the sample app included on the repository.

```java

gifImageView.setOnFrameAvailable(new GifImageView.OnFrameAvailable() {

  @Override public Bitmap onFrameAvailable(Bitmap bitmap) {

    return blurFilter.blur(bitmap);

  }

});

```

You can also reset an animation to play again from the beginning `gifImageView.resetAnimation();` or show a specific frame of the animation `gifImageView.gotoFrame(3)`;

### Demo

![](https://raw.githubusercontent.com/felipecsl/GifImageView/master/demo.gif)

Be sure to also check the [demo project](https://github.com/felipecsl/GifImageView/blob/master/app/src/main/java/com/felipecsl/gifimageview/app/MainActivity.java) for a sample of usage!

Snapshots of the development version are available in [Sonatype's `snapshots` repository](https://oss.sonatype.org/content/repositories/snapshots/).

### Contributing

* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet

* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it

* Fork the project

* Start a feature/bugfix branch

* Commit and push until you are happy with your contribution

* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.

### Copyright and license

Code and documentation copyright 2011- Felipe Lima.

Code released under the [MIT license](https://github.com/felipecsl/GifImageView/blob/master/LICENSE.txt).