Welcome to the home page of the Country Dance (Folk Dancing) animation Open Source project.

A search on the Internet for country dance animation programs will show that quite a few people have made good attempts. Most of the animation programs do some aspects of the animation very well and most programs approach the problem from different directions. This has left us with a selection of programs, all of which contribute to the art of country dance animation but none of which form the complete toolset needed by those who wish to view dance animation or who wish to do other activities such as compose dances or print crib sheets in their favorite format.

Another observation is that work on these projects tends to progress in an initial spurt during which great things are achieved, but then the author becomes busy on stuff like paid work or loses interest for whatever reason. The programs that stagnate with no more work being done.

This project is an attempt to solve both the above problems. Source code to everything on this project is freely available under the General Public License. The source code is maintained under CVS on SourceForge servers. This gives everyone the ability to access the code anonomously, and, if you want to join the project and contribute, the ability to checkin changes.

Current Project Contents

The core of the project is a Java applet that takes as input a dance description in XML format and animates it. The applet also has an interface into it that allows other applications such as a JavaScript to control the animation, providing a richer user interface. This applet can also be used to determine the position of each dancer and the direction in which they are facing at any point of time. This information can then be used to create diagrams.

There are various different types of users:

Some aims of this project are to collect together:

If you are interested in the format of the XML, see the XML schema page. If you want to use the classes that process the XML and provide the positions of the dancers then you should read the Javadoc for the animation objects. This contains the documentation of all public methods.

The primary tool available at this time is a Java applet that animates a dance. If you are interested in coding new features or patches to this code then you should read a description of the design and implementation of the Java animation applet. You should also read the internal JavaDoc. This contains the documentation of all public and private class members.

So that you can see an example of an animation, we have coded the following dances:

The animations as shown here are more of a test tool than a teaching aid, allowing us to test XML descriptions and to demonstrate that the XML defines precisely where people should be at any point of time, the direction in which they are facing, and when hands are taken. Rich user interfaces may be written in scripting languages such as JavaScript that allow editing, replays, etc, using the Java applet and the XML to determine the movements of people and hands.

Some of the other animation programs found on the Internet are:

> The CVS web interface.


SourceForge.net Logo