Cosmo Player 2.1
Notes sur la mise à jour
pour Windows 95 et Windows NT

téléchargez et installez ActiveMovie, si vous le souhaitez. (Utilisez la touche \ [barre oblique inverse] pour afficher la console). Vous pouvez télécharger le fichier archive auto-extractible du logiciel ActiveMovie à partir du site ftp de Cosmo (amovie.exe).

Lors de l'installation d'ActiveMovie, il se peut que les icônes des fichiers multimédias (.mpg, etc.) de votre système soient différentes. C'est parce que ActiveMovie modifie les associations par défaut de ces types de fichiers. Consultez le site www.microsoft.com/directx pour plus d'informations sur ActiveMovie/DirectShow.

Direct X

Cosmo Player 2.1 utilise DirectSound3D, disponible dans DirectX 3.0, ou ses versions ultérieures, pour obtenir des sons réalistes et spatialisés. Sans DirectX 3. le son est pseudo-spatialisé en faisant varier la fonction panoramique droite/gauche.

Windows 95

Si le message

DirectX 3.0 ou ultérieur non détecté. La spatialisation sera limitée à un simple calcul de panoramique droite/gauche.

s'affiche sur la console Cosmo Player, vous devez installer DirectX 3.0 ou une version ultérieure si vous désirez disposer d'un son parfaitement spatialisé. Pour obtenir les meilleurs résultats sous Windows 95, utilisez DirectX 5.0 ou une version ultérieure. Le fichier auto-extractible de l'exécutable de DirectX 5.0 est disponible sur le site ftp de Cosmo (dx5eng.exe). Il s'agit de la version en anglais de Direct X 5. Les utilisateurs désirant utiliser une version dans une autre langue doivent télécharger la version à partir du site de Microsoft.

Windows NT

Service Pack 2 pour Windows NT 4.0, et les versions antérieures, contient Direct X 2.0. Pour obtenir Direct X 3.0, qui permet une spatialisation parfaite, vous devez installer Service Pack 3 pour Windows NT, qui est disponible sur le site de Microsoft : Service Packs pour Windows NT.

6. Dépannage

D'autres informations relatives aux pannes dont disponibles sous la rubrique FAQ de la page Support technique de Cosmo Player sur le site http://cosmosoftware.com/support/player.

Aucun son n'est émis dans les mondes comportant des données sonores.

1. Vérifiez que le son fonctionne correctement en dehors de Cosmo Player 2.1. Cliquez deux fois sur un fichier WAV sous le Gestionnaire de fichiers de Windows. Effectuez également le test avec un fichier .MID.
2. Affichez la console Cosmo Player (utilisez la touche / [barre oblique inverse]) pour rechercher un message concernant le système audio.

Aucun son n'est émis dans un monde spécifique.

1. Vérifiez la console Cosmo Player 2.1 pour identifier toute erreur relative au son.
2. Vérifiez que ce type de son est bien pris en charge par Cosmo Player 2.1. En particulier, sans ActiveMovie/DirectShow, seuls les sons non comprimés WAV et MIDI sont reconnus.

Le son n'est pas spatialisé.

1. Sans Service Pack 3, sous Windows NT ou sans DirectX 3.0, ou version ultérieure, sous Windows 95, le son est « pseudo-spatialisé » uniquement.
2. Le son MIDI n'est pas spatialisé.

Je ne vois pas de vidéo, alors que je suis censé en voir.

1. Vérifiez que ActiveMovie/DirectShow est installé.
2. Vérifiez que le lecteur video fonctionne en dehors de Cosmo Player 2.1.

La vidéo apparaît dans une fenêtre contextuelle séparée.

• Réinstallez Cosmo Player 2.1 et relancez-le.

Cosmo Player se bloque au démarrage lorsque j'utilise un pilote graphique Matrox Millenium avec Netscape sous Windows NT.

• Le pilote graphique Java peut être à l'origine de l'erreur.  Consultez le site  http://help.netscape.com/kb/client/970805-1.html ou procurez-vous directement la version corrigée sur le site de Microsoft à l'adresse ftp://ftp.microsoft.com/bussys/winnt/winnt-public/fixes/usa/NT40/hotfixes-postSP3/getadmin-fix.

Le navigateur Web se bloque lorsque j'ouvre la fenêtre Préférences.

• Cette bogue existe dans des versions précédentes de Windows 95. Vous devez mettre à niveau le fichier système de Microsoft, COMCTL32.DLL (avec la version 4.70 ou ultérieure). Malheureusement, compte tenu des limitations de licence Microsoft, la seule façon de se procurer cette DLL consiste à installer l'un des produits Microsoft qui la contiennent, tels que Internet Explorer 3.0.2, Internet Explorer 4.x, Word 97 ou Developer Studio 5.

Java ne fonctionne pas.

• Vérifiez la variable CLASSPATH.  Si la variable d'environnement CLASSPATH indique une autre classe vrml.* (n'appartenant pas à Cosmo Player 2.1), les fonctions Java ne sont pas disponibles.

Les fichiers de la classe JSAI ne se chargent pas dans Internet Explorer.

• Vérifiez que le serveur SOCKS de votre pare-feu est compatible avec Internet Explorer. Une solution consiste à utiliser un proxy HTTP pour accéder à Internet ou à mettre à niveau votre serveur SOCKS pare-feu.

Les fichiers VRML incorporés fonctionnent sous Netscape et IE 4.0, mais pas avec IE 3.x.

• Assurez-vous que vous utilisez bien des guillemets (et NON des apostrophes) dans votre code HTML. Comme ceci  SRC="coolVRML.wrl"   et non comme cela   SRC='coolVRML.wrl'.

Une partie du code EAI ne fonctionne pas dans Internet Explorer.

• Ceci se produit lorsque l'applet EAI utilise l'ancienne méthode LiveConnect (avec les appels JSObject) pour accéder au navigateur VRML ; ces appels sont spécifiques à Netscape. Assurez-vous que le code utilise la méthode Browser.getBrowser() qui fonctionne dans Netscape et dans Internet Explorer.

7. Différences entre Cosmo Player 2.0 et 2.1

Nouvelles caractéristiques

Nouvelles caractéristiques de Cosmo Player 2.1 :

