Ces infos ont été traduites par mes soins et proviennent du site du Web3D Consortium (en anglais). >Ap0<
Les liens de cet articles ne sont pas à jour, pour plus l'informations, consultez cette adresse : http://www.web3d.org/x3d/content/README.X3D-Edit.html

X3D-Edit : Guide d'installation

Développement | Installation | Détails | Contenu/Exemples | Captures d'écran | Diagrammes | Utilisation | BugFix

Qu'est-ce que c'est ?

X3D-Edit est un éditeur de fichiers graphiques pour eXtensible 3D (X3D) - voir la rubrique X3D - permettant d'éditer, sans erreurs (!), des fichiers de définitions X3D ou VRML. Une aide contextuelle au sein de l'éditeur fournit une nomenclature concise des noeuds et attributs (les "champs") du VRML afin de simplifier sa compréhension autant pour le novice que pour l'expert.
X3D-Edit utilise l'ensemble de tags XML définis dans la DTD du Web3D Consortium dispo sur http://www.web3d.org/TaskGroups/x3d/translation/x3d-compact.dtd (la dernière version, la "Compact" ; la précédente étant la "Compromise"), ce en combinaison avec :
La technologie Java de Sun (http://www.javasoft.com/nav/download)
Le Xeena XML Editor (http://www.alphaworks.ibm.com/tech/xeena) d'IBM
Une config du profile (http://www.web3d.org/TaskGroups/x3d-compact.profile).

Le développement

X3D-Edit est utilisé pour développer et tester l'ensemble de tags du X3D pour le VRML de nouvelle génération (VRML 200x).

Nouvelle fonctionnalité: supporte le H-Anim pour l'animation d'humanoïdes (http://www.h-anim.org/Specifications/H-Anim2001)
Nouveau diagramme: http://www.web3d.org/TaskGroups/x3d/translation/XmlToolRelationshipsForX3d.pdf)
Internationalisation (i18n). X3d-Edit-French.bat exécute X3D-Edit et fournit l'aide contextuelle en français, un progrès non négligeable. D'une autre manière, modifiez la variable d'environnement avec SET X3dLanguagePreference=French et les icônes standard s'exécuteront en français. Ce grâce à Frédéric Rousille d l'Ecole Nationale des Ingénieurs de Tarbes (ENIT). Cocorico ! ;)

Et qui osera dire qu'il ne serait pas judicieux de se plonger dans le VRML 2.0 Sourcebook ? (http://www.wiley.com/compbooks/vrml2sbk/cover/cover.htm).
Jetez vous également à corps perdu dans les exemples X3D en relation avec le Sourcebook (http://www.web3d.org/TaskGroups/translation/examples/Vrml2.0Sourcebook/toc.html)

La mailing-list X3D : x3d-contributors mail list.

Des instructions concernant les posseseurs de Mac : README.X3D-Edit.Mac.txt

L'installation

Ce soft est dispo sur le X3D Software Development Kit (SDK), CD volume II rubrique Tools (Outils).

Installez un de ces plug-in gratuits pour visualiser le VRML, si ce n'est déjà fait (!) :

CosmoPlayer 2.1.1 (~3 Mo)

Cortona 3.1 par Parallel Graphics

Contact 5.0 par blaxxun interactive

 

Pour vérifier la bonne installation de votre navigateur VRML, voyez si cet exemple : HelloWorld.wrl fonctionne.

Installez Java. (Java est nécessaire pour l'exécution de Xeena). Ceci devrait également déjà être fait. Pour savoir si Java est installée et pour en connaître la version, tapez dans un shell ou une invite DOS :

java -version

Java JRE (aussi appelée Java Run-Time Environment), 5 Mo, s'installe généralement dans c:\Program Files\JavaSoft\JRE\"version" sous WindoZ et ne permet que l'exécution des classes Java, ce qui est suffisant pour lancer X3D-Edit et Xeena. Java JDK (aussi appelée Java 2 SDK, Standard Edition), 30 Mo, s'installe généralement dans c:\jdk"version" sous WindoZ et fournit un environnement de développement pour la compilation et le débuggage, etc.

Installez Xeena d' IBM Alphaworks : (http://www.alphaworks.ibm.com/tech/xeena (~5 Mo)).

Assurez-vous d'avoir téléchargé la version 1.2EA, pas la version 1.1. Xeena est utilisé pour lancer X3D-Edit. Il est préférable de conserver le chemion d'installation par défaut : C:\IBM\Xeena sous WindoZ. Lorsque Xeena vous demande quelle version de Java utiliser, sélectionnez Java 2 (Runtime Environment ou SDK).Puis dirigez l'installation vers le réperoire d'installation de Java (par défaut C:\jdk"version", surtout pas C:\jdk"version"\bin). Inutile d'entrer un "proxy host". Les autres valeurs par défaut fonctionnent correctement.

Téléchargez X3D-Edit :(~800 Ko) : http://www.web3d.org/x3d/content/README.X3D-Edit.html

Recommandé : téléchargez les exemples X3D (~10 Mo) :
http://www.web3D.org/TaskGroups/x3d/translation/X3D-Examples.zip or
http://www.web3D.org/TaskGroups/x3d/translation/X3D-Examples.tar.gz

Vous pouvez décompresser les fichiers par la méthode Java en tapant :

jar -xvf X3D-Edit.zip

jar -xvf X3D-Examples.zip

Décompressez les archives à la racine et assurez-vous bien de conserver les noms de répertoires contenus dans les archives compressées (WinZip le fait par défaut).

Les exemples X3D sont aussi visualisables en ligne sur : http://www.web3D.org/TaskGroups/x3d/translation/examples/toc.html.

Si vous souhaitez le support de GeoVRML, vous devez installer également GeoVRML.

Si vous souhaitez le support de l'extension DIS-Java-VRML, vous devez également installer DIS-Java-VRML.

Terminé ! Il est temps d'exécuter X3D-Edit. Voyez la section Utilisation pour plus de directives. Consultez le BugFix si vous rencontrez des problèmes. Apprenez le VRML si vous n'avez rien compris ! ;p

Caractéristiques

Interface puissante et intuitive
Crée des "scene graph" valides, les spécificités des noeuds sont respectées
Valide les scènes X3D par rapport au profile VRML97 et au profile Core
Traduit automatiquement les scènes X3D en VRML et lance le navigateur pour en visualiser le résultat
Beaucoup d'exemples de scènes X3D
Aide contextuelle pour chaque élément et ses attributs pour apprendre comment les scènes X3D/VRML fonctionnent réellement
Multi plates-formes grâce à la technologie Java
transcription XSL : X3dToVrml97.xsl , X3dToHtml.xsl (tagset facilement imprimable), et X3dWrap.xsl / X3dUnwrap.xsl (pour ajout/suppression des "wrapper tag")
Support des noeuds pour l'extension DIS-Java-VRML , spécifiés par le DIS-Java-VRML Working Group du Web3D Consortium
Support pour l'édition des noeuds GeoVRML, spécifiés par le profile GeoVRML 1.0
Support des noeuds d'édition d'avatars Humanoid Animation, spécifiés par le profile H-Anim 1.1 (H-Anim/spec1.1)
Support des nouveaux noeuds KeySensor et StringSensor. Cependant, notez bien que l'implémentation de leurs Prototypes n'est pas encore faite.
Support des noeuds d'extension NURBS, proposés par blaxxun interactive. Cependant, notez bien que l'implémentation de leurs Prototypes n'est pas encore faite.

Détails

X3D-Edit utilise dorénavant les ensembles de tags définis par ces DTD :
X3D Compact DTD
DisJavaVrml.dtd
GeoVrml.dtd
HumanoidAnimation.dtd
Nurbs.dtd

Contenu et exemples

X3D-Edit est un outil qui a été longuement testé. il a été utilisé pour réaliser une collection de diverses scènes X3D/VRML dans les exemples X3D (examples.html) et également dans les exemples du VRML 2.0 Sourcebook.
http://www.web3D.org/TaskGroups/x3d/translation/examples/Vrml2.0Sourcebook/toc.html
http://www.web3D.org/TaskGroups/x3d/translation/examples/examples.html
http://www.web3D.org/TaskGroups/x3d/translation/X3D-Examples.zip
http://www.web3D.org/TaskGroups/x3d/translation/X3D-Examples.tar.gz
http://www.web3D.org/TaskGroups/x3d/translation/ConformanceExamples.zip

Captures d'écran

X3D-EditSampleScreenSnapshot.png : l'interface utilisateur

examples/GeoVrml/newGeoVrmlScene.png : noeuds de GeoVRML

examples/HumanoidAnimation/NancyNativeTags.png noeuds pour H-Anim

Diagrammes-sommaires des icônes (PDF)

IconSheet-1.pdf, IconSheet-2.pdf, IconSheet-3.pdf, IconSheet-4.pdf

Utilisation

Invocation par le shell de WindoZ (MS-DOS) :

C:> cd \votre_chemin_de_répertoire
C:\votre_chemin_de_répertoir>X3D-Edit.bat

Invocation par le shell UNIX-Linux :

% source x3d-edit.sh

 

BugFix

0. Xeena/X3D-Edit ne fonctionne pas sous JDK .4 : Télécharger plutôt JDK 1.3.1_02. (http://www.web3d.org/TaskGroups/x3d/translation/README.X3D-Edit.html#Java)

1. Un problème courant d'insttalation : et qui peut arriver sous WindoZ, encore lui. Si vous êtes sous Win95 et rencontrez une erreur "Out of environment space", vous devrez alors augmenter la taille de votre variable d'environnement. Vous pouvez le faire en ligne de commande pour un usage temporaire ou rendre ce changement permanent en modifiant votre fichier config.sys :
Méthode temporaire : tapez ceci après le prompt DOS :
command /e8192
Méthode permanente : entrez la ligne suivante dans votre fichier config.sys et rebootez :
shell/command /e8192 /p
Ensuite, essayez à nouveau de lancer Xeena.

Une alternative concernant Windows Millenium :
Pour Xeena et X3D-Edit j'ai dû faire un clic droit sur l'icône, puis cliquer sur Propriétés, cliquer sur l'onglet Mémoire, régler l'environnement initial à 4096, régler la mémoirre étendue (XMS) à 8192, et mettre la mémoire du mode protégé de MS-DOS (DPMI) à 8192.
Vous devrez redémarrer l'ordinateur pour que les changements soient pris en compte.

2. Si vous utilisez Xeena 1.1, vous êtes un petit coquin qui n'écoute pas ce qu'on lui dit. Désinstallez Xeena 1.1, installez Xeena 1.2 EA et décompressez X3D-Edit.zip une fois de plus pour corriger les bugs dûs au CLASSPATH de Xeena ou vous aurez ce genre d'erreur :

C:\www.web3D.org\TaskGroups\x3d\translation>c:\ibm\Xeena\xeena.bat -dtd "c:\www.web3D.org\TaskGroups\x3d\translation\x3d-compromise.dtd" -root X3D -xml "c:\www.web3D.org\TaskGroups\x3d\translation\examples\newScene.xml" Syntax error Syntax error running Xeena with Java 2 Exception in thread "main" java.lang.NoClassDefFoundError: com/ibm/hrl/xmleditor/Xeena

3. Mémoire insuffisante : Vous aurez besoin de 128 Mo de RAM ou plus...                  

4. Certains n'ont peut-être pas installé l'outil Make...

Make n'est pas indispensable pour faire tourner X3D-Edit, mais il est utilisé pour le développement des sources de X3D-Edit.

Make est disponible via la distribution Cygnus des utilitaires GNU Utilities For PCs sur http://sourceware.cygnus.com/cygwin.
La distribution Cygwin fournit la ligne de commande Unix ainsi que les utilitaires sur Windows 95/98/NT/2000. N'oubliez pas de mettre à jour votre PATH avec quelque chose dans ce genre là :
C:\cygnus\cygwin-b20\H-i586-cygwin32\bin;
Une fois Make installé, éditez le Makefile pour l'adapter à votre installation en local.

5. IBM Haifa portaient une attention particulières à répondre au reports de bugs concernant Xeena. Malheureusement, malgré le popularité de Xeena, leur équipe ne travaille plus sur cet outil. Nous espérons pouvoir régler les bugs connus un de ces jours. Néanmoins, ça marche nickel pour X3D-Edit ! Leurs bugs connus ainsi que leurs résolutions pour X3D/Xeena sont enregistrés dans examples/AllVrml97Nodes.wrl en 3D
(http://www.web3d.org/TaskGroups/x3d/translation/examples/AllVrml97Nodes.wrl) et dans examples/AllVrml97Nodes.xml en XML (http://www.web3d.org/TaskGroups/x3d/translation/examples/AllVrml97Nodes.xml).

Révision de cette page : le 25 avril 2002.
Page originale (en américain) disponible sur
http://www.web3d.org/TaskGroups/x3d/translation/README.X3D-Edit.html

> Ap0 <