Panotour Pro - Modèles

De Autopano.

Sommaire


Panotour utilise des modèles de fichiers xml ou HTML pour générer les visites virtuelles.


Les modèles permettent d'éditer un grand nombre de fonctionnalités qui ne sont pas (encore) éditables graphiquement dans Panotour Pro.
La plupart des modèles s'inspirent directement des scripts XML interprétés par krpano, dont l'accessibilité peut être difficile pour certains utilisateurs.


Une liste de modèles par défaut est définie dans le dossier des modèles. Plusieurs fonctionnalités de Panotour réutilisent cette liste.
Il peut être judicieux de développer ses propres modèles, par exemple, lors de création de visites en grand nombre nécessitant un ensemble de paramètres communs.


Les modèles sont accessibles par le menu Edition/Ouvrir le dossier des modèles/... La structure du dossier est la suivante :
Menu Ouvrir le dossier des modèles Structure du dossier des modèles


MODELES HTML

Les modèles HTML se trouvent dans le dossier html/.


Un modèle HTML est une page HTML et un dossier de ressources associées portant le même nom.
Tous les modèles proposés par défaut incluent une feuille de style default.css.
Il est possible d'écrire sa propre feuille de style et la placer dans le dossier des ressources du modèle concerné.


Les pages de modèles HTML peuvent contenir des mots clés qui seront remplacés à l'export. Ces mots clés sont :

  • $(PROJECTNAME) : le nom du projet.
  • $(SWF) : le nom du fichier swf généré.
  • $(FIRST_PANO_XML) : le fichier xml du premier panorama de la visite.


MODELES DE CONTROLES

Les modèles de contrôles se trouvent dans le dossier menu/.


Un modèle de contrôles est un fichier xml (format krpano). Ce code définit l'emplacement des éléments de contrôles.
Le code krpano de ces fichiers sera recopié dans la visite exportée, à l'exception de la balise <translation>.
La balise <translation> contient une description du modèle en différentes langues. C'est le texte qui apparaîtra dans Panotour lors du choix du modèle.


Le mot clé $(STYLEDIR) sera remplacé par le dossier contenant les ressources graphiques spécifié dans le modèle de thème.
Le mot clé $(HELPSCREEN) sera remplacé par le fichier d'image d'aide spécifié dans le modèle de thème.


MODELES DE BARRE DE PROGRESSION

Les modèles de barre de progression se trouvent dans le dossier progress/.


Un modèle de barre de progression est un fichier xml (format krpano).
Le code krpano de ces fichiers sera recopié dans la visite exportée, à l'exception de la balise <translation>.
La balise <translation> contient une description du modèle en différentes langues. C'est le texte qui apparaîtra dans Panotour lors du choix du modèle.


MODELES DE POLICES

Les modèles de polices se trouvent dans le dossier textstyle/.


Un modèle de police est un fichier xml (format krpano) définissant l'apparence du texte dans la visite.
Le code krpano de ces fichiers sera recopié dans la visite exportée, à l'exception de la balise <translation>.
La balise <translation> contient une description du modèle en différentes langues. C'est le texte qui apparaîtra dans Panotour lors du choix du modèle.


MODELES DE THEMES

Les modèles de thèmes se trouvent dans le dossier themes/.


Un modèle de thème est un fichier xml (format Panotour) définissant l'apparence de la visite.
Chaque thème créé fera réference à des ressources graphiques dans un dossier graphics/ relatif à themes/.
Les ressources existantes (par défaut) sont placées dans graphics/nom_du_theme/ pour plus de facilité d'organisation.


La structure d'un modèle de thème est la suivante :

<PTTheme name="***" 		directory="***" customColor="***" defaultcolor="***">
	
		<translation>
			<caption lang="***" text="***"	tip="***"/>
		</translation>

		<menus>
			<menu file="***" 		preview="***" 	colorize="***">
				<helpscreens>
					<helpscreen file="***" caption="***" lang="***"/>
				</helpscreens>
			</menu>
		</menus>

		
		<fonts>
			<font Size="***" Bold="***" Template="***" Name="***" Italic="***">
				<Color g="***" r="***" a="***" b="***"/>
			</font>
		</fonts>
		

		<hotspottypes>
			<hotspottype default="***"  nbfile="***"		file="***" >
				<translation>
					<caption lang="***" text="***"/>
				</translation>
			</hotspottype>
		</hotspottypes>