• Il existe une version Macintosh ! (en pré-lancement le 3/4/98)
• Prise en charge de la couleur 16 bits et de la carte accélératrice Direct3D (pour DirectX 5) sous Windows 95. Voir les informations ci-dessous.
  Remarque : Le mode couleur 8 bits n'est pas pris en charge avec la fonction de rendu Direct3D de Cosmo Player. Nous avons fait les tests préliminaires, mais cette configuration n'est pas prise en charge.
• L'interface externe EAI est conforme aux spécifications de l'interface COM. Consultez la page des ressources destinées aux développeurs de Cosmo Player. Vous y trouverez un kit de développement qui utilise l'interface de développement COM EAI.
• Cosmo Player est maintenant compatible avec le modèle d'événements VRML97. Par exemple, Cosmo Player 2.1 charge d'abord les scripts et les EXTERNPROTO pour permettre un fonctionnement prédéfini.
• Amélioration de la documentation
• Meilleure prise en charge de l'affichage 8 bits
• Augmentation de la vitesse de lancement
• Nouvel éventail de préférences « graphiques » pour le rendu. Affichage sur la console Como Player des informations concernant la fonction de rendu utilisée.

Bogues corrigées

L'équipe de développement de Cosmo Player a corrigé un grand nombre de bogues entre les versions 2.0 et 2.1. Elles sont trop nombreuses pour les énumérer ici. Voici quelques unes des principales corrections :

• Le modèle d'événements est conforme à VRML97
• Les scripts et les EXTERNPROTO sont chargés en premier pour assurer une initialisation correcte.
• Le passage d'événements à des noeuds de groupes sous la forme d'une cascade d'événements est traité correctement
• Les pertes de mémoire dans les EAI sont corrigées
• L'aspect du tableau de bord de Cosmo Player a été considérablement amélioré en mode 8 bits.
• Les liens HTML (ou les cibles VRML) vers les URL comme dans "myWorld.wrl#ViewpointName" vous conduisent maintenant correctement au point de vue spécifié.
• Les descriptions des cibles sont affichées dans Internet Explorer.
• Vous pouvez maintenant animer le champ de vision de la caméra en le dirigeant directement vers le fieldOfView du point de vue en cours.
• Les points de vue sont maintenant correctement retirés de l'IU (menu déroulant contenant la liste des points de vue) lorsqu'ils sont supprimés de la scène ou après l'appel de la commande replaceWorld()
• Le temps absolu est maintenant correct (il était décalé)

Différences entre Cosmo Player 1.0 et 2.x

Si vous mettez à niveau Cosmo Player 1.0, les principales nouvelles fonctions de la version 2.x sont :

• L'interface utilisateur a été remaniée ; elle est maintenant plus intuitive et plus naturelle.
• La console Cosmo Player affiche des erreurs, des avertissements, des informations de développement et des instructions print().
• Informations sur les API de la fonction de rendu :
  • OpenGL est utilisé comme API de la fonction de rendu Cosmo Player 2.0.
  • OpenGL et Direct3D (sous Windows 95 et nécessitant DirectX 5 ou une version ultérieure) peuvent être utilisés comme API de la fonction de rendu de Cosmo Player 2.1.
  • Par conséquent, si vous disposez d'une carte accélératrice avec des pilotes OpenGL et/ou une machine compatible MMX, Cosmo Player utilise cette carte pour l'accélératio OpenGL. Sous Windows 95, si vous avez installé DirectX 5, ou une version ultérieure, et que vous disposez de l'une des cartes graphiques prises en charge, Cosmo Player utilise la carte d'accélération Direct3D.
• Le noeud Script de CP 2.x. prend en charge le code Java Les dernières spécifications figurent dans la section Revised Java Appendix de la page http://www.vrml.org/Specifications/VRML97/.
• Prise en charge d'Internet Explorer 4.0.
• Le code java ne doit être compilé qu'une seule fois (et non plus une fois pour Netscape et une fois pour Internet Explorer).

8. Les composants de cette version

Cosmo Player 2.1 comprend :

• Module externe Cosmo Player de Netscape

  Le module externe Cosmo Player, npcosmop21.dll est installé dans le répertoire des modules externes de Netscape.

• Cosmo Player en tant que contrôle ActiveX

  Le contrôle ActiveX de Cosmo Player, cp21_axucp.dll, est installé, par défaut, dans le répertoire système de Windows, c'est-à-dire \Windows\System sous Windows 95 et \Winnt\System32 sous Windows NT.
  D'autres produits de Cosmo Software peuvent utiliser Cosmo Player comme contrôle ActiveX pour obtenir un aperçu de la progression des tâches VRML.  Internet Explorer de Microsoft peut utiliser le contrôle ActiveX pour afficher des données VRML.

• DLL prenant en charge Cosmo Player

  Toutes les autres DLL requises par Cosmo Player sont installées, par défaut, dans le répertoire système de Windows, c'est-à-dire \Windows\System sous Windows 95 et \Winnt\System32 sous Windows NT.

• DLL partagées de Cosmo Software

  Cosmo Software a d'autres produits qui peuvent partager des DLL avec Cosmo Player.  Elles sont installées, par défaut, dans le répertoire système de Windows, c'est-à-dire \Windows\System sous Windows 95 et \Winnt\System32 sous Windows NT.

• Classes Java EAI (External Authoring Interface) Comos Player et Java dans les classes JSAI (Script Node Authoring Interface) du noeud de script
  • Pour permettre les utiliser dans Netscape, ces classes sont installées dans le fichier npcosmop21.zip (ou npcosmop21.jar) du répertoire des modules externes de Netscape.
  • Pour permettre de les utiliser dans Internet Explorer, ces classes sont installées dans \Program Files\CosmoSoftware\CosmoPlayer

• Exemple de scène VRML 2.0

  Un exemple de scène VRML 2.0 est fourni avec cette version. Il est installé, par défaut, dans \Program Files\CosmoSoftware\CosmoPlayer\examples. D'autres exemples sont disponibles à l'adresse du site VRML de Cosmo.

• Convertisseur de VRML 1.0 en VRML 2.0

  A la lecture, Cosmo Player convertit automatiquement les fichiers VRML 1.0 en fichiers VRML 2.0. Si vous désirez convertir définitivement les fichiers VRML 1.0 en fichiers 2.0, utilisez le convertisseur autonome vrml1tovrml2.exe. Par défaut, le convertisseur est installé dans le même emplacement que les DLL.

