3. Introduction à l'EAI

L'EAI est une spécification abstraite qui définit un mécanisme pour envoyer et pour recevoir d'événements depuis un programme externe
Implémenté avec Java, l'EAI est un jeu de classes que l'on peut appeler depuis un applet pour contrôler un monde VRML
L'EAI n'est pas un standard, mais une proposition (finalisée en janvier 1999) par le EAI working group
EAI working group: http://www.web3d.org/WorkingGroups/vrml-eai/
La plupart des implémentations (si je ne me trompes pas) suivent le "proposal" par Chris Marrin/SGI qui date de 1977. Il 'sagit d'un "de facto standard".
http://tecfa.unige.ch/guides/vrml/vrml97/ExternalInterface.html (specification)

Il n'existe pas de bon tutorial on- ou off-line à ma connaissance, le seul livre utile est Roehl.B et al. Late Night VRML 2.0 with Java, Ziff Davis Press (mais le code nécessite des révisions). Voir http://tecfa.unige.ch/guides/vrml/vrmlman/ et voir la FAQ ( http://members.xoom.com/muratak/eaifaq.htm )

Se trouvent dans le package vrml.external
Important: Les classes sont distribués avec les clients (plugins) VRML. Le développeur doit donc les chercher dans les installations.

Cosmo Player 2.1: archive "npcosmop211.jar"
Blaxxun: pas d'archive, mais ils sont dans le répertoire "vrml"
Je ne sais pas s'il existe des incompatibilités entre les EAI pour différents plugins et clients WWW ... à priori non, mais ce n'est pas sûr.

A Tecfa: archive avec un extrait des classes Cosmo (sans les scripting nodes)
http://tecfa.unige.ch/guides/java/classes/vrml-cosmo-eai.jar
Note: il faut ces classes juste pour compiler, PAS pour exécuter donc il ne faut pas inclure ces classes dans l'applet. Les plugins vont les trouver sur le PC local !!
Il ne faut jamais utiliser EAI et scripting nodes (Java) en même temps ! Malheureusement il y conflit entre les classes (à vérifier s'il ne s'agit pas juste d'un conflit de noms)

3.1 Anatomie d'une page Web typique

Une page HTML/VRML/EAI typique contient:

<HTML>

  <HEAD>

    <TITLE>Typical HTML EAI/VRML/JAVA file</TITLE>

  </HEAD>

  <BODY>

    <H1>Typical HTML EAI/VRML/JAVA file</H1>

  <!-- VRML plugged-in scene -->

    <embed src="vrml-scene.wrl" border=0 height="250" width="375">

  <!-- EAI Java applet -->

    <applet code="MyEAIapplet.class" mayscript height="200" width=500">

    </applet>

    </BODY>

  </HTML>

Attention: Il faut absolument inclure le paramètre "mayscript" dans le tag applet !!

import java.awt.*;

import java.applet.*;

import vrml.external.*;

public class MyEAIapplet extends Applet {

  Browser browser = null;

  public void init() {

    // Paint something to the applet so that you can see something :)

    add (new Label ("This is the Java Applet with a "));

    add (new Button ("No nothing button"));

    // get the Browser

    browser = Browser.getBrowser(this);

    // Test if we really got and print a message to the Java Console

   if (browser == null) {

      System.out.println("FATAL ERROR! no browser :( ");

      return;

   System.out.println("Got the browser: "+browser);

   // Now we could do something with what we got

Cet exemple montre comment obtenir une connexion vers un browser VRML. Un fois qu'on a l'objet "browser" (le plugin VRML) on peut communiquer avec.

Une fois qu'on a un "handle" vers un noeud, on peut l'observer et le manipuler

équivalent au USE/field et eventOut du scripting node

Créer du VRML from string est vital pour créer de nouveaux objets

ajouter/enlever = même chose que C (on manipule le slot children)

remplace eventIn du scripting node et les "routes"