Abonné au sujet
Vivement la suite
Dreambox

Bonjour à tous,

très intéressé aussi. Merci.

Tonio.

Waow, génial ! Merci....maintenant va falloir potasser tout cela....

Hello, les amis

Je rappelle que ce topic est dédié à l'information par sessions progressives pour ceux et celles qui voudraient s'informer sur la procédure d'installation délocalisée des addons en lien add-on.xml et total AddonPackages..

De plus dans mon esprit elle doit pouvoir s'adresser aux utilisateurs novices comme on l'a tous été et qui voudraient bien comprendre au moins de quoi on parle.

C'est un sujet pas si complexe que ça mais qui demande un peu d'attention.
Aussi  pour être efficace je  préfère ne  pas assurer d'assistance technique permanente ici,  même si cela  a un lien avec…. le lien xml.

Merci de votre compréhension et ceux qui ont un problème technique personnel je conseille tout simplement d'ouvrir un topic perso sur ce problème spécifique ici en T & O.

Par contre il est évident qu'ici, sur ce sujet , les questions sont les bienvenues tout au long des
sessions même si je n'ai pas forcément toutes les réponses.

Je profite donc  ainsi pour  continuer à partager ces informations:

Un peu d'historique pas trop long, je vous rassure, ensuite je poursuivrai sur la session 2.

Pourquoi avoir choisi la méthode par lien xml?
Parce que je ne l'ai pas choisie, et qu'elle s'est imposée petit à petit.

Cela s'est passé en 3 temps :

1-La découverte du procédé  lien xml qui permet d'établir simplement un lien avec l'addon   
    délocalisé mais au début c'était pratiquement à la main qu'il  fallait créer ces liens.

2- Ensuite est arrivé l'utilitaire  qui fabriquait ces liens automatiquement, pratique mais il fallait en             
    débiter un sacré… paquet d'addon.xml

3-Finalement  en me renseignant sur le support AVSIM/Lorby P4AO j'étais surpris
   de voir les  conseils  du support Lorby qui répétait souvent  "Mais pourquoi vous ne déclarez pas 
    tous ces composants dans un seul add-on.xml?"

    Et la plupart des utilisateurs semblaient penser comme moi
    "Au démarrage de P3DV4c'est sûr : il va se planter comme FSX !
     
    eh ben non il ne se plantait pas… à condition d'avoir rien oublié à déclarer comme à la douane. 



D'abord je rassure les inquiets, sachez que l'essai de la méthode lien xml  peut se pratiquer sur un installation fonctionnant sous scenery.cfg le principal étant de ne pas mélanger les genres.
Si vous avez commencé à examiner le manuel vous avez pu voir  des commandes de transfert entre ces 2 mondes qui sont bien présentes dans P4AO. Le tout est qu'ils ne travaillent pas  en même temps sur un même addon.


Session 2***********************************************************************Session2
Objectifs pédagogiques:
1- Comprendre le principe de création d'un add-on.xml
2- Comprendre le principe de déclaration d'un [Addon scenery] complet
3- Arriver à appliquer 1 et 2 dans P4AO.

Ce soir je finalise le point 1- et les jours suivants  les 2 autres points de la session.
En fin de session 2 comme promis une fiche de synthèse sera éditée.


Bref assez de blabla et rentrons dans le vif du sujet avec la session 2.

A.    Pourquoi utiliser le language xml ?
           
Cette définition simple résume bien son fonctionnement ( Source_Wikipedia )   :

"XML se présente en général comme un texte, séparant deux niveaux :
du texte à destination des humains, et des balises à destination des machines".

Effectivement quand vous éditerez en mode texte un de vos fichiers add-on.xml vous verrez une partie du texte lisible, et une autre partie présentant les balises encadrées de chevrons  < >

Ici à quoi nous sert un add-on.xml?
En informatique en général une grosse partie des "plantages" sont provoqués par des problèmes de "path" (chemin). La machine fonctionne parfaitement mais elle a perdu l'adresse du fichier.

Dans notre  add-on.xml  la plupart de ses lignes de code  correspondent à des balisages de chemin d'accès à l'addon et ses composants installés. L'addon.xml est introuvable ou ses balises sont erronées?  Alors P3D ne pourra pas charger l'addon.

B.    Création d'un fichier add-on.xml:

Un fichier add-on.xml est un fichier qui sera nommé par vous ou par un setup.exe.
Cela paraît simple mais vous verrez au début que vous aurez tendance à l'oublier et à confondre le nom de l'add-on.xml avec le titre de la scène ou du composant que vous installez, donc gardez bien ce principe en mémoire.

Le fichier lui-même n'est donc  pas "nommé" du titre de la scène installée, ce qui veut dire par exemple pour une scène Lambda son fichier add-on.xml ne sera pas  transformé en Lambda.xml.

Ce qui va se passer c'est que l'on va créer pour cette scène Lambda un fichier qui s'appellera toujours   add-on.xmldans lequel on va inscrire toutes les déclarations concernant cette scène puis on va le placer quelque part dans un dossier qui, lui, sera  nommé par exemple
[ Lambda_Scenery].
P3DV4 sait parfaitement où se trouve ce quelque part .