• GZIP

  Tous les formats de données peuvent maintenant être comprimés avec gzip. Ceci peut améliorer de façon significative le temps de téléchargement des fichiers de données volumineux si le modem utilisé est lent.

• UTF8

  Pour l'affichage, Cosmo Player lit et convertit les caractères utf8 d'un fichier WRL en caractères Unicode. Ceci fonctionne sous NT4.0 pour les chaînes de caractères du noeud Text ainsi que pour les descriptions du noeud Viewpoint. Windows 95 ne reconnaît pas les caractères Unicode et affiche donc un '-' (un tiret) dans la plupart des cas, mais gère, dans une certaine mesure, les caractères de type Latin1. Naturellement, vous devez avoir installé les polices TrueType comportant les caractères à afficher.

• Ces notes sur la mise à jour

  Par défaut, les notes sur la mise à jour sont installées dans \Program Files\CosmoSoftware\CosmoPlayer\doc\relnotes.html.  Pour obtenir les dernières notes de mises à jour, consultez la page du site Cosmo Software.

9. Informations pour les développeurs VRML

Compatibilité avec Cosmo Worlds 2.0

Cosmo Worlds 2.0 peut compiler vos fichiers Java. Ceci implique que le compilateur doit pouvoir trouver le fichier npcosmop.zip de Cosmo Player 2.0 (ou les fichiers .jar) ou le fichier npcosmop21.zip de Cosmo Player 2.1 (ou les fichiers .jar). Si vous avez installé Cosmo Player 2.1, vous devez mettre à niveau Cosmo Worlds de la manière suivante pour utiliser le fichier zip (ou jar) associé :

1. Lancez Cosmo Worlds
2. Dans l'éditeur de script, choisissez l'onglet Paramètre, puis changez les options du compilateur
   • valeur initiale : -classpath "<JDK install directory>\lib\classes.zip;<Cosmo Player 2.0 install directory>\npcosmop.zip "
   • devient : -classpath "<JDK install directory>\lib\classes.zip;<Cosmo Player 2.1 install directory>\npcosmop21.zip "

Prise en charge de VRML 2.0

Cosmo Player prend en charge toutes les spécifications VRML97 . Il est conforme à la syntaxe et à la sémantique de la version finale.

Fonctions spéciales

Nous avons mis en oeuvre quelques fonctions supplémentaires pour permettre aux développeurs de déboguer leur code,  à savoir :

• A l'exécution, vous pouvez activer ou désactiver l'affichage du nombre d'images sur la scène en appuyant sur la touche =.

• Vous pouvez forcer l'affichage de la console à l'exécution en appuyant sur la touche / du clavier numérique (ou sur la touche \ du clavier principal).

• En utilisant des balsies EMBED, vous pouvez désactiver les IU visibles (semblables à Aucun afficheur) tout en continuant à fournir des fonctions de navigation intégrées. Ceci peut être utile pour les bannières publicitaires ou tout autre contenu VRML d'affichage rapide. Exemple :

        <EMBED SRC="frob.wrl" WIDTH=120 HEIGHT=90 VRML-DASHBOARD=FALSE>
  

  Notez que pour les modules externes pleine page/cadre vous devez utiliser la balise EMBED dans le code HTML pour obtenir cet effet, en indiquant une largeur et une hauteur de « 100% ».

• En utilisant une balise EMBED, vous pouvez définir la couleur initiale d'arrière-plan de la fenêtre VRML (par exemple pour qu'elle concorde avec la couleur d'arrière-plan de la page HTML). La syntaxe est

    VRML-BACKGROUND-COLOR="#rrggbb"
  

  où les "rrvvbb" correspondent aux valeurs hexa des couleurs : rouge, vert et bleu.

• Une méthode print() est disponible dans Javascript pour envoyer à la console Cosmo Player des informations à partir d'un noeud de script VRML. Par exemple :

     Script {       url "javascript:            function initialize() {                  print('Script 2 initialized.');                    vec = new SFVec2f(0,1);                   print('SFVec2f is ('+vec.x+','+vec.y+')');           }";     }
  

• Une méthode print() est également disponible pour les interfaces EAI et JSAI. Les méthodes Browser.print() statiques affichent les informations transmises à la console Cosmo Player. Cette méthode a comme arguments des objets de type String, int, boolean, float, double, long, ou char.  Par exemple, dans une EAI :

        import vrml.external.Browser;        ...        Browser.print("Votre message ici");
  

  ou

        vrml.external.Browser.print("Votre message ici");
  

  Dans une JSAI :

        import vrml.Browser;        ...        Browser.print("Votre message ici");
  

  ou

        vrml.Browser.print("Votre message ici");
  

Notes sur la mise à jour pour le multimédia

• La recherche MIDI n'est pas prise en charge. Par conséquent, les fichiers MIDI ne peuvent être lus qu'à partir du début.
• Le son MIDI ne sera pas spatialisé. Il diminuera avec l'éloignement de l'auditeur.
• Un seul clip MIDI peut être joué à la fois.
• L'option « Mettre en veilleuse lorsque le fenêtre est inactive » n'a pas d'effet sur les sons MIDI.
• Il peut arriver que les fichiers MIDI contenant beaucoup de messages de type SysEx ne soient pas lus correctement.
• La fréquence d'un son (dans un clip audio) est limitée à 100 kHz. En d'autres termes, un clip à 22 kHz peut être augmenté au maximum d'un facteur 4.4. La fréquence des sons n'étant pas filtrée, le facteur d'augmentation de la fréquence des sons contenus dans le fichier doit être calculé en tenant compte du fait que la fréquence maximum est de 100KHz . La même limite concernant la fréquence s'applique aux nœuds MovieTexture lorsqu'ils sont utilisés comme source audio.
• Il peut arriver, lorsque plusieurs instances de Cosmo Player sont ouvertes, qu'une seule d'entre elles produise du son. Ceci est dû aux outils fournis par Microsoft. Si vous ne disposez pas des pilotes natifs DirectSound des périphériques audio utilisés, Windows active un mode d'émulation qui utilise les fonctions WAVE. Deux applications ne peuvent avoir leur périphérique WAVE ouvert simultanément. Par conséquent, si vous ne disposez pas des pilotes natifs DirectSound, vous ne pourrez obtenir du son que d'un seul dispositif à la fois. Notez que, sous NT4.0, DirectSound utilise toujours le mode d'émulation. Ainsi, si vous utilisez NT4.0, deux dispositifs ne pourront jamais produire du son simultanément.
• Les noeuds MovieTexture ne prennent pas en charge les vitesses négatives dans les fichiers MPG/AVI/MOV.
• Le décodage par MovieTexture peut diminuer les performances de la fonction de rendu. En général, les performances sont bien meilleures avec un petit nombre d'images (par exemple, 10 fps) et des images de petite taille (par exemple, 128 x 128).
• Lors de l'exécution en boucle de MovieTextures, le son peut « sauter » lors du retour à la première piste.
• Le canal alpha n'est pris en charge par aucun format vidéo, mais vous pouvez utiliser des fichiers d'animation GIF transparents.

