android-gif-drawable


Source link: https://github.com/koral--/android-gif-drawable

android-gif-drawable

Views and Drawable for animated GIFs in Android.

Overview

Bundled GIFLib via JNI is used to render frames. This way should be more efficient than WebView or Movie classes.

Javadoc

Setup

Gradle (Android Studio)

Insert the following dependency to build.gradle file of your project.

dependencies {

  compile 'pl.droidsonroids.gif:android-gif-drawable:1.2.8' 
}

Note that Maven central repository should be defined eg. in top-level build.gradle like this:

buildscript {

  repositories {

mavenCentral()
  
}
 
}
 allprojects {

  repositories {

mavenCentral()
  
}
 
}

Gradle, snapshot repository

Current development builds (build from dev branch) are published to OSS snapshot repository. To use them, specify repository URL in repositories block:

repositories {

  mavenCentral()
  maven {
 url "https://oss.sonatype.org/content/repositories/snapshots" 
}
 
}
 dependencies {

  compile 'pl.droidsonroids.gif:android-gif-drawable:1.2.+' 
}

Maven dependency

<dependency>
  <groupId>pl.droidsonroids.gif</groupId>
  <artifactId>android-gif-drawable</artifactId>
  <version>insert latest version here</version>
  <type>aar</type> </dependency>

Eclipse

See Sample eclipse project with setup instructions.

Download

Latest release downloads

Requirements

  • Android 4.0+ (API level 14+)
  • for GifTextureView hardware-accelerated rendering
  • for GifTexImage2D OpenGL ES 2.0+

Building from source

Usage

Sample project

See sample directory. Sample project is under construction. Not all features are covered yet.

From XML

The simplest way is to use GifImageView (or GifImageButton) like a normal ImageView:

<pl.droidsonroids.gif.GifImageView
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:src="@drawable/src_anim"
  android:background="@drawable/bg_anim"
  />

If drawables declared by android:src and/or android:background are GIF files then they will be automatically recognized as GifDrawables and animated. If given drawable is not a GIF then mentioned Views work like plain ImageView and ImageButton.

GifTextView allows you to use GIFs as compound drawables and background.

<pl.droidsonroids.gif.GifTextView
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:drawableTop="@drawable/left_anim"
  android:drawableStart="@drawable/left_anim"
  android:background="@drawable/bg_anim"
  />

From Java code

GifImageView, GifImageButton and GifTextView have also hooks for setters implemented. So animated GIFs can be set by calling setImageResource(int resId) and setBackgroundResource(int resId)

GifDrawable can be constructed directly from various sources:

//asset file GifDrawable gifFromAssets = new GifDrawable( getAssets(), "anim.gif" );

 //resource (drawable or raw) GifDrawable gifFromResource = new GifDrawable( getResources(), R.drawable.anim );

 //Uri ContentResolver contentResolver = ... //can be null for file:// Uris GifDrawable gifFromUri = new GifDrawable( contentResolver, gifUri );
  //byte array byte[] rawGifBytes = ... GifDrawable gifFromBytes = new GifDrawable( rawGifBytes );

 //FileDescriptor FileDescriptor fd = new RandomAccessFile( "/path/anim.gif", "r" ).getFD();
 GifDrawable gifFromFd = new GifDrawable( fd );

 //file path GifDrawable gifFromPath = new GifDrawable( "/path/anim.gif" );

 //file File gifFile = new File(getFilesDir(),"anim.gif");
 GifDrawable gifFromFile = new GifDrawable(gifFile);

 //AssetFileDescriptor AssetFileDescriptor afd = getAssets().openFd( "anim.gif" );
 GifDrawable gifFromAfd = new GifDrawable( afd );

//InputStream (it must support marking) InputStream sourceIs = ... BufferedInputStream bis = new BufferedInputStream( sourceIs, GIF_LENGTH );
 GifDrawable gifFromStream = new GifDrawable( bis );

 //direct ByteBuffer ByteBuffer rawGifBytes = ... GifDrawable gifFromBytes = new GifDrawable( rawGifBytes );
 

InputStreams are closed automatically in finalizer if GifDrawable is no longer needed so you don't need to explicitly close them. Calling recycle() will also close underlying input source.

Note that all input sources need to have ability to rewind to the beginning. It is required to correctly play animated GIFs (where animation is repeatable) since subsequent frames are decoded on demand from source.

Animation control

GifDrawable implements an Animatable and MediaPlayerControl so you can use its methods and more:

  • stop() - stops the animation, can be called from any thread
  • start() - starts the animation, can be called from any thread
  • isRunning() - returns whether animation is currently running or not
  • reset() - rewinds the animation, does not restart stopped one
  • setSpeed(float factor) - sets new animation speed factor, eg. passing 2.0f will double the animation speed
  • seekTo(int position) - seeks animation (within current loop) to given position (in milliseconds)
  • getDuration() - returns duration of one loop of the animation
  • getCurrentPosition() - returns elapsed time from the beginning of a current loop of animation
