TD 0 - Installation et configuration de Jcg

Cette page montre comment installer et tester la bibliothèque Jcg (libraire d'algorithmes géométriques en java, developpée à l'X pour INF562), qui implémente en Java un certain nombre d'algorithmes et structures de données utilisés en géométrie algorithmique.

Documentation pour Jcg

La documentation de la bibliothèque Jcg est consultable ici

Librairies à télécharger

Programmes et librairies à telecharger:

librairie Jcg.jar, sources Java (Jcg_src.zip)
classe TC.jar (pour gérer les entrées/sorties en java, developpée à l'X pour INF311)

java3d (API java pour la création d'applications 3D): si on veut visualiser des maillages 3D

les directives pour installer java3D sont disponibles ici.
il existe aussi un plugin Java3D pour eclipse.

on se servira aussi de la librairie Jama (manipulation de matrices en Java) (voici le .jar) (voici le Jama-1.0.2.jar, en local)

Autres programmes utiles pour la visualisation 3D (facultatif):

Geomview (pour Linux): programme pour visualiser des maillages 3D.

Geomview est disponible aussi sous Windows (voici comment procéder): il faut alors d'abord installer Cygwin.

Installation de Jcg sous Eclipse (recommandé)

1) Créer un workspace sous Eclipe, pour INF562
2) Créer un nouveau Java Project, pour le TD1
3) Créer un nouveau (General) Project, appelé LIB (contenant les librairies dont on se servira)

4) Copier les fichiers suivants, dans votre repertoire /INF/LIB Jcg.jar TC.jar Jama-1.0.2.jar jd3core.jar (voici le lien vers la copie en local) j3dutils.jar (voici le lien vers la copie en local) vecmath.jar (voici le lien vers la copie en local) 5) mettre à jour (sous Eclipse) le contenu du repertoire LIB, avec F5 (refresh)

6) ajouter les .jar ci dessus au Java Build Path du projet TD1 (touche droite de la souris: properties)	Faire Add Jars... et selectionner chaque fichier un à un

Conseils pour l'installation sans Eclipse (non recommandé)

a)Copier et decomprimez le fichier Jcg.zip quelque part sur votre compte, mettons dans le répertoire où vous désirez mettre vos fichiers .java

b) Pour compiler un fichier .java (par exemple TestPolyhedron.java), taper javac -cp :Jcg.jar TestPolyhedron.java

c) Pour exécuter un programme (par exemple le main de la classe TestPolyhedron), taper java -cp :Jcg.jar TestPolyhedron

d) Les fichiers .off (maillages 2D et 3D) doivent se trouver dans le même repertoire que les fichiers de test compilés (TestPolyhedron.class et TestDelaunay.class).

Si vous voulez éviter d'avoir à ajouter l'argument -cp :Jcg.jar à chaque fois, il faut indiquer à Java où aller chercher la bibliothèque Jcg en utilisant la commande set classpath sous windows ou la commande export sous linux.

Par exemple sous Windows, si les fichiers .class de la librairie Jcg sont dans le repertoire c:\Java\Jcg, sous la forme

c:\Java\Jcg\geometry\Point_2.class
c:\Java\Jcg\geometry\Point_3.class
c:\Java\Jcg\geometry\Point_.class
...
c:\Java\Jcg\polyhedron\Vertex.class
c:\Java\Jcg\polyhedron\Face.class
c:\Java\Jcg\polyhedron\Halfedge.class
c:\Java\Jcg\polyhedron\Polyhedron_3.class
...

alors il faut mettre à jour la variable classpath avec la commande: SET CLASSPATH=c:\Java;

Pour visualiser en 3D les maillages il
faut installer d'abord la librairie java3D, voici des infos:
http://download.java.net/media/java3d/builds/release/1.5.1/README-download.html

Comment tester le tout

Une fois que tout est bien en place, le test est très facile à effectuer:

javac -cp :Jcg.jar TestPolyhedron.java
java -cp :Jcg.jar TestPolyhedron 2

À l'exécution vous devriez voir s'ouvrir une fenêtre montrant une triangulation de points dans le plan. Notez que la classe TestPolyhedron contient deux méthodes: l'une pour tester l'ouverture et visualisation d'une triangulation planaire, et l'autre pour visualier un maillage 3D. Le choix de la méthode dépend du paramètre fourni en entrée lors de l'exécution du programme : ci-dessus, l'argument 2 indique que l'on veut afficher la triangulation 2D. L'argument 3 indiquerait que l'on veut afficher le maillage 3D (attention, ceci requiert d'installer la bibliothèque java3d, comme expliqué plus haut).