OpenGL, Direct3D et les cartes graphiques accélératrices

• Si vous disposez d'une carte accélératrice OpenGL ou Direct3D (avec DirectX 5 installé), Cosmo Player utilise systématiquement cette carte. L'option « fonction de rendu logicielle seulement » figurant dans la page préférences/graphiques permet de désactiver les cartes d'accélération. Différentes circonstances peut vous amener à le faire, par exemple :
  • Certaines cartes accélératrices ne sont pas plus rapides (et parfois même plus lentes) que les logiciels OpenGL fournis avec Cosmo Player. Par exemple, actuellement, les performances du pilote Matrox Millenium II sont faibles et les logiciels OpenGL sont, en général, plus rapides.
  • La qualité de la fonction de rendu produite par certaines cartes accélératrices peut être inférieure à celle des logiciels, notamment si vous utilisez l'affichage 8 bits (Vous ne pouvez utiliser la fonction de rendu Direct3D livrée avec Cosmo Player 2.1 en mode couleur 8 bits).

  Si vous possédez une carte accélératrice, comparez les performances et la qualité graphique de la fonction de rendu matérielles à celles de la fonction de rendu logicielle et définissez vos préférences en conséquence. Si aucune carte accélératrice n'est installée, le bouton « Fonction de rendu logicielle seulement » apparaît en grisé et ne peut être sélectionné.

