Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/flavioarfaria/KenBurnsView
Android ImageViews animated by Ken Burns Effect
https://github.com/flavioarfaria/KenBurnsView
android android-library imageview kenburnsview
Last synced: 14 days ago
JSON representation
Android ImageViews animated by Ken Burns Effect
- Host: GitHub
- URL: https://github.com/flavioarfaria/KenBurnsView
- Owner: flavioarfaria
- License: apache-2.0
- Created: 2014-03-19T03:10:02.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-08-26T21:23:54.000Z (about 2 years ago)
- Last Synced: 2024-08-10T11:27:27.931Z (3 months ago)
- Topics: android, android-library, imageview, kenburnsview
- Language: Java
- Homepage:
- Size: 12.9 MB
- Stars: 2,733
- Watchers: 79
- Forks: 437
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- -awesome-android-ui - KenBurnsView - 2.0) | <img src="/art/KenBurnsView.gif" width="49%"> (Index `(light-weight pages)`)
- awesome-android-ui - KenBurnsView - 2.0) | <img src="/art/KenBurnsView.gif" width="49%"> (Index `(light-weight pages)`)
- awesome-github-android-ui - KenBurnsView - 身临其境的动画拖拽 (图片)
- Android-Awesome-Resources - KenBurnsView
- awesome-android-ui - KenBurnsView - 2.0) | <img src="/art/KenBurnsView.gif" width="49%"> (Index)
README
KenBurnsView
============
Android library that provides an extension to *ImageView* that creates an immersive
experience by animating its drawable using the [Ken Burns Effect][KenBurnsEffect].
![Example Image][SampleImage]
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][Changelog]
---------
**Latest version: 1.0.7**
* [Download JAR from Maven Central][Maven]
Gradle integration
------------------
If you're using Gradle, you can declare this library as a dependency:
```groovy
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:
```xml
```
Advanced usage
--------------
1. You can set a listener to your view:
```java
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:
```java
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`.
Questions
---------
You can ask any question on Stack Overflow using the [android-kenburnsview][StackOverflowTag] tag.
License
-------
[Apache Version 2.0][License]
[KenBurnsEffect]: http://en.wikipedia.org/wiki/Ken_Burns_effect
[SampleImage]: anim.gif
[Changelog]: https://github.com/flavioarfaria/KenBurnsView/wiki/Changelog
[Maven]: http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.flaviofaria%22%20AND%20a%3A%22kenburnsview%22
[StackOverflowTag]: http://stackoverflow.com/questions/tagged/android-kenburnsview
[License]: http://www.apache.org/licenses/LICENSE-2.0.html