Hotspots

Les Hotspots peuvent être utilsés pour lier des points spécifiques de limage àdautres documents. On peut définir quatre manières différentes

1. Par défaut (pas de paramêtres ). Une zone carrée de 24x24 pixels (dans l'applet !) entourrant les coordonéées x/y du hotspot.
2. Rectangulaire (specifier a/b). Une zone rectangulaire (dans l'image panoramique !) limitée par x/y à gauche et a/b à droite.
3. Une forme arbitraire (specifier une image masque m pour chaque hotspot ) La zone blanche de l'image (dans le panoramique ).
4. Des formes arbitraires en spécifiant une image en niveaux de gris hsimage, une pour tous les hotspots de la même taille que le panorama.le niveau de gris du pixel indique le N° du otspot auquel il appartient. 255 (blanc ) signifie 'pas de hotspot'. Cette méthode est incompatible avec les trois précedentes.

• x - ou X . 0 est la gauche.soit en coordonnées absolues x (0...largeur), X - coordonnées relatives (0...100), les valeurs fractionnaires sont autorisées.
• y ou Y- the y -. 0 en haut . y - (0...hauteur), Y - coordonnées relatives(0...100),comme pour les x.
• n'nom' - le nom du hotspot affiché dans la ligne d'état sit la souris passe au dessus . doit être entouré par (').
• u'non' - l' URL du document lié . doit être entouré par ('). A la place d'une Url on peut mettre n'importe quelle commande ptviewer en utilisant le préfixe "ptviewer:".

• chexnumber - couleur-RGB-dur marqueur de hotspot par défaut. Specifier un nombre hewadécimal RRGGBB. rouge par défaut.
• i'nom' - nom de l'image à afficher lorsque le hotspot est activé. obligatoirement gif ou jpeg, et qui sera affiché centré sur la position du hotspot. Au lieu d'une image toute commande ptviewer peut être indiquée .Cette commande sera exécutée lorsque la souris survThis command will be executed when the mouse enterolera le hotspot
• . Exemple:

<PARAM name=hotspot6 value="  x776  y124  n'Lamp' i'ptviewer:PlaySound(0)' u'Controls.html'  ">

Ce hotspot joue le son n°0 lorsque la souris le survole. ce type de hotspot est toujours de type popup et ne répond pas à la commande showHS() .Si le parametre e est spécifié alors i indique une fenetre de texte (voir plus bas).
• t'nom' - nom de la cible dans le document html indiqué par l'option u.
• m'nom' - nom de l'image utilisée pour réaliser un hotspot par masquage . Créer une image les pixels blancs appatiennent au hotspot. Cette image sera localisée par rapport aux coordonnées x,y.
• p - spécifier p (sans parametres) rend cete image du hotspot popup lorsque la souris la suvole.
• q - Specifier q (sans parametres) rend ce hotspot toujours visible.
• w - Specifier w ( pour 'warped', sans parametres) provoque l'insertions de l'image dans le panorama au lieu de la fenetre de visualisation.L'image est fixée à l'arrière plan .
  ceci fonctionne pout tous les types de hotspot.
• e - Specifier e (pour texte, sans parametre) transforme le paramêtre image(i) et le fait interpréter comme un message texte. Ce message est afficher dans une fenetre rectan gulaire dont un des coins est le hotspott. Ce coin est undiquée par un point . La fenetre de texte est positionnée pour tenir dans le visualiseur. les sauts de ligne sont indiqués par '|'. le parametre c- indique la couleur du texte .
  Example:
<PARAM name=hotspot0 value=" x10 y20 n'myname' i'This is a | Textmessage' e ">
• a nombre or A nombre - coordonnées du coin droit d'un hotspot rectangulaire (voir x)
• b nombre or B nombre - coordonnées du coin droit d'un hotspot rectangulaire (voir y)

