JMPocket
Version 1.0.1
03.06.02

(C) Per Johan Persson 2002

Based on JuggleMaster 1.60
Copyright (C) 1995-1996 Ken Matsuoka


1. INTRODUCTION

JMPocket is a port of the juggling simulator JuggleMaster to
Pocket PC. It runs on Pocket PC 3.0 and Pocket PC 2002.

Windows CE Palm-size PC and H/PC are not supported at this time.


2. FEATURES

Here is a list of some of the features of JMPocket

* Full support for siteswaps, this includes vanilla siteswap as well
  as synchronous and multiplexing siteswap.
* Styles. For instance, a style defining how to juggle a pattern as
  a Mills' Mess is defined.
* Support for the full JuggleMaster pattern library.
* Enter any siteswap and have JMPocket juggle it. JMPocket can also
  verify siteswaps on the fly as you type them. Furthermore, JMPocket
  remembers the 10 most recently entered patterns.
* Globall feature: Turn the juggler on and off.
* Fully customizable color support. 
* Speed adjustment.
* Support for the regular JuggleMaster pattern library file format.
  Isaac Orr's pattern library is included (patt_e.jm).

And, here's the list of stuff that is missing from the current version.
Some of the items on this list may be added in a future version.

* View the siteswap on screen as it is being juggled.
* Faster screen drawing.

To see a list of stuff that has changed between different versions of
JMPocket, see the file changes.txt.

For an exhaustive list of things that may be added in future version as
well as bugs and quirks, see todo.txt.


3. INSTALLATION

Previous JMPocket versions should be uninstalled before running the
setup program.

Isaac Orr's pattern library is automatically installed (372 patterns).
The file patt_e.jm contains the pattern library, and can be replaced
with any JuggleMaster pattern library.


4. CONTROLS

The functionality of JMPocket is accessed through its menu:

File
  Enter Siteswap             Enter a valid siteswap and have JMPocket juggle it.
                             You can change the style, dwell ratio and height ratio
                             of the pattern.
  Select Pattern             Select a pattern from JMPocket's pattern library. This
                             will be grayed out if there isn't a pattern library installed.
  About JMPocket             Shows copyright and version information.
  Exit                       Exits JMPocket
Edit
  Paused                     Toggle pause.
  Globall Mode               Toggle globall mode.
  View Quick Browser         Toggle the quick pattern browser on/off.
  Speed Up                   Increase speed.
  Speed Down                 Decrease speed.
  Preferences                Go to the preferences screen.


Preferences are split into two pages:

General:

- Mirror Pattern                 This will mirror the entire juggler.
- Globall Mode                   Turn globall mode on/off.
- Beep on Throw                  Beep each time a throw is made.
- Show Quick Browser Toolbar     Turn the quick patter browser 
- Color Codes in Enter Siteswap  If this is turned on, there will be a color
                                 border around the siteswap text box in "Enter Siteswap"
                                 The border will be red when the site in the box is invalid,
                                 and will turn to green when the site is valid.
- Speed                          Adjust the animation speed, from 1 to 50.

Color:

JMPocket uses ten different colors to draw the juggling balls (for patterns with
more than 10 balls, the colors are reused for balls 11 and up). Each of these
colors can be changed induvidually. The color of the juggler can also be changed.
Pressing the "Reset" button will reset all ball colors back to red, and the juggler
back to gray.


5. REPORTING BUGS

If you find a bug, you should consider reporting it. However, before
reporting bugs, check that:

a) Do you have the latest version. If not, always try the latest
   version and see if the bug has been fixed.

b) Is the bug a known bug? If it is there is no use in reporting it.
   See the next section for known bugs.

To report the bug, send me a mail. Please try to be as specific as
possible.


6. KNOWN BUGS AND OTHER CAVEATS

For a list of bugs that are known, check the file todo.txt
An up-to-date list of all known bugs will always be found on
the web page as well.

Know that JMPocket is not 100 % stable (closer to 99.9 % stable),
and may crash once in a while. 


7. TERMS OF USE

Please read the End User License agreement for terms of use.

8. CONTACT

The official JMPocket site can be found at:
http://jugglemaster.net

The web page also contains JMPalm, which is JuggleMaster for Palm OS.

Fan mail, constructive criticism, suggestions for improvement,
and bug reports are always welcome, and should be sent by email.

email: per@juggler.net

Enjoy!
