Guide de l'utilisateur

V7.0

[english]

[deutsch]

FRANCAIS

Droits

Jongl est librement redistribuable, cependant nous en retenons tous les droits. Il est expressement autorisé d'inclure ce programme sur un site Web, sur un CD-Rom ou de l'envoyer par courrier électronique. Si vous publiez Jongl sur un CD, nous désirons en recevoir un exemplaire. Il est interdit de vendre ce programme pour un prix plus élévé que celui justifié par la disquette ou le CD.

Nous ne sommes aucunement responsables de choses plus ou moins bizarres que Jongl pourrait provoquer.
(Jusqu'a présent, il n'a jamais provoqué de désordre ou que ce soit...)

Pre requis

Jongl tourne sur différents systèmes. A ce jour, ce sont (dans l'ordre de création):

AMIGA
Linux
SunOS 5
Windows95®, Windows98® et WindowsNT®(économiseur d'écran prévu pour bientôt)
IRIX (Silicon Graphics)

La version AMIGA a besoin d'au moins un 68020; un 68881 ou un 68882 aide beaucoup. Vous n'avez pas besoin de beaucoup de RAM, 1-2 megas suffisent, mais plus le microprocesseur est rapide, mieux c'est. Les cartes graphiques ne sont pas supportées.

La version Linux nécessite Mesa 2.2 ou mieux (Mesa 2.5 a des problèmes avec les ombres). Ca focntionne bien avec le noyau 2.0.32 de la SuSE 5.1 ou la RedHat. Nous utilisons actuellement la libc5. Nous n'avons pas testé d'autres versions, dites nous si elles fonctionnent aussi.

La version Windows a besoin d'OpenGL. Si votre carte graphique a un support OpenGL pour la 3D, vous bénéficirez d'une accélération matérielle de l'animation.

Windows 3.1 et DOS ne seront *JAMAIS* supportés.

Installation

La distribution Jongl comprend les fichiers suivants:

jongl             l'éxecutable (peut ètre appelé jongl.exe)

jongl.prefs       les péférences utilisateur (choisissez "local = francais")

list_of_objects   voyez ceci pour le numéro des objets.
list_of_people    changez ceci si vous ne voulez pas voir de jongleurs
list_of_sounds    nécessaire seulement sur AMIGA

b (dir)           fichiers de bancs d'essai
doc (dir)         ce guide en plusieurs langues
l (dir)           langues
m (dir)           figures
o (dir)           objets

FLOOR             script simple pour changer le sol

Il y a un script Install pour l'Amiga. Il n'y en a pas besoin pour les autres versions, il suffit de décompacter l'archive.

Systèmes "UNIX-like": Tapez tar xvzf jonglXX.tgz pour décompresser l'archive. Pour la version Linux, vous aurez peut-être besoin du paquetage xforms qui est disponible à bragg.phys.uwm.edu/xforms.

Si vous voulez démarrer Jongl de n'importe où :

positionnez la variable d'environnement JONGL au chemin où Jongl réside. En bash sous Linux, vous écririez par exemple export JONGL=/home/werner/prg/jongl .
incluez ceci au PATH.

Pour Windows95, vous avez besoins des bibliothèques OpenGL appelées opengl32.dll, glu32.dll et glut32.dll qui ne sont pas incluses dans la distribution de Jongl, mais qui sont disponibles sur le site Open GL.

Lancement

Vous pouvez démarrer Jongl avec les commandes suivantes :

> jongl appelle un sélecteur de fichier -> choississez une figure pour commencer
> jongl 5 démarre la figure 5 (en réalité le fichier m/5)
> jongl -24 3_801 démarre la figure 3_801 (m/3_801) avec l'objet #24
> jongl -knife 6 démarre la figure (m/6) avec des couteaux (o/knife)
> jongl [-...] 66161 démarre la figure de site swap 66161
[-...] signifie un choix d'objet (optionnel)
> jongl [-...] [--h12] 4,55,5 démarre le convertisseur de siteswap s22j avec les paramêtres -h12 4,55,5 et invoque Jongl par la suite.
> jongl benchmark1
> jongl benchmark2
> jongl benchmark3 Lancez un des trois bancs d'essai pour calculer la vitesse de votre machine. Vous pouvez jeter un oeil sur la liste complète des tests ici.

Sur Amiga, vous pouvez changer le point de vue avec la souris. Vous pouvez changer la distance avec les boutons. Appuyez sur HELP pour avoir une carte du clavier, et sur M pour obtenir les menus.

Sur les autres versions, il y a une fenêtre appelee Jongl Remote Control. Elle contient pratiquement tous les controles de Jongl.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16 Le bouton gauche change le point de vue.
Etat: Mouvement circulaire.
Arrêter la rotation.
Changer la vitesse à -100%
Changer la vitesse à -50%
Réduire la vitesse de 10%
Mettre la vitesse à 0%
Augmenter la vitesse de 10%
Changer la vitesse à 50%
Changer la vitesse à 100%
Affichage des frames par seconde
Choisir une nouvelle figure
Choisir un nouvel objet
Etat: Mouvement linéaire.
Etat: Mouvement solaire.
Le bouton droit change le champ de vision. JRC

Les trois premiers (juste à droite de la boîte vert foncée appelée boite de controle) sont des changeurs d'état. Dans ces trois états Jongl réagit différement. Essayez les boutons de la souris droit & gauche.

Quand le pointeur n'est pas dans la boîte de controle vert foncée, le bouton droit appelle un menu. Essayez Program-Help pour avoir une carte du clavier. Pratiquement chaque touche sur le clavier a une fonction, certaines en combinaison avec Shift. Essayez les. Si une commande au clavier ne fonctionne pas, vérifiez la touche CapsLock

Vous pouvez sortir de Jongl avec Sortir dans le menu ou en appuyant sur la touche ESC.

Plus d'informations se trouvent dans la spécification complè, qui est disponible uniquement en anglais.

A Faire

Pour le moment, la version AMIGA a le plus de possibilités. Elle est la seule a pouvoir exporter des images et des animations. Les modes 3D et Infrarouge sont seulement en pre-alpha sur les non-AMIGAs.

Affichage AMIGA avec ombrage à plat et ombres. L'ombrage de Gouraud fonctionne seulement avec OpenGL (ou Mesa).

Plus de vitesse. Les routines AMIGA rendu sont écrites entiérement en assembleur (par Martin). Avec les autres versions, nous utilisons OpenGL qui est facile a programmer, mais plutot leeeeeeeeeeeeent en rendu sans accélération matérielle. Avec une fenêtre de 400 par 300, mon K6-200 produit jusqu'à 25 frames par seconde dans les modes standards.

Contact

Pour la version la plus récente, allez voir www.jongl.de.

Programmeurs :
Werner Riebesel

Martin Hoffmann

Traducteur pour le français :
Stéphane Picq

Traducteur pour le néerlandais :
Steven de Rooij

Si vous voulez contribuer au projet, jetez un oeil à la page "maison" et contactez Werner pour dire ce que vous voulez faire.