Using MediaPlayerControl

Standard controls for a MediaPlayer (like in VideoView) can be used to control GIF animation and show its current progress.

Just set GifDrawable as MediaPlayer on your MediaController like this:

@Override protected void onCreate(Bundle savedInstanceState) {

  super.onCreate(savedInstanceState);

  GifImageButton gib = new GifImageButton(this);

  setContentView(gib);

  gib.setImageResource(R.drawable.sample);

  final MediaController mc = new MediaController(this);

  mc.setMediaPlayer((GifDrawable) gib.getDrawable());

  mc.setAnchorView(gib);

  gib.setOnClickListener(new OnClickListener() {

@Override

public void onClick(View v) {

 mc.show();

}

 
}
);
 
}

Retrieving GIF metadata

  • getLoopCount() - returns a loop count as defined in NETSCAPE 2.0 extension
  • getNumberOfFrames() - returns number of frames (at least 1)
  • getComment() - returns comment text ( null if GIF has no comment)
  • getFrameByteCount() - returns minimum number of bytes that can be used to store pixels of the single frame
  • getAllocationByteCount() - returns size (in bytes) of the allocated memory used to store pixels of given GifDrawable
  • getInputSourceByteCount() - returns length (in bytes) of the backing input data
  • toString() - returns human readable information about image size and number of frames (intended for debugging purpose)

Associating single GifDrawable instance with multiple Views

Normally single GifDrawable instance associated with multiple Views will animate only on the last one. To solve that create MultiCallback instance, add Views to it and set callback for given drawable, eg.:

MultiCallback multiCallback = new MultiCallback();
  imageView.setImageDrawable(gifDrawable);
 multiCallback.addView(imageView);
  anotherImageView.setImageDrawable(gifDrawable);
 multiCallback.addView(anotherImageView);
  gifDrawable.setCallback(multiCallback);

Advanced

  • recycle() - provided to speed up freeing memory (like in android.graphics.Bitmap)
  • isRecycled() - checks whether drawable is recycled
  • getError() - returns last error details

Upgrading from 1.2.8

Minimum SDK version changed

Minimum API level is now 14 (Android 4.0).

Upgrading from 1.2.3

Meaningful only if consumer proguard rules (bundled with library) are not used (they are used by default by Gradle).

  • Proguard rule has changed to -keep public class pl.droidsonroids.gif.GifIOException{ <init>(int, java.lang.String); }

Upgrading from 1.1.17

1.1.17 is the last version supporting API level 8 (Froyo). Starting from 1.2.0 minimum API level is 9 (Gingerbread).

Upgrading from 1.1.13

Handling of several edge cases has been changed:

  • GifDrawable#getNumberOfFrames() now returns 0 when GifDrawable is recycled
  • Information included in result of GifDrawable#toString() when GifDrawable is recycled now contains zeroes only

Upgrading from 1.1.10

It is recommended (but not required) to call LibraryLoader.initialize() before using GifDrawable. Context is needed in some cases when native libraries cannot be extracted normally. See ReLinker for more details. If LibraryLoader.initialize() was not called and normal library loading fails, Context will be tried to be retrieved in fall back way which may not always work.

Upgrading from 1.1.9

int parameter loopNumber has been added to AnimationListener#onAnimationCompleted().

Upgrading from 1.1.8

Proguard configuration not needed

Proguard configuration is now bundled with the library, you don't need to specify it yourself.

Upgrading from 1.1.3

src XML attribute in GifTextureView has been renamed to gifSource to avoid possible conflicts with other libraries.

Upgrading from 1.0.x

Proguard configuration update

Proguard configuration has changed to:

-keep public class pl.droidsonroids.gif.GifIOException{
<init>(int);

}
 -keep class pl.droidsonroids.gif.GifInfoHandle{
<init>(long,int,int,int);

}
 

Drawable recycling behavior change

GifDrawable now uses android.graphics.Bitmap as frame buffer. Trying to access pixels (including drawing) of recycled GifDrawable will cause IllegalStateException like in Bitmap.

Minimum SDK version changed

Minimum API level is now 8 (Android 2.2).

Rendering moved to background thread

