DroidBallet /'drȯid'ba'lā/ noun. 1 Motion based interaction and UI navigation.

##About

DroidBallet is an effort to supplement the user experience on Android by incorporating motion based interaction and UI navigation.

This library is currently in a PRE-ALPHA stage with on-going tweaks to certain equations and experimentation with various widgets.

##Setup

1. For Maven Based Android Projects

Add the following dependency in your project's pom.xml.

<dependency>
   <groupId>com.lonepulse</groupId>
   <artifactId>droidballet</artifactId>
   <version>0.1.0</version>
   <type>apklib</type>
</dependency>

For information on building Android projects using Maven here's Chapter 14 of Maven: The Complete Reference.

2. For Standard Android Projects

Clone the repository and import it as an existing project in Eclipse.

$ git clone git://github.com/sahan/DroidBallet.git

Since the Eclipse metadata is maintained in the repository, the project should be immediately available as an Android library which you can reference in your own project. Refer the developer guide for information on referencing library projects.

##Usage

The current motion widgets arsenal consists of a single component named LinearMotionListView. Use this on a portrait activity using the steps outlined below.

1. Configure AndroidManifest.xml to use DroidBallet's application instance.

<application 
	android:name="com.lonepulse.droidballet.app.MotionApplication"

2. Declare the LinearMotionListView in your layout.

<com.lonepulse.droidballet.widget.LinearMotionListView
	android:id="@android:id/list"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Else you could instantiate LinearMotionListView within your activity and set it as the content view.

3) Override `onResume()` and `onPause()` to activate and deactivate the motion widgets in the smallest possible scope.

######Activate

@Override
protected void onResume() {
	
	super.onStart();
		
	HiggsField.INSTANCE.activate();
	motionListView.register();
}

######Deactivate

@Override
protected void onPause() {
	
	super.onPause();
		
	HiggsField.INSTANCE.deactivate();
	motionListView.unregister();
}

##License This library is licensed under Apache License, Version 2.0.