Les options peuvent être indiquées dans n'importe quel ordre. exemples :     <PARAM name=hotspot0    value=" x1141  y207 cff0000 n'Marburger Schloss'         u'pano.html'">
    <PARAM name=hotspot1    value="  x311  y265 c00ff00 n'Pfarrkirche'              u'http://www.fh-furtwangen.de/~dersch'" >
    <PARAM name=hotspot2    value="  x386  y506 c0000ff n'Stairs'                   u'pano.html' ">
    <PARAM name=hotspot3    value="  x209  y82  i'images/hs.gif' n'Sky'             u'pano.html' ">
    <PARAM name=hotspot4    value="  x393  y386 c00f0f0 n'Entrance'                 u'javascript:test()' "> 
    <PARAM name=hotspot5    value="  X50   Y50  cf0f0f0 n'Center'                   u'panos.jpg' "> 
    <PARAM name=hotspot6    value="  x776  y124  cf0f0f0 n'Lamp' m'images/lmask.gif' p i'images/popup.gif' u'pano.html'  ">

Les Hotspots peuvent être superposés. si un hotspot a les mêmes coordonnées qu'un autre hotspot, ils sont présumés identiques . Le masque du premier hotspot sera réutilisé.
Si le hotspot est activé les actions des différenst hotspots seront exécutées
   <PARAM name=hotspot6 value="  x776  y124   n'Lamp' m'images/lmask.gif'  i'ptviewer:PlaySound(0)'  u'Controls.html'  ">
 <PARAM name=hotspot8 value="  x776  y124 p  i'images/popup.gif'   ">  

Hotspots Statiques

Ce sont des zones dans l'applet assimilables à un image map en html.
La syntaxe est la même que pour les hotspots ordinaires mais toutes les coordonnées sont absolues par rapport à la fenêtre d'applet.
Les hotspots statiques utilisent le paramêtre 'shotspotNombre' dans les tag de l'applet.
Chaque hotspot statique est défini par 5 parametres principaux :

• xnombre  - coin gauche x .
• ynombre  - haut gauche y
• anombre  -coin droit x
• bnombre  -coin droit y
• u'nom' - URL du document lié . Doit être entouré avec deds quotes ('). A la place d'un Url on peut utilser toute commande ptviewer préfixée par "ptviewer:".

• t'nom' - cible html de l'option u.
• i'nom' - nom de l'image à afficher sir le hotspot est activé (gif or jpeg) , L'image n'est jamais affichée sans l'utilisation des paramêtres p ou q ou de du script DrawSHSImage() .
  A la place d'un Url on peut utilser toute commande ptviewer préfixée par "ptviewer:".Cette commande sera éxécutée au survol de la souris , ces commandes sont automatiquement de type popup
• p- Specifier p (sans paramêtres) rend l'image popup au survol de la souris.
• q- spécifier q (sans paramêtres) rend ce hotspot toujours visible.

 <PARAM name=shotspot0   value=" x236 y186 a250 b200 u'ptviewer:startAutoPan(0.5,0,1)' 
">  <PARAM name=shotspot1   value=" x250 y186 a264 b200 u'ptviewer:stopAutoPan()' 
">  <PARAM name=shotspot2   value=" x264 y186 a278 b200 u'ptviewer:startAutoPan(0,0,0.97)' 
">

Ici on montre l'utilisation de commandes ptviewer.

Ces Hotspots statiques peuvent être superposés ( voir les hotspots de panorama)

Previsualiser les Panoramas, Regions Intéressantes, Fonctions de Zoom

L'image panoramique utilisée dans l'applet peut être assemblée de manière dynamique pendant la visualisation. Ceci est réalisé par le tag 'roi' ( Region of interest).

Ce tag a trois paramêtres

• i'nom' - image à insérer (requis).
• x'nombre' - x du point d'insertion (coin haut gache de l'image). Defaut: 0
• y'nombre' - y du point d'insertion (coin haut gauche ). Defaut: 0.

<PARAM name=roi0  value=" 
i'myimage.jpg' x50 y80 ">

Le code suivant précharge une petite image de (600 * 300 pixels) et insere plus tard une image complète (1800 * 900 pixels) version.

<PARAM 
name=file  value="SmallPano.jpg">

<PARAM name=pwidth  
value="1800">

<PARAM name=pheight  value="900">

<PARAM name=roi0  value=" i'LargePano.jpg' ">

Par défaut toutes les images ROI sont chargées à l'initialisation. Ceci peut être désactive par le parametre loadAllRoi mis à "false". On peut alors charger des roi individuellement pttviewer:loadROI( int nombre) (ou l'équivalent javascript).

