Users Guide

V8.0

ENGLISH

[deutsch]

Legal Stuff

Jongl is freely distributable; nevertheless all rights remain with us. It is expressly allowed to include this program in the Internet, on CD ROMs and in mailboxes. If you publish Jongl on CD, we require a sample CD. It is not allowed to sell this program for a price higher than justified by the disk or CD.

We are not responsible for anything that Jongl might cause under odd circumstances.
(Up to now it has never made a mess anywhere...)

Requirements

Jongl runs on different platforms. By now there are (in order of creation):

AMIGA (only on request)
Linux
SunOS 5
Windows95®, Windows98®, WindowsNT 4.0® and Windows2000® (as screen saver, too)
IRIX (used by Silicon Graphics)
LinuxPPC

The Linux version needs Mesa 2.2 or or better (Mesa 2.5 has problems with shadows). It runs fine with kernel 2.0.32 and newer from SuSE 5.1 or RedHat. Currently we use libc6. We haven't tested other versions, please tell us if they work also.

The Windows versions need OpenGL. If your 3D graphics board has OpenGL support, you will get a hardware accelerated animation.

Windows 3.1 and DOS will *never* be supported (we only talk about operating systems...).

Installation

The Jongl distribution consists of the following files:

jongl The executable (might be called jongl.exe)

s22j The siteswap-to-jongl-converter executable (might be called s22j.exe). Jongl calls this automatically if there is no file with the name which the user entered.

jongl.prefs User customization (set "local = english")

list_of_objects See this for object numbers
list_of_OldQjugglers
list_of_Oldjugglers
list_of_VRMLQjugglers
list_of_VRMLjugglers Lists with all jugglers. Change this if you don't want to see some jugglers

b (dir) Benchmark files
doc (dir) This guide in several languages
l (dir) Language support
m (dir) Juggling patterns
o (dir) Juggling objects (old object format)
v (dir) Juggling objects (VRML object format)

FLOOR Simple script to change the floor

You won't need an Install script. Just unpack the archive into any directory. Be sure not to cut the file names to DOS-like 8.3-format and that you get the subdirectories unpacked, too.

UNIX like systems: Type tar xvzf jonglXX.tgz to unpack the archive. For the Linux version you might need the xforms package which is available at bragg.phys.uwm.edu/xforms.

If you want to start Jongl from everywhere:

set the environment variable JONGL to the path where Jongl sits. In bash under Linux you would write e.g. export JONGL=/home/werner/prg/jongl
include this to the PATH.

For Windows you will need several dlls. If you don't have them, you can download the OpenGL-ddls and the others.

Running

You can start Jongl with the following parameters. All of these parameters are optional; the sequence doesn't matter.

jongl [-<object number>] [-<object name>] [--<s22j parameter>] [+<prefs parameter>] [<pattern>]

Here some examples:

> jongl Brings up a file selector -> select a pattern to start
> jongl 5 Starts pattern 5 (really this is file m/5)
> jongl +v=0 Overwrites the parameter v=0 in jongl.prefs. Thus jongl will start with the old (but faster) objects. The file selector pops up.
> jongl -24 3_801 Starts pattern 3_801 (m/3_801) with object #24
> jongl -knife 6 Starts pattern 6 (m/6) with knifes (o/knife)
> jongl 66161 Starts Jongl with the siteswap pattern 66161. There is no file with the name "66161" therefore the converter s22j is called automatically.
> jongl --hcr 4,55,5 Starts the siteswap converter s22j with the parameters -hcr 4,55,5 and afterwards invokes Jongl.
> jongl random <n> Runs Jongl in random mode: a new pattern every n seconds.
> jongl benchmark1
> jongl benchmark2
> jongl benchmark3 starts one of 3 benchmarks to compute your computer's speed. Check out the complete benchmark list here.

The window called Jongl Remote Control is the place to control most of Jongl. There are three different modes in Jongl: "Move circular", "Move linear" and "Move sun". Depending on the current state Jongl reacts differently. Try left and right mouse buttons.

1 Left mouse button changes the viewpoint. JRC-Bild
2 State: Move circular.
3 Stop rotating.
4 set speed to -100%
5 set speed to -50%
6 reduce speed by 10%
7 set speed to 0%
8 increase speed by 10%
9 set speed to -50%
10 set speed to 100%
11 fps display (toggle with t)
12 select new juggling pattern
13 select new juggling object
14 State: Move linear.
15 State: Move sun.
16 Right mouse button changes the field of view.

1	Left mouse button changes the viewpoint.
2	State: Move circular.
3	Stop rotating.
4	set speed to -100%
5	set speed to -50%
6	reduce speed by 10%
7	set speed to 0%
8	increase speed by 10%
9	set speed to -50%
10	set speed to 100%
11	fps display (toggle with `t`)
12	select new juggling pattern
13	select new juggling object
14	State: Move linear.
15	State: Move sun.
16	Right mouse button changes the field of view.

When the pointer is not in the dark green control box (1), you have a menu on the right mouse button. Try Program-Help to get the keyboard layout. Nearly every key on the keyboard has an effect, some even in conjuction with Shift. Try out. If the keyboard control doesn't work, check the CAPS LOCK key.

Quit Jongl with Quit Jongl from the menu or with the ESC key.

More Information can be found in the complete specification. It covers
the changes between the different versions,
frequently asked questions,
how to make objects or patterns oneself,
the complete keyboard layout,
things you can set up in `jongl.prefs`
and much more.

Contact

Check for newest versions at www.jongl.de.

Programmers:
Werner Riebesel

Martin Hoffmann

Should you like to contribute something to our project, look at my homepage and tell me what you want to do.