******************************************************************************* SiteSwap v1.2 beta 1 -------------------- What is this software? SiteSwap, not to be confused with the juggling notation 'siteswap', is a freeware juggling siteswap animation program for the palm pilot. It is based off of Glenn Hutchings source code for Juggle v1.0 and is licensed under the gnu general purpose license (see license.txt for details). Juggle v1.0 was written for unix and was ported to the palmOS by Stuart Macmillan as SiteSwap (versions 0.08 to 0.1 alpha). I have since updated Stuart's source code, so any questions, comments, or bug reports for this version of the program should go to me (Nathan Peterson) at nathan@juggler.net. As of this version, the program now comes with a sophisticated siteswap generator. The siteswap generator used here is a direct port of Jack Boyce's J2 siteswap generator which can be found at http://www.juggling.org/programs/src/ It is the same generator used in the java applet "juggleanim" which can be found at http://www.juggling.org/programs/java/JuggleAnim/ja.html You can contact Glenn Hutchings at zondo@hunting2.demon.co.uk or Stuart Macmillan at stuart.macmillan@macsch.com or Jack Boyce at jboyce@physics.berkeley.edu Where can I get the latest version? The latest version can be found at http://www.siteswap.org/palm/ What improvements have been made over the last version? The main new feature in this version is the added siteswap generator. You can generate multiplex, synchronous, asynchronous, and passing patterns. These can then be copied and pasted into the siteswap input dialog to view the patterns. Of course, since the animator only supports asynchronous non-muliplex solo patterns (i.e. vanilla siteswaps), you won't actually be able to animate those siteswaps with this program. You can however, paste them into another siteswap animator that does (e.g. JuggleMaster Palm). Other improvements include better random siteswap generation, and # of balls added at bottom of screen. Everything should work properly. If you find anything that doesn't work, send me an email at nathan@juggler.net. It definitely should not crash, if it does, I would like to know about it. Are there any known bugs in this release? Well, sort of. The siteswap text field at the bottom of the screen will only display 10 digits even though you are allowed to enter in siteswaps as long as 20 digits. Other than that, I don't know of any bugs as of the time that this text file was written, however, I have not fully tested this program on all palmOS devices, so there could be some problems that I don't know about. That's why this is a beta version and I need feedback from you guys if you find any bugs. What features does it have now? - Generate random siteswap patterns, generate lists of siteswaps based on specified criterion, select out of a list, or make up your own. - Uses base 36 notation for siteswap entry. That means A-Z are valid digits (A=10, Z=35). - Does not support multiplex or synchronous notation. Animator only supports vanilla siteswaps. - Has adjustable speed. - Can change the type of objects that are juggled. - Displays the # of balls being juggled. What extra features are planned for v2.0? Well, I'm not sure that there will be a version 2.0, but I have done some work on the following and perhaps I will finish the code someday: - Support for multiplex and synchronous siteswap notations - Use more realistic animation (i.e. scooping, use real parabolic paths, scale heights accurately, and scale balls with height) I have a suggestion for feature I want implemented, should I send you an email? Absolutely! I can't guarantee that I will implement it, but I appreciate all suggestions. Can I have a peek at the source code? Yes! This program is open source (see license.txt). You can download the latest source code at http://www.siteswap.org/palm/