</PTTheme>


PTTheme

  • name : un nom pour le thème - pas utilisé
  • directory : le dossier où les ressources graphiques sont localisées. Remplacera $(STYLEDIR) dans les modèles de contrôle.
  • customColor: true ou false. Autorise (ou non) l'utilisateur du thème à changer la couleur du thème (utilisée pour colorier les ressources graphiques).
  • defaultcolor: une couleur au format web #RRGGBB. La couleur par défaut utilisée par le thème.


translation

Un texte descriptif du thème dans différentes langues. Chaque noeud <caption> est une description dans une langue.

  • lang : le code de langue.
  • text : le texte descriptif du thème qui apparaîtra dans le menu déroulant de choix de Panotour.
  • tip : un texte descriptif plus long qui s'affichera au survol de la souris sur le nom du thème dans Panotour.


menu

Détail d'un modèle de contrôles compatible avec ce thème. Il est possible de définir une liste d'images d'aide (<helpscreen>) pour un modèle de contrôle.

  • file : le fichier du modèle de contrôle.
  • preview : une image représentant le rendu du modèle de contrôle dans la visite.
  • colorize : la liste des plugins du modèle de contrôle qui peuvent être coloriés. Cette liste utilise le caractère ; comme séparateur. Le mot clé all permet d'autoriser le coloriage de tout les plugins du modèle de contrôle.


helpscreen

Pour un modèle de contrôle possédant un bouton informatif faisant apparaître une image d'aide, ce noeud spécifie l'image d'aide en question.

  • file : le fichier d'image d'aide. Remplacera le mot clé $(STYLEDIR) dans un modèle de contrôle.
  • caption : le texte apparaissant dans le menu déroulant de Panotour.
  • lang : la langue utilisée dans l'image d'aide.


font

  • Name : le nom de la police d'écriture.
  • Size : la taille de la police d'écriture
  • Bold : true ou false selon si la police doit être affichée en gras.
  • Italic : true ou false selon si la police doit être affichée en italique.
  • Template : un modèle utilisé par cette police d'écriture. Voir Modèles de polices.


hotspottype

  • file : la ressource graphique à utiliser. Si séquence d'images, remplacer l'indice d'image par %d. Les indices d'images commencent à 1 et suivent dans l'ordre.
  • default : ce champ est optionnel, il doit contenir "pano" pour que cette image soit l'image par défaut d'un hotspot point appartenant à un panorama ou "map" pour l'image par défaut d'un hotpsot appartenant à un plan.
  • nbfile (facultatif) : le nombre d'image utilisées pour ce hotspot.
  • refreshPeriod (facultatif) : l'intervalle de temps entre deux états de l'animation.
  • noeud fils translation : le texte affiché dans Panotour, selon la langue sélectionnée.


Il est possible de définir des séquences d'images pour animer un hotspot. Pour ce faire les images représentant les différents états de l'animation doivent être das un même dossier et avoir un même nom, à l'exception du numéro d'état (indice d'image) qui sera noté %d dans le champs file.

Exemple : 6 images (nommées image1.png, image2.png, image3.png...etc...) dans $(STYLEDIR)/monTheme/spotAnimé/, animées sur une durée de 1 seconde (1 sec / 6 images = 0.166) :

Le noeud <hotspottype> sera alors noté comme ceci : <hotspottype nbfile="6" file="monTheme/spotAnimé/image%d.png" refreshPeriod="0.166">


MODELES DE TRANSITIONS

Les modèles de transitions se trouvent dans le dossier transition/.


Un modèle de transition est un fichier xml (format krpano) définissant l'animation d'une transition entre deux panoramas dans la visite.
Le code krpano de ces fichiers sera recopié dans la visite exportée, à l'exception de la balise <translation>.
La balise <translation> contient une description du modèle en différentes langues. C'est le texte qui apparaîtra dans Panotour lors du choix du modèle.

Pour coder une transition, il est nécessaire de faire référence à certaines données éditées dans l'interface de Panotour :

  • la balise $(PANO) sera remplacée par le fichier XML du pano de destination.
  • les variables hcenter et vcenter représentent le centre du hotspot auquel est associé la transition
  • les variables hview, vview et fovview représentent la vue associée au hotspot
  • les variables panoview.h, panoview.v et panoview.fov représentent la vue associée au panorama








Support technique / Documentation Panotour Pro

Outils personnels
Autres langues