#Copyright (C) 1998 Tuomas J. Lukka, 2001, 2002 John Stewart, CRC Canada.
#DISTRIBUTED WITH NO WARRANTY, EXPRESS OR IMPLIED.
#See the GNU Library General Public License (file COPYING in the distribution)
#for conditions of use and redistribution, EXCEPT on the files
#which belong under the mozilla public license.
#Translation to FRENCH of this document by R.VIU-BERGES apostledemencia at aol dot com under GNU LGPL.

La fin de ce document contient mes expériences et remarques quant à l'installation. il sera souvent remis à jour.

FreeWRL Le Guide en Français

Installation

FreeWRL 0.30 a été testé sur Irix 6.5 et Red Hat 7.2.

Red Hat 7.2, Irix 6.5, et MacOS-X seront désormais les pates-formes de compilation pour FreeWRL 0.30 et au-delà.

FreeWRL 0.29 a également été testé sur des installations récentes de :

• SuSe 7.1
• TurboLinux Workstation 4.0.5
• Mandrake 7.2
• Redhat 7.1 "SeaWolf"

D'autres internautes ont testé FreeWRL sur :

• SGI Onyx II
• FreeBSD

Cette installation est divisée en plusieurs sections :

• Compiler FreeWRL afin de le faire fonctionner en "standalone", sans navigateur comme Netscape..
• Installer le support de Java.
• Faire fonctionner le tout avec Netscape (ou un autre browser).
• Y ajouter les fonctionnalités pour X3D.

 Compiler FreeWRL en tant qu'exécutable "standalone"

Notes: Les fichiers sont dispo ici :

- http://www.crc.ca/en/html/FreeWRL/downloads/downloads
- http://sourceforge.net/projects/freewrl/
- http://freeware.sgi.com/

L'accès au CVS et les instructions :
- http://sourceforge.net/cvs/?group_id=9120

1.0 OpenGL

OpenGL est un "standard" sur les distributions Linux.

Certaines version de Linux ont de vieilles implémentations qui peuvent causer des erreurs.

Si vous rencontrez ces problèmes, téléchargez et make (pas la peine d'installer) la dernière version de Mesa (OpenGL) depuis http://www.mesa3d.org.

Les noeuds Text utilisent maintenant le OpenGL tesselator; vous pouvezrencontrer des bugs d'affichage (cartes VooDoo3, vieux pilotes GeForce) si vos pilotes OpenGL ne sont pas assez récents.

1.1 Installation de Java

Le compilateur java, javac, doit être installé dans votre PATH. La commande which javac dans un terminal vous dira si il est bien installé et où il se trouve dans votre système.

RedHat 7.2 nécessite le package kaffe . Montez le 2ème CD d'installation, allez dans le répertoire RedHat/RPMS , et exécutez la commande rpm -Uvh kaffe-1.0.6-6.i386.rpm

Java est également dispo sur http://www.blackdown.org.

2.0 FreeWRL : Compilation et Installation

Téléchargez la dernière version de FreeWRL et décompressez-la.

Vérifiez que le fihier vrml.conf a les bons chemins concernant les librairies et autres includes.

FreeType version 2 : FreeWRL l'utilise maintenant. Vérifiez que vous avez cette librairie. La commande ldconfig -p | grep freetype vous affichera le chemin où elle se trouve.

Si vous avez une vieille distribution, vous pouvez télécharger une nouvelle version de FreeType depuis http://www.freetype.org.

Installez les modules Perl ; Irix les nécessite tous, Red Hat uniquement ceux indiqués :
Digest-MD5-2.09
HTML-Parser-2.25
MIME-Base64-2.11
URI-1.04
libnet-1.0607
libwww-perl-5.47
Image-Base-1.07 nécessité par la RedHat 7.2

Installer ces modules n'est pas un casse-tête. Décompressez chaque modules puis dans le réperoire créé à chaque fois, faites (n'oubliez pas les majuscules !):
perl Makefile.PL
make
make test (si disponible)
make install
(en tant que root, le super-utilisateur pour le make install)

Notez que libwww-perl vous demandera certainement si vou voulez reconfigurer : les options par défaut suffiront amplement.

 

1. ImageMagick est requis pour convertir des fichiers graphiques. L'utilitaire "convert" est utilisé, lequel devrait être installé sur n'importe quelle distri Linux avec une interface graphique (XFree86 et les environnements de bureau comme KDE, Gnome etc.). Si malgré tout vous ne le trouvez pas, téléchargez-le depuis http://www.imagemagick.org ou http://freeware.sgi.com/

    

2. Construisez le fichier Make :

   perl Makefile.PL

3. Compile/installez FreeWRL

   make
   make install
   (make install en tant que root)