Félicitations vous venez de créez votre premier add-on.xml pour la Scène Lambda.
Comment est nommé cet add-on.xml et bien il est déjà  baptisé  "Lambda_Scenery puisque c'est toujours le  nom du dossier qui contient son unique add-on.xml.
Ne vous amusez pas à modifier le nom du dossier car P4AO ne sera pas content et
vous le fera savoir.

Donc quand vous aurez installé vos tonnes de scènes délocalisées vous aurez quelque part  un répertoire qui contiendra  des tonnes de dossiers avec un nom différent et qui tous contiennent un fichier de même nom ……add-on.xml mais probablement pas de même poids.


C.    Un fichier add-on.xml pour plusieurs scènes

Allons jusqu'au bout du raisonnement :
Nous sommes fiers d'avoir créer des centaines  de fichiers add-on.xml ce qui fait un répertoire
imposant en nombre de dossiers qu'il contient.

Et quand vous regardez  ces dossiers vous vous dites qu'il y a beaucoup de scènes provenant d'un même gros éditeur d'addons que nous appellerons BigBoss .

Mais il  semble  imposssible des les regrouper car Windows ne serait pas d'accord  et P4AO n'aime pas du tout qu'on touche a ses créations.
A moins que ?..... j'ai bien plusieurs dossiers qui contiennent chacun 1 fichier add-on.xml qui doit déclarer sous un même encodage ou langage si vous préférez, la même chose que BigBoss leur a dit de déclarer. On peut peut-être écrire tout dans 1 seul add-on.xml?


Felicitations,vous allez créer votre premier add-on.xml méthode Package que vous baptiserez par exemple   "BigBoss_Sceneries"


D.    Récapitulatif
Disons que nous avions pour simplifier  3 scènes de Bigboss mais il aurait pu en avoir des centaines.







3 add-on.xml fusionnés en 1 seul c'est le principe de l'AddonPackage

Le nom de l'add-on.xml final est celui d'un éditeur de scènes.

Prochain objectif session 2:

2- Comprendre le principe de déclaration d'un [Addon scenery] complet


@ +

Dernière modification par Recciosilva (01-05-2020 12:21:20)

Reprise session 2 :
La procédure qui va être  appliquée ci-après par défaut est celle de l'addon.xml par éditeur d'addon, à chaque fois que c'est possible.