Rendering is performed in background thread running independently from main thread so animation is running even if drawable is not drawn. However rendering is not running if drawable is not visible, see [#setVisible()]( http://developer.android.com/reference/android/graphics/drawable/Drawable.html#setVisible(boolean, boolean)). That method can be used to control drawable visibility in cases when it is not already handled by Android framework.

References

This library uses code from GIFLib 5.1.3 and SKIA.

Projects using android-gif-drawable

ImageFactory

NativeScript Plugin by Brad Martin available on NPM

Sketch Powerful and comprehensive image loader on Android, with support for GIF, gesture zooming, block display super large image.

Want to include your project here? Fill an issue

License

MIT License
See LICENSE file.

Resources

Neat 2D and 3D load indicators/spinners to use in your app. The library converts pre-made spritesheets to an AnimationDrawable to returns a Loader object than extends from ImageView. A very simple idea that can liven up your app.

Android Developer Icons is a custom icon set, included are:

  • 250 hand-crafted, pixel-perfect icons in 5 sizes and 14 colors
  • an icon font, made from the set
  • all sources: .svg, .ai, .eps, .eot, .ttf, .woff

Library containing common animations needed for transforming ViewPager scrolling on Android v13+. This library is a rewrite of the JazzyViewPager library and owes credit of the animation concepts directly to its source. The purpose of this rewrite is to provide an easier to use and extend implementation of ViewPager animations.

MatchView is a library which includes MatchTextView and MatchButton.

Renderers is an Android library created to avoid all the Adapter/ListView boilerplate needed to create a new adapter and all the spaghetti code that developers used to create following the ViewHolder classic implementation.

This Android library offers you two main classes to extend and create your own rendering algorithms out of your adapter implementation.

Renderers is an easy way to work with android ListView and Adapter classes. With this library you only have to create your renderers and declare the mapping between the object to render and the renderer.

Futuroid is an Android library that allows running asynchronous tasks and attaching callbacks thanks to a convenient syntax. It offers an alternative to the Android AsyncTask class.

Features:

  • Future-based API (similar to Guava's ListenableFutures, Scala/Akka Futures, Javascript promises...)
  • Allows registering callbacks to be run on the Android UI/main thread
  • Provides a default ExecutorService (fixed thread pool with 5 threads) that can be replaced by a custom one
  • Each task can be run on the default ExecutorService or on a custom one
  • Allows task chaining (monad-style)

Topics


2D Engines   3D Engines   9-Patch   Action Bars   Activities   ADB   Advertisements   Analytics   Animations   ANR   AOP   API   APK   APT   Architecture   Audio   Autocomplete   Background Processing   Backward Compatibility   Badges   Bar Codes   Benchmarking   Bitmaps   Bluetooth   Blur Effects   Bread Crumbs   BRMS   Browser Extensions   Build Systems   Bundles   Buttons   Caching   Camera   Canvas   Cards   Carousels   Changelog   Checkboxes   Cloud Storages   Color Analysis   Color Pickers   Colors   Comet/Push   Compass Sensors   Conferences   Content Providers   Continuous Integration   Crash Reports   Credit Cards   Credits   CSV   Curl/Flip   Data Binding   Data Generators   Data Structures   Database   Database Browsers   Date &   Debugging   Decompilers   Deep Links   Dependency Injections   Design   Design Patterns   Dex   Dialogs   Distributed Computing   Distribution Platforms   Download Managers   Drawables   Emoji   Emulators   EPUB   Equalizers &   Event Buses   Exception Handling   Face Recognition   Feedback &   File System   File/Directory   Fingerprint   Floating Action   Fonts   Forms   Fragments   FRP   FSM   Functional Programming   Gamepads   Games   Geocaching   Gestures   GIF   Glow Pad   Gradle Plugins   Graphics   Grid Views   Highlighting   HTML   HTTP Mocking   Icons   IDE   IDE Plugins   Image Croppers   Image Loaders   Image Pickers   Image Processing   Image Views   Instrumentation   Intents   Job Schedulers   JSON   Keyboard   Kotlin   Layouts   Library Demos   List View   List Views   Localization   Location   Lock Patterns   Logcat   Logging   Mails   Maps   Markdown   Mathematics   Maven Plugins   MBaaS   Media   Menus   Messaging   MIME   Mobile Web   Native Image   Navigation   NDK   Networking   NFC   NoSQL   Number Pickers   OAuth   Object Mocking   OCR Engines   OpenGL   ORM   Other Pickers   Parallax List   Parcelables   Particle Systems   Password Inputs   PDF   Permissions   Physics Engines   Platforms   Plugin Frameworks   Preferences   Progress Indicators   ProGuard   Properties   Protocol Buffer   Pull To   Purchases   Push/Pull   QR Codes   Quick Return   Radio Buttons   Range Bars   Ratings   Recycler Views   Resources   REST   Ripple Effects   RSS   Screenshots   Scripting   Scroll Views   SDK   Search Inputs   Security   Sensors   Services   Showcase Views   Signatures   Sliding Panels   Snackbars   SOAP   Social Networks   Spannable   Spinners   Splash Screens   SSH   Static Analysis   Status Bars   Styling   SVG   System   Tags   Task Managers   TDD &   Template Engines   Testing   Testing Tools   Text Formatting   Text Views   Text Watchers   Text-to   Toasts   Toolkits For   Tools   Tooltips   Trainings   TV   Twitter   Updaters   USB   User Stories   Utils   Validation   Video   View Adapters   View Pagers   Views   Watch Face   Wearable Data   Wearables   Weather   Web Tools   Web Views   WebRTC   WebSockets   Wheel Widgets   Wi-Fi   Widgets   Windows   Wizards   XML   XMPP   YAML   ZIP Codes