Si aucun fichier n'est indiqué , mais que la largeur du panorama est fournie ("pwidth"), alors ptviewer affiche une grille avec des lignes horizontales et veticaleds séparées par 10°.Cette grille peut être ensuite progressivement être emplie par des images roi Les couleurs de la grille et du fond sont paramétrables avec "grid_bgcolor" and "grid_fgcolor". Par défaut noir et blanc.

Les niveaux de zoom élevés sont mieux implémentés avec l'extension Ptzoom

Son et autres médias

Les fichiers son , aiff, wav and midi sont acceptés re supported in PTViewer 1.2. ils sont appelés par les parametres sound0, sound1, sound2, etc. Specifier le nom du fichier son. Ils peuvent être joués avec la commande ptviewer 'PlaySound(n)' .

D'autres médias sont utilisables mais il faut que la machine hôte ait le JMF installé (Java media framework) .On peut alors utiliser des vidéos avi , quicktime ,flash 2,  mpeg1/2/3, et la plupart des formats de son.L'extension Ptmedia permet de charger les medias jmf.

Controles Configurables

Toutes les commandes peuvent être appelées depuis l'applet sans code javascript. Le navigateur web n'est pas indispensable et les promenades virtuelles peuvent être visualisées uniquement avec l'applet
 

• ZoomIn()  Zoom de 3%
• ZoomOut()  Zoom de -3%
• panLeft()  Pan 5° vers la gauche
• panRight() Pan 5° vers la droite right
• panUp() Pan 5° vers le haut
• panDown() Pan 5° vers le bas
• gotoView(panangle, tiltangle, field-of-view) saute à une jumposition définie par les trois angles (degrés)
• showHS(); montre les Hotspots
• hideHS(); cache les hotspotsh
• toggleHS(); cache les Hotspots affichés et montre les autres
  StartAutoPan( pan_inc,  tilt_inc, zoom ) fait tourner le panorama . à chaque mouvement les paramêtres sont incrémentés de pan_inc, tilt_inc, et zoom.
• stopAutoPan() Stops autopanning.
• newPanoFromList( nombre ); Charge le panorama nombre dans l'applet.Ce panoramma doit avoir été précédemment défini en utilisant le Tag Pano Nombre .
• newPanoFromList( nombre , panangle, tiltangle, field-of-view) Même chose que le précédent sauf que l'on change les paramêtres de visualisation.
• newPano( String ); Charge le nouveau panorama spécifié par string. La syntaxe pour string est identique à celle de la liste des panoramas.
• moveFromTo( start-panangle, stop-panangle, start-tilt, stop-tilt, start-field-of-view, stop-field-of-view, number -of-frames ) effectue un voyage entre les deux positions spécifiées avec le nombre d'images spécifiées par number of frames
• moveTo( top-panangle, stop-tilt, stop-field-of-view, number -of-frames ) Se déplace du point actuel au point spécifié (comme ci-dessus)
• PlaySound( nombre ); joue le son nombre.
• DrawSHSImage(  nombre );  affiche une image de hotspot statique
• HideSHSImage(  num ); cache une image de hotspot statique.
• ToggleSHSImage(  num );  Permutte la visibilié des images de hotspots statiques.
• DrawHSImage(  num ); Affiche une image de Hotspot
• HideHSImage(  num ); Cache une image de Hotspot
• ToggleHSImage(  num ); Permutte la visibilié des images de hotspots
• ShowCompass(); montre l'image de compas
• HideCompass(); Cache l'image de compas
• waitWhilePanning(); attends pour autopanning, moveTo() or moveFromTo() jusqu'à la fin de l'exécution.
• startApplet( nombre); initialise et démarre l'applet nombred'aprés la liste des applets
• stopApplet( nombre ); stoppe et détruit l'applet nombre
• loadROI( nombre); Charge et insere l'image ROI.
• loadROI( num1, num2); idem mais de num1 to num2 d'aprés la liste des images RPO.
• setQuality( num); positionne la qualité à 0,1,2, or 3.

certaines fonctions demandent des arguments qui doivent être passés comme des constantes.