Mais puisqu'il existe des addons sans éditeur, les freeware par exemple,  il est évident que ce type d'addon.xml sera nommé généralement du nom de sa scène.
On verra ainsi que les 2 procédés cohabitent sans problème. C'est simplement le nom de l'addon.xml qui concernera dans un cas un paquet [d'Addons sceneries] et dans l'autre un seul [Addon scenery].

Maintenant il faut bien comprendre que dans la fenêtre fonction Scenery de P4AO ce sont bien les titres des scènes qui apparaissent donc aucun problème pour gérer:
Leur classement hiérarchique ou  les regrouper  suivant vos désirs dans la fenêtre fonction Groupes de P4AO.

On évitera donc de créer un addon.xml unique pour chaque addon séparé d'un même éditeur car chaque éditeur installe ses produits de la même manière avec sa scenery principale et ses propres composants (components en anglais) et c'est une chance qu'il ne faut pas laisser passer.

A- Déclaration standard de l'addon scenery en addon.xml :

La déclaration en addon.xml d'un addon installé suivra toujours le même processus :
Déclarer un [Addon scenery] sous 1 seul addon.xml qui intègrera les 2 parties qui constituent cet  [Addon scenery] :

1-Le groupe  principal qu'on peut qualifier de Groupe SCENERY
2-Le groupe secondaire qu'on peut qualifier de Groupe  COMPONENTS (composants)

    1- Les éléments du groupe SCENERY:
   
•    La scène principale se présentant le plus souvent sous 1 répertoire    
         Titré du nom de la scène et contenant scenery + option texture .
•    Les Libraries
•    Le Land Class-Layer
•    Les Objects-Layer
•    Les Ground ou Terrain-Layer
•    Les Photos realistes -Layer
•    Des éléments généraux  tels que World, Global.
•    Du Mesh en supplément  isolé

   2-Les éléments du groupe COMPONENTS:

•    Autogen-Désigne un composant qui ajoute un répertoire autogène supplémentaire que
                Prepar3D peut utiliser pour gérer les fichiers d'autogen.
•    DLL - Désigne un composant qui charge une bibliothèque complémentaire
•    EXE - Désigne un composant qui charge une application complémentaire.
•    Effects - Désigne un composant qui ajoute un répertoire d'effets supplémentaires que
                 Prepar3D peut utiliser pour gérer les effets.
•    Fonts - Désigne un composant qui ajoute un répertoire de polices supplémentaires que       
                 Prepar3D peut utiliser pour gérer les polices.
•    Polices - Désigne un composant qui ajoute un répertoire de polices supplémentaires que
                  Prepar3D peut utiliser pour gérer les polices.
•    Gauges - Fait référence à un composant qui ajoute un répertoire de jauges
                  supplémentaires que Prepar3D peut utiliser pour gérer les jauges
•    Sound -  Désigne un composant qui ajoute un répertoire sonore supplémentaire que
                 Prepar3D peut utiliser pour gérer les fichiers sonores.
•    Scaleform - Désigne un composant qui ajoute un répertoire scaleform supplémentaire
                  que Prepar3D peut utiliser pour gérer les fichiers scaleform.
•    Scénarios - Désigne un composant qui ajoute un répertoire de scénarios supplémentaire   
                   à partir duquel l'utilisateur peut choisir de charger des scénarios.
•    Scenery - Désigne un composant qui ajoute une zone de décor supplémentaire au
                  monde de Prepar3D.
•    Scripts - Désigne un composant qui ajoute un répertoire de script supplémentaire que Prepar3D peut 
                    à utiliser pour résoudre les fichiers de script (.lua).
•    ShadersHLSL - Désigne un composant qui ajoute un répertoire supplémentaire de             
                    shaders et de HLSL que Prepar3D peut utiliser pour les fichiers shaders et HLSL
•    SimObjects - Désigne un composant qui ajoute un répertoire supplémentaire de
                     simobjects dans lequel l'utilisateur peut choisir de charger des simobjects
•    Texture - Désigne un composant qui ajoute un répertoire de textures supplémentaire que   
                   Prepar3D peut utiliser pour gérer les textures
•    Weather - Désigne un composant qui ajoute un répertoire météo supplémentaire que       
                  Prepar3D peut utiliser pour gérer les fichiers météo

B- Déclaration séparées des Groupes SCENERY et COMPONENTS

1- Les éléments du groupe SCENERY:
   
Tous les éléments du Groupe SCENERY seront déclarés dans la fenêtre fonction [Scenery] de P4AO.

Une exception toutefois certains répertoires [texture] en position différente du répertoire [texture] standard présent avec [scenery] dans la scène principale.

Cette exception sera déclarée dans la fenêtre fonction [Other addons]  de P4AO en tant que [component #xx]   category    [Texture].

2- Les éléments du groupe COMPONENTS:

Tous les éléments du Groupe COMPONENTS seront déclarées dans la fenêtre fonction [Other addons] de P4AO et suivant la [category] à laquelle ils appartiennent.

Il est conseillé de ne pas nommer ces [components] qui appaîtront alors sous la forme [component # xx :] xx  étant un numéro attribué à l'entregistrement.


2- Récapitulatif des  groupe SCENERY & COMPONENTS déclarés:

1- Pour un addon scenery complet déclarer en premier tous les éléments de son groupeSCENERY puis ceux du Groupe COMPONENTS.
       2-Terminer ensuite par le classement hiérarchique des scènes du  Groupes SCENERY
           Ce classement de priorité des Layers fera l'objet d'une session spécifique.

Fin de la session 2 
Fiche synthèse AD-AP n° 01 disponible :
[Fiche Synthèse AD-AP n°01]

Fin session2 **************************************************************************************************

Dernière modification par Recciosilva (21-04-2020 10:51:25)

Bonjour,

Après toutes ces lignes d'explications (plus de 300) je suis très surpris de ne pas avoir vu le contenu d'un fichier add-on.xml.

J'ai juste posé une question, tu y as répondu

Je n'ai pas d'opinion à formuler (je connais le xml), attendons les réponses des autres lecteurs pour voir si le but est atteint.

J'ai fais une simple remarque et il n'y a aucun sous-entendu - fin de mon intervention -

Yeap, moi je suis d'accord avec toi @Navalncis.

Nassara a écrit:

Une suite, pas de suite ??

Rassurez-vous les ami(e)s le Condor bleu est de retour, la traversée entre les 2 rochers fût longue et difficile mais il est là n'en déplaise à certains.


Le manuel traduit & commenté de P4A0 version 1-50 :

P3D-Support-Manuel Lorby-P4AO-Traduit-FR

La 1ère fiche Synthèse des sessions 1 & 2 précédentes :

[Fiche Synthèse AD-AP n°01]

Dorénavant j'annoncerai simplement les objectifs pédagogiques suivants
suivis de l'édition de la fiche synthèse.

Donc entre 2 éditions les questions sont ouvertes et SVP uniquement et tranquillement  sur les phases en cours car si vous plongez tout de suite dans le hard du XML    vous allez vite abandonner.
D'autre part comme j'estime ne connaître qu'une petite partie du sujet, entraide et débat ne sont  pas interdits entre niveaux différents. Entraide c'est un mot important par les temps qui courent.

L'objectif suivant étant  naturellement la déclaration des add-on.xml par des exemples pratiques et toujours progressifs.
Le tout résumé par la fiche synthèse AD-AP n° 02.

@+ et SAH

Dernière modification par Recciosilva (20-04-2020 12:22:18)

Hello,

Fiche de synthèse AD-AP n° 02 en cours d'achèvement. Release en principe fin d' après-midi.

Le xml c'est comme le pot au feu, il faut le laisser mijoter sinon il reste sur l'estomac. 

@+ and SAH

Hello,

[Fiche synthèse AD-AP N° 02]

Et bonne lecture.

@+