/KenBurnsView

Android ImageViews animated by Ken Burns Effect

Primary LanguageJavaApache License 2.0Apache-2.0

KenBurnsView

Android library that provides an extension to ImageView that creates an immersive experience by animating its drawable using the Ken Burns Effect.

Example Image

Overview

KenBurnsView provides the following advantages:

  • Control: you can change the duration and the interpolator of transitions and pause/resume them. You can also listen to events like onTransitionStart() and onTransitionEnd();
  • Highly extensible: you can define how the rectangles to be zoomed and panned will be generated;
  • Libs friendly: since KenBurnsView is a direct extension of ImageView, it seamlessly works out of the box with your favorite image loader library;
  • Easy to use: you can start using it right away. All you need to do is to drop the JAR file into your project and replace ImageView elements in your XML layout files by com.flaviofaria.kenburnsview.KenBurnsView ones.

Changelog

Latest version: 1.0

Basic usage

For a working implementation, see the sample/ folder. You can also download the Sample APK.

The simplest way to use KenBurnsView is by dropping the library JAR file into your project adding a view to an XML layout file:

<com.flaviofaria.kenburnsview.KenBurnsView
    android:id="@+id/image"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:src="@drawable/your_drawable" />

Advanced usage

  1. You can set a listener to your view:

     KenBurnsView kbv = (KenBurnsView) findViewById(R.id.image);
     kbv.setTransitionListener(new TransitionListener() {
         @Override
         public void onTransitionStart(Transition transition) {
    
         }
         @Override
         public void onTransitionEnd(Transition transition) {
    
         }
     });
    
  2. You can pause the animation by calling kbv.pause() and resume it by calling kbv.resume();

  3. You can change the duration and the interpolator of transitions:

     RandomTransitionGenerator generator = new RandomTransitionGenerator(duration, interpolator);
     kbv.setTransitionGenerator(generator);
    
  4. If you're willing to have even more control over transitions, you can implement your own TransitionGenerator.

License

Apache Version 2.0