startAutoPan(2,3,1.2) est permis , pas startAutoPan(1+0.5, tilt, zoom*1.05).

Scripts

PTViewer peut être commandé par des scripts dans le doc html

Plusieurs fonctions sont utilisables e plus de celles qui précèdent

• isVisibleHS() renvoie si les hotspots sont visibles
• pan() renvoie l'angle courant
• tilt() retourne tilt angle (double)
• fov() retourne field-of-view (double)
• getAutoPan() retourne autopanning.
• get_x() returns the mouse coordinate of the last click (mouse-up event)
• get_y() returns the mouse coordinate of the last click (mouse-up event)
• getPanoNumber()  returns the list number of the current panorama
• getAppletInfo() returns a string with the copyright message and version

Charger de nouveaux panoramas depuis les applets en cours d'execution

Ceci peut se faire en utilisant newPano() ou newPanoFromList() functions.
La fonction newPanoFromList() demande la définition préalable d'une liste de panoramas, alors que la fonction newPano() fournit toutes les définitions dans un argument chaine (string).

Les deux fonctions peuvent être utilisées depuis les controles internes utilisant le URL-tag 'ptviewer:newPanoFromList(numéro)', dans les hotspots des deux types ou en utilisant javascript depuis le navigateur . Tous les paramêtres sont réinitialisés à l'exception des paramêtres de visualisation (width/height/offset).Tous les hotspots , frame, wait image et sons peuvent être redéfinis.
 
 

Appel des functions Javascript depuis PTViewer

PTViewer peut appeler des fonctions définies par l'utilisateur. pour cela le parametre mayscript doit être défini comme dans l'exemple suivant.
 

<APPLET  name="ptviewer" archive=ptviewer.jar  
code=ptviewer.class width=320 height=200 mayscript=true>

• le lier aux hotspots avec le u-tag voir les exemples ci-dessous.
• Specifier le parametre mousehs . Ceci devrait être une code javascript function, qui serait appelé avec le numéro du hotspot courant ou -1 si aucun n'est actif. La syntaxe pourrait être mousehs(int nombre). voir exemples .
• Specifier le parametre getview .Ceci peut être utilisé pour créer un compas , une carte , un son directionnel ect. syntaxe getview(double pan, double tilt, double field-of-view). Pour des raisons de performance , ceci est désactivé pendant les déplacements
  Specifier seulement le nom de la focntion sans paramêtres, parentheses

Grandes Images

Certains navigateurs ont une taille limite pour les tableaux linéaires , même si la mémoire est disponible . ceci limite la taille maxi des images que l'applet peut gèrer

PTViewer peut lire de bien plus grandes images en les découpant en interne en chunks. La taille de ces morceaux peut être définir par le parametre 'maxarray' . valeur par défaut #80000 hexadecimal, soit environ 500000pixels, (4byte = 1pixel). Mais ceci ralentit le téléchargement des images par (Internet Explorer) .Les valeurs par défaut fonctionnent avec tous les navigateurs.

Création de fichiers compactés pour tous les fichiers nécessaires à une scène

images, son, textes peuvent être empaquetés dans une seule archive en utilisant l'outils d'archivage .
 

Placer tous les fichiers dans le même répertoire sans sous-répertoires , y ajouter ptviewer.class file (pas le fichier ptviewer.jar ) . Charger le fichier htmldans un navigateur pour vérifier la configuration .

en ligne de commande : jar c0f ptviewer.jar ptviewer.class file1 file2 file3 file4 file5 file1, file2, etc Au lieux de ptviewer.jar, on peut choisir tous nom avec extension .jar. Juste vérifier le tag dans le paramêtee 'codebase' de la page html.

Aide à la création

• Presser 'v' affiche les paramêtres pan, tilt et field-of-view .
• Presser 'h' et clic souris affiche les coordinnées X/Y dans l'image image panoramique .utilise pour définir les hotspots . Les valeurs sont en coordonnées relatives ( 0..100) et doivent être utilisées avec les X et Y (majuscule) .
• Presser 'i' affiche un copyright .
• Presser 'u' affiche l'URL du document HTML.
• Presser 'p' affiche le chemin vers le document HTML.