• Cartes graphiques accélératrices OpenGL

  Si vous disposez d'une carte graphique 3D et de pilotes OpenGL, Cosmo Player utilise la carte. Les cartes OpenGL suivantes fonctionnent avec Cosmo Player :

  • Cartes basées sur le processeur 3DLabs Permedia 2 (par exemple, la carte FireGL 1000 Pro de Diamond Multimedia disposant de pilotes OpenGL pour Win95 et NT ; assurez-vous d'avoir les derniers pilotes !)
  • Cartes basées sur le processeur ATI Rage Pro (par exemple, carte ATI Rage Pro ayant des pilotes OpenGL pour NT.)
  • Cartes basées sur le processeur Nvidia Riva 128 (par exemple, carte Diamond Multimedia Viper V330 ayant des pilotes OpenGL pour Win95).
  • Cartes basées sur le processeur 3DPro/2mp de Mitsubishi (par exemple, carte Diamond Multimedia Fire GL 4000 ayant des pilotes OpenGL pour NT ; assurez-vous d'avoir les derniers pilotes !).

• Cartes accélératrices Direct3D

  DirectX 5 (ou une version ultérieure) doit être installé pour utiliser la fonction de rendu Direct3D. (DirectX 5 n'est actuellement disponible que pour Windows 95.) Nous avons testé les cartes accélératrices suivantes Direct3D et fournissons le support associé :

  • Diamond Viper 330 (processeur nVidia RIVA128)
  • Diamond FireGL 1000 Pro (processeur DLabs Permedia 2)
  • ATI 3D Rage Pro (processeur ATI Rage Pro)
  • Real3D StarFighter (utilisant le processeur Intel 740)

    Remarque : si Cosmo Player utilise la fonction de rendu via la carte accélératrice Direct3D et que la taille de la fenêtre devient trop large pour la carte accélératrice (en fonction de la carte), Cosmo Player utilise la fonction de rendu logicielle Direct3D.

  Nous nous sommes efforcés de faire fonctionner la fonction de rendu Direct3D qu'avec le logiciel, mais tous les tests n'ont pas été réalisés.

Guide du développeur multimédia VRML

Notre expérience et les commentaires des développeurs VRML nous ont amené à formuler les conseils ci-dessous.

• Insérez plusieurs URL dans les noeuds AudioClip et MovieTexture. Par exemple, si vous souhaitez utiliser un fichier audio MPEG1 dans un noeud AudioClip, placez un fichier de format .WAV comme recours pour les navigateurs qui ne peuvent pas gérer les flux audio MPEG seulement.
• Utilisez des fichiers MIDI pour la sonorisation d'ambiance et/ou pour de longs morceaux de musique. Par exemple, vous pouvez utiliser des clips audio MIDI activés par des capteurs de proximité pour créer un fond sonore approprié aux différentes pièces/régions de votre monde. Tenez compte des limitations mentionnées ci-dessus lorsque vous utilisez des clips MIDI (par exemple, obligation de commencer au début, absence des messages de type SysEx).
• Utilisez des fichiers audio MPEG 1 Layer II (extension .mpa) pour la plupart des autres sons, en particulier pour les sons qui doivent être spatialisés. Notez que vous pouvez utiliser des fichiers .mpa comme URL d'un noeud AudioClip avec CP2.0, le noeud MovieTexture n'étant pas nécessaire. L'audio MPEG1 présente un problème lors d'une exécution en boucle : le programme émet un clic lors du passage de la fin au début du morceau. Il s'agit d'une limitation inhérente à ce format.
• Pour obtenir les meilleurs résultats avec les noeuds MovieTexture, utilisez la vidéo avec un nombre d'images par seconde égal à 10 fps maximum et une taille d'image de <= 128x128. Avec OpenGL les dimensions des textures doivent correspondre à des puissances de 2 (par exemple 128 x 64, 32 x 32). En conséquence, vous obtiendrez de meilleures performances en codant la vidéo en fonction d'une taille appropriée.
• Utilisez des fichiers d'animation GIF dans le noeud MovieTexture si vous avez besoin de transparence ou pour prendre en charge des vitesses négatives.

10. Bogues répertoriées et limitations

Spécifications VRML97

• Questions relatives à Java
  • Informations pour les développeurs
    • Pour plus d'informations sur l'utilisation de Java avec VRML, via les interfaces JSAI (Java Script Authoring Interface) et EAI (External Authoring Interface), consulter la section sur les développeurs du site Web de Cosmo Software. La page EAI comprend les caractéristiques techniques de EAI et plusieurs exemples de programmes contenant le code source.
  • Prise en charge de Java dans IE 3.x
    • Si vous avez installé Cosmo Player pour l'utiliser sous Internet Explorer 3.x, vous devez installer Microsoft Java VM pour IE 4.0 pour pouvoir exécuter le code JSAI et EAI.
  • LiveConnect - EAI - Netscape 4.x
    • Veiller à ne pas utiliser les anciens types d'appels LiveConnect (les fonctions JSObject qui étaient utilisées dans les anciennes versions des exemples EAI) dans vos applets EAI lors du retour d'une référence au navigateur VRML ! Vous devriez plutôt utiliser la méthode Browser.getBrowser() ; elle fonctionne aussi bien avec Netscape qu'avec Internet Explorer et elle permet à Cosmo Player de résoudre automatiquement les bogues de LiveConnect présentes dans certaines versions de Netscape.
    • Veillez également à configurer votre navigateur (c.-à-d. l'appel getBrowser() et toute consultation de noeud) dans votre méthode d'applet start(). Si en revanche, vous le faites dans init(), vous pouvez interrompre votre applet EAI ou bloquer Netscape. Les questions fréquemment posées de Cosmo Player 2.x (sur la page des ressources de support technique de Cosmo Player) donnent toutes les informations sur ce problème, ainsi que certaines astuces importantes de programmation EAI.
    • Si la méthode getBrowser() retourne null, même si Cosmo Player est chargé correctement, assurez-vous que la variable d'environnement CLASSPATH ne contient aucune référence à java40.jar. Si vous ne parvenez pas à résoudre le problème, essayez de redéfinir complètement la variable CLASSPATH.
    • Enfin, même si les applets EAI sont correctement écrits, il se peut qu'avec certaines versions de Netscape, la méthode getBrowser() retourne null (ou que Netscape se bloque !) lorsque vous sélectionnez « Recharger » ou lorsque vous quittez une page EAI (p. ex. en sélectionnant « Précédent ») puis en la consultant de nouveau. Le code LiveConnect sous-jacent (l'interface spécifique à Netscape qui est utilisée pour gérer le navigateur VRML intégré) est très sensible à la durée de la séquence de rechargement et peut parfois retourner une référence de navigateur incorrecte à l'applet ; nous pouvons remédier à ces problèmes dans la plupart des cas (et la fonction de rechargement fonctionne bien avec la plupart des applets EAI sur la plupart des systèmes), mais il se peut que vous rencontriez des problèmes occasionnels. L'utilisation de MAJ-Recharger (au lieu de Recharger) causera probablement moins de problèmes.
  • Paramètre CLASSPATH pour EAI/JSAI
    • Certaines applets EAI peuvent exiger que les classes Java EAI/JSAI figurent explicitement dans la variable CLASSPATH. Si, lors du chargement d'une applet EAI, l'exception java.lang.ClassNotFoundException se produit pour l'une des classes de la bibliothèque vrml, vous devez ajouter les classes Java de Cosmo Player à la variable CLASSPATH. Les classes Java de Cosmo Player sont installées dans le répertoire plug-ins de Netscape. Par conséquent, avec Communicator, il suffit d'ajouter Program Files/Netscape/Communicator/Program/Plugins/npcosmop21.jar à la variable CLASSPATH.
  • Utilisation de MField.getSize() au lieu de array.length
    • Dans les interfaces JSAI et/ou EAI, utilisez MField.getSize() pour obtenir la taille d'un tableau si celui-ci a été retourné par une fonction de JSAI ou EAI (telle que MFColor.getValue()). Vous devez procéder ainsi du fait d'une erreur d'implémentation de Java VM et JRI dans Navigator 3.x ; array.length retourne parfois une valeur erronée.
  • Noeud Script
    • Le composant JSAI dans Internet Explorer (ou lorsque l'accès s'effectue via la fonction ActiveX de Cosmo Player) exige que les classes dérivées du script soient publiques ; cela est également indiqué dans les spécifications JSAI. La machine virtuelle Microsoft ne charge pas vos classes Java Script si elles sont de type privée, protégée ou par défaut. Elles doivent être définies explicitement comme étant publiques. Par exemple :
          class Foo extends Script publique { ... }
      sera chargée dans un noeud Script dans Internet Explorer alors que la classe ci-dessous ne le sera pas :
         class Foo extends Script { ... }
      
  • URL de base
    • Lorsque loadUrl(), createVrmlFromUrl() ou createVrmlFromString() sont appelés à partir d'un applet Java Script ou EAI, ces appels utilisent maintenant l'emplacement de la classe Java exécutée comme URL de base pour les URL correspondants. Par exemple, la classe Java est http://foo.com/a.class et le monde VRML actuel est http://bar.com/b.wrl ; si la classe Java appelle loadUrl("other.wrl"), "other.wrl" sera chargé à partir de http://foo.com.
    • Il s'agit du comportement correct et conformes aux spécifications. Pour plus d'informations, voir la section 4.5.3 des spécifications VRML97 .
  • Perte de mémoire avec EventOut.advise()
    • Lorsque la méthode EventOut.advise() est utilisée (pour préparer un rappel (callback) de la scène VRML vers votre applet EAI), le second paramètre de cet appel est un objet « userData » qui est retourné à votre applet chaque fois qu'une méthode callback() se produit. La « perte de mémoire » consiste ici dans le fait que tout objet que vous introduisez comme « userData » dans EventOut.advise() ne sera jamais géré dans le « ramasse-miettes » (garbage collector), même si le noeud qui génère les rappels est supprimé de la scène VRML.
    • La solution : ne pas introduire de larges objets (comme les objets Noeud VRML !) en tant que « userData » dans EventOut.advise(), notamment si votre applet ne cesse d'ajouter de nouveaux noeuds à la scène, d'enregistrer des rappels sur ces noeuds, puis de les supprimer !

• Propriétés des matériaux
  • Certaines cartes accélératrices ne rendent pas correctement les couleurs des matériaux avec plusieurs sources d'éclairage.
     
• Lumières
  • Il existe avec le transmetteur de rendus OpenGL une limite au nombre de lumières qui peuvent être activées simultanément dans une scène. En général, ce nombre est de 8, bien qu'il puisse être supérieur avec certaines cartes graphiques. Les lumières générales (lumières ponctuelles et projecteurs) ont la priorité la plus élevée ; ainsi vous ne pourrez pas voir les lumières directionnelles si vous avez trop de lumières générales.
    Remarque importante : le projecteur est inclus dans cette limite. Puisqu'il s'agit d'une lumière directionnelle, il ne sera pas visible si votre scène contient 8 lumières générales ou davantage !

  • Avec le transmetteur de rendu OpenGL, les lumières ponctuelles et les projecteurs ne tiennent pas compte du champ rayon. En conséquence ces types de sources lumineuses éclairent la scène toute entière. Le champ d'atténuation peut être utilisé pour réduire les effets de l'éclairage. Les lumières directionnelles sont correctement déployées par leur groupe parent selon les spécifications VRML97.
     
• Textures
  • Certaines propriétés de texture (clamp/wrap) ne sont pas fidèlement conservées lorsqu'elles sont traitées par certaines cartes accélératrices.
     
• Interpolateurs
  • La fonction NormalInterpolator effectue une interpolation linéaire des normales suivie d'une projection sur la sphère unité. Elle devrait faire l'interpolation sur la surface de la sphère unité.
     
• Extrusions
  • Cosmo Player peut se bloquer si vous tentez d'étendre l'arête ou le profil d'une extrusion (c.-à-d. la route d'un Script vers un événement set_spine ou set_crossSection eventIn d'un noeud Extrusion, en utilisant une valeur qui augmenterait le nombre de points Spine (arêtes) ou CrossSection (profils).) La solution consiste à créer votre extrusion avec le maximum de points Spine/CrossSection nécessaires et à les réinitialiser de façon appropriée pour étendre l'extrusion. Vous pouvez aussi recréer complètement l'extrusion (p. ex. via createVrmlFromString()) si vous devez augmenter le nombre de point d'arêtes/profils.
     
• Aller
  • Lors du chargement d'un fichier VRML comprimé avec gzip, avec l'extension .gz, Netscape 3.x peut afficher ce message d'avertissement : « Attention : encodage non reconnu : 'x-gzip' ». Vous pouvez ne pas tenir compte de ce message et Cosmo Player traitera correctement le fichier. Une solution consiste à renommer le fichier comprimé avec gzip en lui donnant une extension .wrl au lieu d'une extension .gz.
     
• Parallélépipèdes englobants spécifiés par l'auteur
  • Des noeuds de regroupement qui vous permettent de spécifier un parallélépipède englobant (Anchor, Billboard, Collision, Group, Inline et Transform) ignorent les champs bboxCenter et bboxSize dans Cosmo Player 2.1. Le navigateur utilise à la place le parallélépipède englobant des noeuds enfants. (Ces champs sont supposés n'être que des indications pour le navigateur, dans un but d'optimisation, et ne sont pas requis pour être conformes, selon les spécifications VRML97.)
     
• Vitesse de navigation
  • Cosmo Player 2.x interprète mieux le champ « vitesse » du noeud NavigationInfo que les versions antérieures à 2.0. Cela rend Cosmo Player davantage conforme aux spécifications et permet aux créateurs de définir de manière fiable la vitesse de navigation appropriée d'un monde (puisque le navigateur respecte désormais la vitesse définie).

    Plus particulièrement, dans l'afficheur WALK (c.-à-d. celui du mode Déplacement), la navigation avec les touches de direction déplace désormais la caméra exactement à la vitesse spécifiée dans le noeud NavigationInfo actuel. La navigation à l'aide de la souris offre plus de souplesse, mais, la vitesse maximum par défaut ne sera environ égale qu'à trois fois la vitesse spécifiée. (Naturellement, l'utilisateur peut toujours modifier manuellement la vitesse de navigation dans les Préférences.)

    Les créateurs doivent plus particulièrement tenir compte du fait que la valeur par défaut de la « vitesse » (selon les spécifications VRML97) est égale à 1 m/s, ce qui correspond à une allure de marche « très » lente dans la réalité. (En d'autres termes, si vous créez un monde VRML à l'échelle du monde réel, vous utiliserez probablement un noeud NavigationInfo pour lequel la valeur de la « vitesse » est comprise entre 3 et 5.)

• Couleurs spéculaires et émissives sur des objets texturés
  • Selon les spécifications VRML97, l'éclairage spéculaire et émissif ne devrait pas être affecté par les textures : les couleurs spéculaires et émissive de l'objet devraient briller et non simplement moduler les valeurs de texture. Cosmo Player 2.1 est conforme aux spécifications dans ce domaine ; cependant il existe une case à cocher (dans le panneau « Performances » des préférences) qui permet aux utilisateurs de désactiver cette fonction. Si cette préférence est désélectionnée, la performance de rendus peut être améliorée (uniquement sur certains systèmes) ; cela peut être également une solution utile pour les contenus non conformes aux spécifications (si des objets texturés apparaissent « effacés » parce que la couleur émissive du matériel sous-jacent est trop brillante.)

    Enfin, les transmetteurs de rendus OpenGL et D3D peuvent donner des résultats différents dans certains cas (avec certains formats de textures, sur des cartes graphiques particulières) lors du rendu de couleurs spéculaires et émissives sur des objets texturés. Pour plus d'informations, voir ci-dessus.

• Blocage lors de l'utilisation de createVrmlFromString() avec EXTERNPROTOs ou Scripts
  • Sur certains systèmes, Cosmo Player peut se bloquer lors de l'exécution de createVrmlFromString() à partir d'un noeud Script ou de l'interface EAI, si la chaîne introduite contient EXTERNPROTO ou un noeud Script avec un URL externe (comme une classe Java, qui devrait utiliser par exemple 'url "Foo.class"'. Les Scripts avec des URL intégrés comme "javascript: ...", peuvent cependant être utilisés sans problème à l'intérieur de createVrmlFromString().)

    Les détails : Cosmo Player peut se bloquer si des événements de l'interface utilisateur ou VRML se produisent pendant qu'il extrait une implémentation EXTERNPROTO ou un URL Script. Ce blocage est lié au navigateur et peut se produire avec Netscape et IE3, mais cela est moins probable avec IE4. La solution consiste à utiliser createVrmlFromURL() au lieu de createVrmlFromString() si possible ; sinon, n'utilisez pas createVrmlFromString() avec des EXTERNPROTO ou Script qui nécessitent une extraction de leurs URL.

Questions spécifiques aux navigateurs

• IE4 : URL locaux avec nom de chemin contenant des espaces

  • Certaines versions de IE4 comportent une bogue connue qui empêche Cosmo Player de charger un fichier VRML local si le nom de chemin au fichier .wrl contient des espaces. Il se peut que ce problème apparaissent avec Chomp car les fichiers locaux de Chomp sont installés sous \Program Files\CosmoSoftware\CosmoPlayer\examples (contenant un espace).

    Ce problème a été corrigé dans les versions 4.72.2106 ou ultérieures d'IE4. (Ce problème n'existe pas avec aucune version de Netscape.) Pour corriger cette bogue, il suffit de copier le ou les fichiers en question vers un chemin sans espace ou de configurer votre ordinateur comme un serveur Web et d'accéder aux fichiers via ce serveur Web au lieu d'utiliser le système de fichiers.

