Trident Java animation library: Wiki: ExtensionPoints

Mailing Lists
Downloads
» Downloads
Issue Tracking
» Issue Tracking
Source Code Repositories
» Source Code Repository
Wikis
» Wiki
WikiHomePages
» WikiHomePage

Trident Java animation library was started in February 2009, is owned by kirillg, and has 56 members.

» Join This Project

Last updated October 02, 2009 18:16, by kirillg

Core functionality

The core functionality of the Trident library can be extended to address custom needs of the specific applications. Out of the box Trident supports:

The timeline pulses being fired by a dedicated thread that wakes up every 40ms and updates all the timelines
Interpolating float and integer fields of any Java object that provides the matching public setter methods.
Swing and SWT UI toolkits, respecting the threading rules and providing interpolators for the custom graphic classes

Interested applications can use Trident plugins and Trident configuration APIs to:

Provide a custom pulse source to drive the timeline updates
Provide additional property interpolators for custom application classes
Support additional Java-based UI toolkits

Configuration APIs

The org.pushingpixels.trident.TridentConfig class contains the published configuration APIs. The TridentConfig.getInstance() API retrieves an instance of this class which can then be used for:

Setting a custom pulse source
Adding, removing and querying property interpolators
Adding, removing and querying UI toolkit handlers

Plugins

A Trident plugin is specified by the META-INF/trident-plugin.properties file that should be placed in the runtime classpath. Note that you can have multiple plugins in the same runtime environment - if each one is coming from a different classpath jar, for example.

The format of trident-plugin.properties is simple. Each line in this file should be of the following format:

Key=FullyQualifiedClassName

There supported keys are:

PropertyInterpolatorSource allows specifying custom property interpolators
UIToolkitHandler allows supporting custom UI toolkits

The core Trident library contains a plugin that supports Swing and SWT UI toolkits, as well as property interpolators for a few core classes. The plugin descriptor is META-INF/trident-plugin.properties in the trident.jar

UIToolkitHandler=org.pushingpixels.trident.swing.SwingToolkitHandler
PropertyInterpolatorSource=org.pushingpixels.trident.swing.AWTPropertyInterpolators

UIToolkitHandler=org.pushingpixels.trident.swt.SWTToolkitHandler
PropertyInterpolatorSource=org.pushingpixels.trident.swt.SWTPropertyInterpolators

PropertyInterpolatorSource=org.pushingpixels.trident.interpolator.CorePropertyInterpolators