4. Interface expérimentale SAI

   NOTE: Vous n'aurez besoin de ça uniquement si vous voulez débugguer le code SAI !

   mknod.javapipej p
   mknod.javapipep p

5. Exécutez les tests ! Enfin de la 3D !!!

   Ces tests se trouvent dans le répertoire "tests".

   Exécutez tous les tests numérotés (ainsi que tous vos fichiers VRML personnels !!) dans le répertoire des tests. Notez que certains utilisent Javascript javascript, vous testerez donc également le support de jvascript.

3.0 Installer le support de Java

3.1 Javascript :

Dans l'installation basique, vous avez dû installer le support pour Java pour permmetre à certains tests de fonctionner (7.wrl, 8.wrl, et 10.wrl).

Si ces scripts ne fonctionnent pas, refaites un make sur FreeWRL.

3.2) Code EAI :

NOTE: En développement actif, ne marchera sûrement pas.

Les classes EAI ont été regroupées dans l'archive Java vrml.jar.

• cd dans le répertoire tests/AddRemove.
• Lisez le README.
• Envoyez une caisse de bière aux développeurs pour leur boulot époustouflant.

NOTE AUX DEVELOPPEURS: les classes Java EAI peuvent être compilées en utilisant le Makefile généré par Perl.
N'effacez pas le fichier vrml.jar. Il est indispensable qu'il figure dans le PATH du compilateur Java.

3.2) Code SAI :

NOTE: Pareil, en développement actif.

4) Tout faire fonctionner avec Netscape

4.1) Suivez les instructions pour le faire fonctionner en tant que plug-in dans le README du répertoire Plugin.

5) Compatibilité avec X3D

5.1) Allez dans le répertoire x3d et suivez les instructions.

Le reste de ce document, trop spécifique, n'a pas été traduit par mes soins ;p

Mes remarques et expériences by >Ap0< ;)
Sous Mandrake Linux 8.1 noyau de base, environnement KDE 3.0 que je vous conseille ;).

Ce fichier INSTALL.html m'a semblé plutôt rebutant de prime abord. Comme je ne suis pas d'une nature très patiente et que je ne voulais qu'un viewer VRML à intégrer dans mon navigateur Mozilla, j'ai directement attaqué l'installation sans me soucier de mes librairuies et autre fichiers de configurations. Et oui je suis comme ça, moi ! ;)

Commme j'ai installé il y a peu la dernière mouture de KDE, j'avais déjà pas mal de librairies installées, notamment les libxslt et libxml. J'ai donc décompressé bêtement l'archive tar.gz : pas de prise de tête, je double clique sur l'archive tar.gz dans mon explorateur favori (en l'occurence c'était Konqueror), je copie le dossier qui apparaît et je le colle dans mon répertoire utilisateur de /home.

Ensuite j'ouvre un terminal (vous savez la ligne de commande moche, là), je me mets dans mon répertoire utilisateur, en faisant :

cd /home/monrepertoire

Ensuite je fais un listing de tout ce qu'il contient :

ls

ou, pour les amoureux de MS-DOS :

dir

et là je vois le dossier précédemment créé, nommé /FreeWRL-xxxx (où xxxx est la version du soft).
Je me mets dans ce dossier :

cd FreeWRL-xxxx

(n'oubliez pas les majuscules surtout!). Puis je lance la compilation :

perl Makefile.PL

Puis :

make

Je vais ensuite me boire un café le temps que la compilation se termine. Puis je me mets en super-utilisateur root :

su root

On me demande mon mot de passe, h0p je l'entre. Pour les nuls en Linux comme moi, c'est une bonne méthode pour apprendre les commandes du shell. su, c'est donc Super-User ! Maintenant je lance l'installation en tapant :

make install

Je peux aller me prendre un deuxième café mdr ;) !!! Jusque-là tout va bien mais je me tape une erreur : Erreur 2, OpenGL.so introuvable blablabla. Il me faut donc OpenGL. Ou plutôt, Mesa3D, une implémentation libre de OpenGL. Direction http://www.mesa3d.org pour le télécharger (il faut prendre Mesalib-xxxx.tar.gz).

A ce stade, je n'ai pas terminé l'installation, bientôt la mise à jour de ce document. J'en profite pour lancer un appel à ceux qui veulent installer FreeWRL sous Linux afin qu'il me fasse part de leur expérience pour mettre à jour ce doc et/ou corriger les erreurs. N'hésitez pas à me mailer : apostledemencia@aol.com pour que ce doc constitue une référence pour les newbies linuxiens.

- Dernière mise à jour de ce document, le 3 mai 2002 -

Tchô ! ;)

>Ap0<