KenBurnsView
Android library that provides an extension to ImageView that creates an immersive experience by animating its drawable using the Ken Burns Effect.
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.7
Gradle integration
If you're using Gradle, you can declare this library as a dependency:
dependencies {
compile 'com.flaviofaria:kenburnsview:1.0.7'
}
Basic usage
For a working implementation, see the sample/
folder.
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
- 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) {
}
});
-
You can pause the animation by calling
kbv.pause()
and resume it by callingkbv.resume()
; -
You can change the duration and the interpolator of transitions:
RandomTransitionGenerator generator = new RandomTransitionGenerator(duration, interpolator);
kbv.setTransitionGenerator(generator);
- If you're willing to have even more control over transitions, you can implement your own
TransitionGenerator
.
Questions
You can ask any question on Stack Overflow using the android-kenburnsview tag.