• IE4 : Paramètres du répertoire cache

  • Si vous utilisez IE 4.0, Cosmo Player utilise le répertoire pour tout le système « Fichiers Internet temporaires » comme cache. Cependant, IE4 n'utilise pas de lui-même par défaut ce répertoire ; il utilise un répertoire Windows système /Profiles/nom utilisateur.

    Pour obtenir de meilleurs résultats, veillez à définir votre répertoire cache dans le répertoire système de « Fichiers Internet temporaires » (soit \WINNT\Fichiers Internet temporaires ou \WINDOWS\Fichiers Internet temporaires) ; ce paramètre peut être défini dans la boîte de dialogue « Générales » de la page Options Internet d'IE. Cela garantit que toute action liée au cache qui est effectuée dans IE (comme vider le cache !) affectera également les fichiers mis en cache par Cosmo Player.

• IE : Appel d'un code Javascript sur une page HTML à partir de VRML

  • Dans Netscape, vous pouvez appeler un code Javascript sur une page HTML à partir d'une scène VRML intégrée sur la même page, par exemple en utilisant un URL comme "javascript:parent.function_name()" dans un noeud Anchor ou dans un appel Browser.loadURL(). Cela ne fonctionne pas dans IE.

• IE4 : Impossible de désinstaller (ou de réinstaller) Cosmo Player car « cp21_main.dll est utilisé »

  • Si vous essayez de désinstaller Cosmo Player 2.1 sur certains systèmes qui exécutent Internet Explorer 4.x (via l'option « Ajout/Suppression de programmes » du Panneau de configuration) vous pouvez obtenir une erreur du type « cp21_main.dll est utilisé » même si vous avez déjà quitté IE. Bien que toutes les fenêtres de IE soient fermées, cela n'équivaut pas vraiment à quitter IE ; un processus est toujours exécuté (qui maintient la DLL de Cosmo Player ouverte) tant que vous restez connecté ! Ce problème peut aussi se produire lorsque Cosmo Player 2.1 est installé par dessus une ancienne version de Cosmo Player.

    La solution consiste à se déconnecter, puis à se reconnecter (ou redémarrer l'ordinateur), puis à désinstaller immédiatement Cosmo Player.

• IE4 : Problèmes avec la console Java

  • Il existe plusieurs problèmes connus avec la console Java d'IE4 (que vous pouvez afficher à l'aide de « Afficher » -> « Console Java » après avoir sélectionné l'option « Console Java activée » dans les préférences Avancées) :

    • Le démarrage de la console Java et la gestion forcée d'objets dans le ramasse-miettes (en tapant « g ») peuvent causer des comportements inhabituels ou des blocages dans les mondes qui utilisent JSAI (le ramasse-miettes est trop agressif).
    • L'utilisation de System.out.println() lorsque la console Java est visible provoque souvent des exceptions à partir de cet appel.
    Il est fortement recommandé de ne pas activer la console Java IE si cela n'est pas absolument nécessaire. (Il n'existe pas de problème connu avec la console Java sous Netscape 3.x ou 4.x.)
• IE4 : Impossible d'ouvrir de nouvelles fenêtre de navigateur

  • Certaines installations d'Internet Explorer 4.0 ou 4.01 peuvent conduire à un état instable dans lequel le navigateur ne peut pas ouvrir de nouvelles fenêtres (lorsque vous cliquez sur un lien qui tente d'ouvrir une nouvelle fenêtre ou si vous cliquez avec le bouton droit de la souris sur un lien quelconque et sélectionnez « Ouvrir dans une nouvelle fenêtre ».) Ce problème d'IE est connu ; un article du site de support technique de Microsoft contient des informations et une correction du problème. (Bien que cet article ne mentionne que le problème survenant sous Win95, nous l'avons également rencontré sous NT.)

    La correction de Microsoft (d'après l'article du site de support ci-dessus) semble fonctionner sur la plupart des systèmes. Cependant, si cela n'est pas le cas, procédez comme suit pour remédier au problème :

    1. Exécutez regedit
    2. Vérifiez que la clé de la base de registres :
          HKEY_CLASSES_ROOT\CLSID\{00020424-0000-0000-C000-000000000046}\InprocServer32
       existe. Dans le cas contraire, vous devez la créer.
    3. Assurez-vous que cette clé contient les deux valeurs suivantes :

       (Défaut)	=	"oleaut32.dll"
       "ThreadingModel"	=	"Les deux"

    Il n'est pas certain que cette bogue d'IE soit due à Cosmo Player ; ce problème ne se produit pas sur la plupart des systèmes avec Cosmo Player 2.0 ou 2.1 et a été remarqué sur des systèmes ou aucune version de Cosmo Player n'avait été installée. De plus, il se peut que la présence de certaines versions de Netscape détermine si cette bogue apparaît dans IE sur votre système.

