Summary

This widget displays a stack of images that you can flick through like a rolodex or a card deck. It uses gwt's deferred binding for the image generation and lightweight animation to create a fast and smooth experience in all supported browsers. Check out the HelpMovieDemo and FlipBookDemo demos.

Usage

1. Download the latest version of this widget and place it within the classpath of your project.
2. Add the following line to your module xml (see an exampleModuleXml

  <inherits name='com.yesmail.gwt.rolodex.Rolodex'/>

3. Create a subinterface or subclass of RolodexCardBundle
4. Grab your stack of images (you'll get the best results from images that are roughly the same medium size) and place them in the same package space as your RolodexCardBundle.
5. Create a method for each card just like you do with a gwt ImageBundle except they must return a RolodexCard instead of an AbstractImagePrototype. Check out an exampleRolodexCardBundle (although you don't have to implement the getRolodexCards method, doing so allows you to define the order of your cards since the default is alphabetical).
6. Note that you will usually need to specify a floor color via an @FloorColor annotation in your RolodexCardBundle unless your background happens to be black. This will help the reflections look correct.
7. Within your module entry point, create your RolodexCardBundle and pass it in to a RolodexPanel instance. Check out an exampleModuleEntryPoint.
8. Note that you can add click listeners directly to the cards returned from your methods. The above example also shows how you could use an EventPreview to provide key mappings for the widget.

One more thing: As of version 1.1 if you have JAI (Java Advanced Imaging) installed, then this widget will look much better. JAI comes pre-installed on mac 10.4 and greater, but for windows and linux you can grab JAI from sun: https://jai.dev.java.net/binary-builds.html#Release_builds If you don't have JAI, then this widget will gracefully downgrade (I love that term) to using the default rendering technique.

Have fun!