Serge NOEL
342 lines
20 KiB
Plaintext
342 lines
20 KiB
Plaintext
<!DOCTYPE html>
|
|
<html lang="fr">
|
|
<head>
|
|
<!-- Copyright Bob Jacobsen 2008 -->
|
|
<!-- Updated by Blorec Hervé le 2016-09-11-->
|
|
<title>JMRI: Defining Your Own Signaling System</title>
|
|
<!--#include virtual="/help/fr/parts/Style.shtml" -->
|
|
</head>
|
|
|
|
<body>
|
|
<!--#include virtual="/help/fr/parts/Header_fr.shtml" -->
|
|
<div id="mBody">
|
|
<!--#include virtual="Sidebar.shtml" -->
|
|
<div id="mainContent">
|
|
<!-- Page Body -->
|
|
|
|
<h1>JMRI: Définition de Votre Propre Système de Signalisation</h1>
|
|
|
|
<p>Cette page décrit comment définir un nouveau système de signalisation
|
|
de JMRI.</p>
|
|
<p>Nous passons par la création à partir de zéro, mais
|
|
il est souvent plus facile de copier et de modifier l'un de ceux
|
|
existants, dans le répertoire
|
|
<a href="http://jmri.org/xml/signals">xml/signaux</a>.</p>
|
|
|
|
<h2>Création d'un Nouveau Système de Signalisation</h2>
|
|
|
|
Premièrement, vous avez besoin de créer manuellement un nouveau répertoire dans le
|
|
répertoire système de JMRI sous le "xml/signaux" ou dans le répertoire
|
|
preferences utilisateur "resources/signals" qui
|
|
détiendra votre nouvelle définition de signal.
|
|
Par convention, le nom de ce répertoire (par exemple "basic" ou
|
|
"AAR-1946") fournit le nom du système pour votre définition du signal.
|
|
Tous les Mâts de Signalisation que vous créez
|
|
utilisent votre nouvelle définition de système de signaux qui inclut le
|
|
nom système du système de signalisation dans leur propre nom système,
|
|
car c'est un inconvénient de changer le nom système du système de signaux.
|
|
Pensez à l'avance un petit peu: ce qu'il y aura de variable dans cette
|
|
définiton suivants les époques différentes ou de divisions différentes? Si
|
|
oui, inclure une année, ou l'emplacement dans le nom, pour rendre facile
|
|
la création des versions modifiées.
|
|
Note: ne pas utiliser les caractères spéciaux comme l'esperluette (&) ou les espaces dans les noms de fichiers et
|
|
de répertoires. JMRI s'exécute sur pleins d'ordinateurs, et les noms de fichiers avec espaces ou caractères spéciaux peuvent
|
|
provoquer des problèmes pour des personnes si jamais vous contribuez avec vos fichiers à la distribution JMRI.
|
|
<p>
|
|
Ensuite, fournir ces fichiers:
|
|
<ul>
|
|
<li> index.shtml - description de forme libre du système de signalisation
|
|
<li> aspects.xml - Définir l'ensemble des aspects disponibles
|
|
<li> apparence-*. xml - Un dossier pour chaque type de Mât de Signalisation, définissant
|
|
comment afficher chaque aspect. Jetez un œil à certains systèmes de signalisation existants pour
|
|
voir les conventions de dénominations typiques.
|
|
</ul>
|
|
|
|
<h3>Créez un nouveau fichier index.shtml</h3>
|
|
|
|
Ce fichier fournit seulement une description mais il est important de le faire en premier
|
|
de sorte que vous enregistrez les détails de ce que vous avez fait.
|
|
<p>
|
|
Si vous capturez un système réaliste,
|
|
enregistrez ce que vous savez à son sujet: compagnie ferroviaire, région/district, année,
|
|
où vous avez trouvé les information, etc.
|
|
<p>
|
|
Si vous faites votre propre système, décrivez le en quelques
|
|
détails de sorte que vous pourrez y revenir plus tard et
|
|
vous rappelez de ce que vous aviez à l'esprit.
|
|
|
|
<h3>Créer un nouveau fichier aspects.xml</h3>
|
|
|
|
L'élément <code><name></code> dans la partie supérieure de ce fichier fournit le nom utilisateur pour votre
|
|
système de signalisation, qui figure en bonne place dans l'interface utilisateur.
|
|
Il peut être un peu plus prolixe que le nom du répertoire, mais devrait
|
|
être assez semblable pour que l'utilisateur puisse les associer en cas de besoin.
|
|
|
|
<p>
|
|
Cet élément <code><aspects></code> dans ce fichier
|
|
listes <EM>tous</em> les aspects qui peuvent apparaître dans
|
|
ce système de signalisation. ( La plupart des Chemins de fer modèles représente un seul modèle de
|
|
chemin de fer, il n'y a donc qu'un seul système présent, mais il est possible
|
|
d'en utiliser plus ). Vous pouvez revenir et ajouter plus tard
|
|
si nécessaire, mais il est préférable de tout saisir au début
|
|
parce que les noms seront plus cohérents, etc
|
|
|
|
<p>
|
|
La plupart des fichiers sont des blocs qui ressemblent à ceci:
|
|
<pre>
|
|
<aspect>
|
|
<name></name>
|
|
<title></title>
|
|
<indication></indication>
|
|
<description></description>
|
|
<reference></reference>
|
|
<comment></comment>
|
|
<imagelink></imagelink>
|
|
<speed></speed>
|
|
<speed2></speed2>
|
|
<route></route>
|
|
<dccAspect></dccAspect>
|
|
</aspect>
|
|
</pre>
|
|
|
|
Vous devez remplir l'élément <code><name></code>, Les autres sont facultatifs, mais l'ordre de tous les éléments est obligatoire pour passer avec succès la validation XML.
|
|
Les éléments <code><title></code> et <code><indication></code> ne peuvent être inclus qu'une fois.
|
|
Les éléments <code><description></code>, <code><reference></code> et <code><comment></code> peuvent être inclus
|
|
autant de fois que vous le souhaitez.
|
|
<p>
|
|
L'élément<code><imagelink></code>, s'il est présent, doit pointer
|
|
un fichier image (. gif,. png ou. jpg) montrant ce à quoi la famille des
|
|
Apparences ressemble. Si vous fournissez des images individuelles
|
|
dans les <a href="#appearances">fichiers apparence </a>, elles vont également être affichées
|
|
ici. Les Images individuelles sont une meilleure solution, mais c'est aussi
|
|
plus de travail.
|
|
<p>
|
|
L'élément <code><speed></code>, s'il est présent, doit être soit une valeur numérique ou une chaîne
|
|
valeur qui a été défini dans le fichier signalSpeeds.xml. L'élément <code><speed></code> se
|
|
rapporte à la vitesse maximale à laquelle un train peut passer à l'aspect. La Logique Mât de Signalisation
|
|
utilise cette vitesse pour aider à déterminer quel aspect doit être affiché où il
|
|
y a de multiples aspects possibles.
|
|
Un élément facultatif <code><speed2></code> contient la vitesse ( valeur ) que le train doit - ou peut - atteindre en
|
|
arrivant au prochain signal. Pour un aspect Libre, elle sera identique à <code><speed></code> mais en aspect Approche Déviée, elle sera généralement moins.<br>
|
|
Les deux entrées de vitesse se réfèrent au bloc protégé comme il était quand le train est arrivé
|
|
au signal, Parce que naturellement il aura changé pour "stop" une fois le train entré
|
|
dans le canton suivant ( plus sur les vitesses <a
|
|
href="https://sourceforge.net/p/jmri/mailman/jmri-developers/?viewmonth=201106&viewday=22">dans la liste
|
|
des developpeurs JMRI</a>).
|
|
<p>
|
|
L'élément <code><route></code>, s'il est présent, devrait être entré simplement comme "Dévié", "Droit"
|
|
ou "Autre". Si l'élément est omis ou laissé vide alors il est pris comme étant "Droit".
|
|
L'élément <code><route></code> indique que cet Aspect spécifique est utilisé quand un
|
|
aiguillage a été dévié dans le chemin à parcourir. La Logique Mât de Signalisation utilise cet élément
|
|
pour aider à déterminer quel aspect doit être affiché là où il y a plusieurs
|
|
Aspects possibles.
|
|
<p>
|
|
L'élément <code><dccAspect></code>, s'il est présent, est l'Identifiant du décodeur DCC accessoire signal par défaut pour cet aspect,
|
|
Ces valeurs sont ensuite utilisées pour remplir les identifiants d'aspect quand un pilote de signal DCC ou LNCP est utilisé.
|
|
Les valeurs peuvent être écrasées par l'utilisateur lors de la création ou de la modification du Mât de Signalisation particulier.
|
|
<p>
|
|
L'élément <code><delay></code> s'il est présent, permet à une temporisation d'être configurée entre
|
|
l'évolution de l'aspect sur chaque tête de signal où plusieurs têtes sont configurés sur un mât. <br>
|
|
Ceci est idéalement utilisé dans le prototype où un signal à commande manuelle (par exemple sémaphore)
|
|
devrait être configuré par le signaleur, donc seul la tête du signal (ou Bras) pourrait
|
|
être définie à n'importe quel moment.
|
|
<p>
|
|
Ci-dessous les blocs <code><aspect></code>, il y a un bloc qui nomme tous les fichiers d'apparence valide
|
|
, par exemple:
|
|
<pre>
|
|
<appearancefiles/>
|
|
<appearancefile href="appearance-SL-1-high-abs.xml"/>
|
|
<appearancefile href="appearance-SL-1-high-pbs.xml"/>
|
|
<appearancefile href="appearance-SL-1-low.xml"/>
|
|
</appearancefiles>
|
|
</pre>
|
|
|
|
Créer cette partie quand vous créez les fichiers apparence (voir ci-dessous),
|
|
pour que le programme puisse localiser chacun d'eux et les afficher pour l'utilisateur.
|
|
|
|
<a name="appearances"></a><h3>Créer les fichiers apparence-*. xml </h3>
|
|
|
|
Pour chaque sorte de signal sur le réseau (un feu,
|
|
deux feux, nain, sémaphore, etc), vous avez besoin de
|
|
créer un fichier apparence dédié.
|
|
|
|
<p>
|
|
Jetez un œil à certains systèmes de signalisation existants pour
|
|
voir les conventions typiques de dénomination.
|
|
Note: ne pas utiliser les caractères spéciaux comme l'esperluette (&) ou les espaces dans les noms de fichiers et
|
|
de répertoires. JMRI s'exécute sur pleins d'ordinateurs, et les noms de fichiers avec espaces ou caractères spéciaux peuvent
|
|
provoquer des problèmes pour des personnes si jamais vous contribuez avec vos fichiers pour la distribution JMRI .
|
|
|
|
<p>
|
|
Le haut du fichier est un certain texte standard que vous pouvez
|
|
copier depuis un système existant, puis modifier avec votre
|
|
information d'historique de révision et d'auteur.
|
|
|
|
<p>
|
|
La valeur de l'élément <code><aspecttable></code> devrait être le nom utilisateur pour
|
|
le système global, comme défini dans l'élément <code><name></code> du fichier aspects.xml.
|
|
|
|
<p>
|
|
L'élément <code><name></code> est le nom utilisateur pour ce type particulier de mât de signalisation.
|
|
Il devrait être assez descriptif du mât, et relater d'une certaine façon évidente
|
|
le nom du fichier.
|
|
Utilisez les éléments <code><reference></code> et <code><description></code> pour fournir des informations au
|
|
futurs utilisateurs de ce système de signaux. Vous pouvez voir comment ceci est affiché
|
|
dans un <a href="http://jmri.org/xml/signals/AAR-1946/appearance-SL-1-high-pbs.xml">fichier exemple</a>.
|
|
|
|
<p>
|
|
Ensuite il y a l'élément <code><appearances></code>, qui contient une série d'éléments de <code><appearance></code>
|
|
qui définissent comment apparaissent les divers Aspects sur ce type de mât de signalisation.
|
|
Chaque aspect ne doit pas être défini dans chaque fichier, car
|
|
chaque type de signal ne peut pas montrer tous les aspects.</p>
|
|
|
|
<p>
|
|
Chaque aspect que le signal peut montrer a besoin d'être
|
|
décrit avec un bloc comme ceci:
|
|
|
|
<pre>
|
|
<appearance>
|
|
<aspectname>Clear</aspectname>
|
|
<show>green</show>
|
|
<show>red</show>
|
|
<reference></reference>
|
|
<delay></delay>
|
|
<imagelink></imagelink>
|
|
</appearance>
|
|
</pre>
|
|
|
|
Le <code><aspectname></code> doit être au début, suivi par zéro ou plus
|
|
d'éléments <code><show></code>.
|
|
|
|
<p>
|
|
L'élément <code><show></code> sera utilisé pour définir les Feux de Signalisation, qui
|
|
composent le signal pour afficher correctement cet Aspect. Il peut y en avoir zéro ou plus
|
|
, contenant "red", "flash red", "yellow", "flash yellow", "green", "flash green", "lunar", "flash lunar" or "dark".
|
|
|
|
<p>
|
|
Vous pouvez avoir autant d'éléments <code><reference></code> que vous le souhaitez, ils sont
|
|
lisible par l'utilisateur pour la documentation.
|
|
|
|
<p>
|
|
L'élément imagelink, s'il est présent, doit pointer
|
|
un fichier image (. gif,. png ou. jpg) montrant ce à quoi ressemble cette apparence.<br>
|
|
Si vous créez ou utilisez des images personnalisées celles-ci doivent être placés dans un
|
|
sous-répertoire à l'intérieur de la zone de préférence utilisateur, le lien de l'image doit ensuite
|
|
être préfixé par "préférence:" suivi par le reste du chemin.
|
|
Tant que vous travaillez localement, utiliser préférence: ressources/chemins etc.
|
|
Si tous les aspects de votre nouvelle définition du signal travaillent sur votre panneau/réseau
|
|
et vous envisagez de présenter votre nouveau système de signalisation comme un patch pour JMRI,
|
|
utiliser les chemins d'URL complètes comme http://jmri.org/resources/icons/etc dans les fichiers XML
|
|
de sorte qu'ils vont travailler à la fois avec le programme JMRI local et pour les
|
|
personnes qui vont les consulté sur le site web JMRI.
|
|
|
|
<h4>Apparences Spécifiques</h4>
|
|
Il y a quatre apparences spécifiques auquelles JMRI doit et peut se référer, comme les noms d'apparence
|
|
sont tous définis par l'utilisateur et peut être dans n'importe quelle langue et Tous sont facultatifs et dépendent du Mât de Signalisation<br>
|
|
<b>danger</b> C'est l'aspect le plus restrictif que le mât du signal peut montrer.
|
|
Lorsque le chemin à parcourir n'est pas définie ou effacé la logique de mât de signalisation fixera le mât de signal à cette apparence. <br>
|
|
<b>permissive</b> (Call-On) cette apparence est affichée si le canton suivant est occupé,
|
|
mais qu'un autre train est autorisé à entrer. <br>
|
|
<b>held</b> fournit ( via l'élément imagelink ) une autre image sur le panneau pour indiquer que
|
|
la condition "held" a été maintenu à <br>
|
|
<b>Dark</b> est utilisé pour fournir une autre image sur le panneau pour indiquer que
|
|
le signal n'est pas allumé. <br>
|
|
Chaque aspect spécifique peut donnée une image alternative à une utilisation autre que celle donnée
|
|
dans la définition principale de l'apparence. <br>
|
|
Cette information peut être entrée après l'information d'apparence sous la forme suivante.
|
|
<pre>
|
|
<specificappearances>
|
|
<danger>
|
|
<aspect>Danger</aspect>
|
|
</danger>
|
|
<permissive>
|
|
<aspect>Off</aspect>
|
|
</permissive>
|
|
<held>
|
|
<aspect>Danger</aspect>
|
|
<imagelink>held.gif</imagelink<
|
|
</held>
|
|
<dark>
|
|
<aspect>Not Lit</aspect>
|
|
<imagelink>notlit.gif</imagelink<
|
|
</dark>
|
|
</specificappearances>
|
|
</pre>
|
|
Seul un aspect peut être défini pour chaque apparence spécifique.
|
|
Pour chaque aspect spécifique entré, l'entrée correspondante <code><aspect></code>
|
|
doit être un <code><aspectname></code> valide qui se produit dans les définitions d'apparence
|
|
pour le mât
|
|
|
|
<h4>Modélisation Aspect</h4>
|
|
La modélisation aspect est utilisé pour aider à déterminer la progression des Aspects de la signalisation.
|
|
Le but de la modélisation est de définir quelles Aspects potentiels sont valables selon
|
|
l'Aspect qui est affiché sur le mât de signalisation qui est devant nous.
|
|
Cette modélisation peut être un simple un à un, Ex. Mât de Signalisation avancé montre l'Approche, nous devrions montrer Libre.
|
|
Ou un système plus complexe un-à-plusieurs modèle où il pourrait y avoir de multiples Aspects que l'on pourrait afficher,
|
|
Exemple le signal Avancé présente Stop, mais nous pourrions afficher soit une
|
|
Approche ou Approche Déviée en fonction d'autres conditions.
|
|
<p>
|
|
La valeur de <code><advancedAspect></code> peut être n'importe quoi de défini dans le tableau Aspect
|
|
pour ce système de signalisation. <br>
|
|
La valeur de <code><ourAspect></code>, doit être celui qui est défini et soutenu par le fichier apparence (Il peut être affiché sur ce type de mât de signalisation).
|
|
dans le fichier apparence.
|
|
<p>
|
|
Toutes les modélisations sont contenues dans les balises <aspectMappings>, au sein de leurs propres
|
|
balises <aspectMapping>.
|
|
|
|
<code>
|
|
<aspectMappings>
|
|
<aspectMapping>
|
|
<advancedAspect>Approach</advancedAspect>
|
|
<ourAspect>Clear</ourAspect>
|
|
</aspectMapping>
|
|
<br>
|
|
<aspectMapping>
|
|
<advancedAspec1.7t>Stop</advancedAspect>
|
|
<ourAspect>Approach</ourAspect>
|
|
<ourAspect>Diverging Approach</ourAspect>
|
|
</aspectMapping>
|
|
</aspectMappings>
|
|
</code>
|
|
|
|
<h3>Vérifiez votre Travail</h3>
|
|
|
|
<p>Vous pouvez utiliser les outils " Vérifier le fichier XML" et "Valider le fichier XML"
|
|
sous la fenêtre JMRI "Debogaga" fenêtre pour vérifier vos fichiers.
|
|
( Notez que vous devez être connecté à internet pour le faire
|
|
car les fichiers se réfèrent à plusieurs ressources de vérification qui sont sur le site web de JMRI ).
|
|
Le premier vérifie le format de base: que tous les caractères < e >
|
|
soient au bon endroit? Etc. Le second permet de s'assurer que
|
|
les éléments de droite sont dans les bons endroits, et vérifie une partie du contenu,.
|
|
|
|
<h3>Modifications apportées à un système de signalisation existant, etc.</h3>
|
|
|
|
Il ya un certain nombre de définitions de signalisation déjà fournis dans JMRI qui sont
|
|
situéés dans le répertoire "xml/signal", certaines d'entre elles peuvent généralement répondre à vos
|
|
exigences mais certaines peuvent nécessiter des modifications pour s'adapter au matériel que vous utilisez,
|
|
ou il y a des variations locales dans les opérations, ou tout simplement que vous n'avez pas la possibilité de
|
|
travailler à un ensemble entièrement réaliste de signaux.
|
|
<p>
|
|
Dans ce cas, il est possible de modifier et de créer vos propres fichiers d'apparence qui
|
|
écrasera ceux fournis par JMRI. Vous devrez d'abord créer un sous-répertoire dans
|
|
le répertoire de ressources situé dans la zône de préférences de l'utilisateur appelé "signals", vous
|
|
aurez alors besoin de créer un sous-répertoire dans lequel il a exactement le même nom que le nom
|
|
fourni par JMRI. De là, tous les fichiers d'apparence que vous créez ou copiez soit seront
|
|
ajouter à la liste de mât pour ce système de signalisation soit écraseront le Mât de Signalisation JMRI prédéfinie
|
|
<p>
|
|
L'avantage de placer les fichiers (nouveaux et modifiés) de l'Apparence du mât de signalisation ici est que lorsque
|
|
JMRI est mis à jour, ces fichiers ne seront pas écrasées et perdues!.
|
|
<p>
|
|
Lexique:
|
|
<ul>
|
|
<li>* Aspect= couleur du feu</li>
|
|
<li>* Apparence (du Mât)= ce qu'il signifie ex: Rappel de ralentissement</li>
|
|
</ul>
|
|
|
|
<!--#include virtual="/help/fr/parts/Footer_fr.shtml" -->
|
|
</div><!-- closes #mainContent-->
|
|
</div> <!-- closes #mBody-->
|
|
<!--#include virtual="/help/fr/parts/Style.shtml" -->
|
|
</body>
|
|
</html>
|