• Netscape : Java se bloque avec Netscape 4.0x et un affichage Couleurs 24 bits sous Windows NT 4.0

  • Il s'agit d'un problème connu de Service Pack 3 pour Windows NT 4.0, qui a été déclenché par Netscape Communicator (4.0x) en présence d'un affichage Couleurs (24 bits). Si ce problème apparaît, notez qu'il n'est pas spécifique à Cosmo Player : Netscape est incapable de démarrer Java ! (Essayez d'afficher la console Java en sélectionnant " Communicator " -> " Console Java ". Si elle se bloque, il s'agit de la bogue Java/Couleurs (24 bits).)

    Pour plus d'information sur cette bogue, consultez le site de Netscape à http://help.netscape.com/kb/client/971009-22.htmlet une correction est disponible sur le site ftp de Microsoft (le fichier nécessaire est le fichier exécutable à installation automatique admnfixi.exe).

    Il existe également un problème similaire, spécifique à la carte graphique Matrox Millennium (lors de l'utilisation de pilotes obsolètes) ; pour plus d'informations, consultez le site de Netscape à http://help.netscape.com/kb/client/970805-1.html.

• L'installation de Netscape 4.05 interrompt Cosmo Player 2.1

  • Netscape Communicator 4.05 comprend Cosmo Player 2.0. Si vous tentez de l'installer sur un système qui contient déjà Cosmo Player 2.1, Cosmo Player 2.0 risque d'être installé de façon incomplète (entre autres problèmes, impossibilité d'afficher les textures).

    Pour éviter cela, veillez à réinstaller Cosmo Player 2.1 après avoir installé Netscape 4.05 sur votre système.

• Prise en charge de l'extension de fichier .wrl.gz

  • L'utilisation de l'extension .wrl.gz pour des fichiers VRML comprimés avec gzip est une fonction dépassée, qui ne sera pas prise en charge par les versions de Cosmo Player ultérieures à 2.1. (En d'autres termes, cette version de Cosmo Player prend en charge les mêmes extensions de fichier (y compris .wrl.gz) que Cosmo Player 2.0. Cependant, n'utilisez pas à l'avenir les noms de fichier .wrl.gz !)

    En effet, certains navigateurs HTML ne fonctionnent pas correctement lorsqu'un fichier comporte plusieurs extensions (comme "foo.wrl.gz"). Plus particulièrement, IE4.01 ne fournit aucun fichier .wrl.gz à Cosmo Player, même lorsque Cosmo Player extrait un fichier dans le noeud Inline ! (Ainsi, même dans Cosmo Player 2.1, les contenus qui utilisent des fichiers .wrl.gz seront incomplets dans IE 4.01).

    Tant que cela n'aura pas été clarifié par le consortium VRML dans des « Usages recommandés », il est conseillé aux créateurs de renommer les fichiers avec une extension ".wrl.gz" en ".wrl". L'extension ".wrz" est une solution acceptable, mais pas tout aussi correcte.

Configuration logicielle et matérielle

• OpenGL, Direct3D et cartes graphiques accélératrices

  Certaines cartes accélératrices peuvent être plus lentes et/ou fournir une qualité de rendu inférieure à celle du transmetteur de rendu logiciel de Cosmo Player. Pour plus d'informations, voir les remarques ci-dessus sur OpenGL et Direct3D.

• Mode d'affichage couleur 8 bits et cartes graphiques accélératrices
  • La plupart des constructeurs de cartes accélératrices recommandent de ne pas utiliser le mode d'affichage couleur 8 bits.  Compte tenu des problèmes de palette de couleurs inhérents à ces cartes et au système d'exploitation Windows, l'utilisation du mode d'affichage couleur 8 bits et des cartes accélératrices n'est pas totalement pris en charge.
     
• Audio

  • Sans Service Pack 3 ou une version ultérieure, vous ne disposez que d'un son « pseudo-spatialisé » sous Windows NT. Pour obtenir un son spatialisé, vous devez installer Service Pack 3 ou une version supérieure que vous pouvez vous procurer auprès de Microsoft.

  • Vous devez utiliser DirectX 3 ou une version ultérieure sous Windows 95 pour bénéficier de toutes les fonctionnalités audio.  Pour obtenir toutes les fonctionnalités audio, vous devez installer DirectX 3 ou un version ultérieure, disponible auprès de Microsoft.

  • Il peut arriver, lorsque plusieurs instances de Cosmo Player sont ouvertes, qu'une seule d'entre elles produise du son. Cela est dû aux fonctionnalités de Microsoft. Si vous ne disposez pas des pilotes natifs DirectSound pour les périphériques audio utilisés, Windows active un mode d'émulation qui utilise les fonctions WAVE. Deux applications ne peuvent pas avoir leur périphérique WAVE ouvert simultanément. Par conséquent, si votre périphérique audio n'est pas équipé des pilotes natifs DirectSound, vous ne pourrez obtenir du son que d'un seul dispositif à la fois. Notez que, sous NT4.0, DirectSound utilise toujours le mode d'émulation. Ainsi, si vous utilisez NT4.0, deux dispositifs ne pourront jamais produire du son simultanément. Ce problème devrait être corrigé avec NT5.0 car les constructeurs s'engagent à fournir les pilotes natifs DirectSound sous NT5.0.

  • Nous avons été informés de l'existence de problèmes avec MIDI sur certains systèmes ; par exemple, des sons MIDI dans des mondes VRML ne sont pas lus, ils entraînent un blocage du navigateur ou de Cosmo Player si vous essayez d'ouvrir un monde VRML pendant que d'autres sons MIDI sont lus (p. ex., un son MIDI sur une page Web différente, comme au lancement de « Chomp »). Ces problèmes sont en général dus à des bogues spécifiques aux cartes son ou aux pilotes MIDI ; essayez d'obtenir auprès de votre constructeur de cartes son ou de systèmes des nouvelles versions de vos pilotes audio à télécharger.

11. Suppport technique et notification des bogues

Pour nous signaler les bogues, utilisez le bouton « Commentaires sur Cosmo Player » de la page des Préférences « Avancées » ou le site Web de Cosmo Software.

Le site web de Cosmo Software contient également une rubrique FAQ (liste des questions fréquemment posées) où figurent des informations très utiles sur Cosmo Player. La rubrique FAQ figure sur la page Support technique de Cosmo Player.