(ABANDONED) Access the Honeycomb+ Animation API via Titanium
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
anvil
assets
documentation
doxygen
example
lib
src/com/billdawson/timodules/animation
.classpath
.gitignore
.project
CHANGELOG.txt
LICENSE.txt
README.md
build.properties.sample
build.xml
manifest
timodule.xml
todo.md

README.md

(ABANDONED) Android Animation for Titanium

Project Abandoned

PLEASE NOTE: I no longer work with Titanium and have abandoned this module. I recommend you fork this project or find another fork that is maintained.

Quick links:

Introduction

This Titanium Android module makes the Honeycomb (Android 3.0) animation API available to Titanium Android apps. It uses Jake Wharton's excellent NineOldAndroids library to make the animations available on pre-Honeycomb devices as well.

It does this by wrapping and exposing two types of animators that are native to the Honeycomb Animation API: ObjectAnimator (native) and ViewPropertyAnimator (native).

Additionally, it provides access to the AnimatorSet (native), which can run multiple ObjectAnimator instances either simultaneously or back-to-back.

The real star of the bunch is the ViewPropertyAnimator, which is the one you should be trying to use first.

Documentation

Currently the documentation is in javadoc strings within the code and generated using Doxygen. The result is not particularly "Javascripty", but I hate separating documentation from code, so that's the way it is at least for now.

Usage

Please see the documentation for instructions on how to use the module in your Titanium app. You can also find code samples under the example/ folder.

Meanwhile here is a very quick example of using the view property animator made available via this module:

var animationModule = require("com.billdawson.timodules.animation");

//... setup window / views ...

animationModule.viewPropertyAnimator.animate(myView).xBy(50).yBy(50);

Build

The module has so far been built and tested only with Titanium 3.0.2. You build it the same as you would build any other Titanium module for Android. The build.xml Ant script is provided, but be sure your machine is setup to build Titanium Android modules. You can ensure this by creating and building your own test module using Titanium Studio. In a nutshell, you'll need the Android SDK, the Android NDK and Python.

Full instructions on how to create and build Titanium modules for Android will not be provided here. Nor will instructions on how to put modules in to your Titanium app projects be provided here. Look elsewhere!

If you don't wish to build but just want the packaged module, you can grab the finished product -- the packaged ZIP file -- also at Github.

Developed By

License

The original code herein is...

Copyright 2013 William Dawson.

The NineOldAndroids library, upon which this module is built, is...

Copyright 2012 Jake Wharton.

Both projects:

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.