JMRI: RPS Icon

# JMRI: Icône RPS

RPS est un système permettant de mesurer les positions du matériel roulant sur votre réseau. Plus d'informations sur RPS est disponible sur la page principale d'aide sur RPS. Les icônes Reporter RPS se déplace sur le TCO pour montrer où l'équipement correspondant se trouve sur le réseau.

Cette page est encore en construction, mais le support de l'icône RPS lui-même est déjà présent dans JMRI. Allez-y et essayez-le!

Les icônes RPS sont un moyen de mettre des icônes sur un TCO qui vont se déplacer quand le système RPS trouve l'emplacement d' un émetteur associé.

## Ajouter une Icône RPS sur un TCO

Habituellement, chaque icône représente un émetteur RPS, donc une locomotive. Actuellement, vous devez ajouter une Icône pour chaque équipement équipé RPS que vous souhaitez suivre. Bien que ce soit couteux, il vous donne un contrôle très fin sur les positions des émetteur qui sont sont affichées et comment elles sont présentées. Cette Section demande encore beaucoup de travail

Cliquez sur "Ajouter rapport RPS " sur l'Éditeur de TCO. Une icône RPS apparaîtra sur le TCO à son emplacement par défaut, mais ça ne marchera pas encore jusqu'à ce qu'elle soit calibrée.

Faites un clic droit ou option-clic sur l'icône pour voir le menu contextuel, où vous pouvez calibrer l'icône.

### Calibration d'une Icône RPS

Lorsque vous étalonnez une icône RPS, vous spécifiez comment des lieux RPS mesurés correspondent à des positions sur le TCO.

Les étapes sont les suivantes:

- Arrêter le système de scrutation RPS, alors les objets ne vont plus se déplacer .
- Ajouter l'icône au panneau.
- Faites glisser l'icône jusqu'à ce qu'elle soit sur la position qui correspond à l'origine de votre installation 0,0 RPS.
- Faites un clic droit ou option-clic sur l'icône pour obtenir le menu contextuel, et sélectionnez "Définir Origine».
- Déplacer la locomotive réelle à un autre point sur le réseau , et commencer l'interrogation du système RPS à nouveau. Obtenez une bonne mesure de la position. Arrêter le système RPS.
- Faites glisser l'icône à l'endroit où vous voulez qu'elle soit sur le TCO lorsque l'émetteur est à cet endroit.
- Depuis le menu contextuel de l'icône, sélectionnez "Définir emplacement actuel».
- Obtenir à nouveau le menu contextuel. Il ne devrait plus dire "Non calibré", et devrait plutôt vous montrer la position actuelle.

Ne pas oublier de sauvegarder votre TCO!

## Menu Contextuel

Le menu contextuel de l'icône RPS contient:

Lecture position RPS
  Ceci est juste un titre, la sélectionner ne fait rien
Rotation
  Tourne l'icône affichée, en incréments de 90 degrés. Notez que ce n'est pas une rotation dù au système de coordonnées RPS, mais simplement de la présentation de l'icône.
Afficher ID
  Quand elle est cochée, la chaîne d'identification sera affiché en plus de l'icône.
Définir l'origine
  Définit la position d'affichage actuelle de l'icône comme la position 0,0 du système RPS. Cela doit être fait en tant que première étape de l'étalonnage.
Définir la Situation actuelle
  Modifications de l'étalonnage de telle sorte que sa position sur le TCO et la mesure RPS soit en accord. Pour l'utiliser, vérifiez d'abord que le système RPS a fait une bonne mesure de la position des émetteurs, alors faites glisser l'icône à l'endroit où elle devrait apparaître sur l'écran, et enfin choisissez "Situation actuelle" dans le menu contextuel. Dans l'avenir, lorsque le système RPS mesures au même endroit, l'icône apparaîtra dans cette position.
Pas étalonné
  Un message d'état, pas un contrôle, cela apparait quand l'icône n'a pas été étalonnée. Le calibrage assure correctement la position de l'icône sur l'écran reflétant l'emplacement que RPS a mesuré.
A (x), (y)
  Une fois l'icône calibrée, le menu contextuel affiche la mesure RPS du positionnement le plus récent
Afficher ID
  Si elle est cochée, l'icône aura des informations ID affichées à coté d'elle.
Définir le filtre
  Ouvre une fenêtre qui vous permet d'entrer une valeur de filtre pour cette icône.
Désactiver
  Contrôles si oui ou non l'icône peut être déplacée autour manuellement.
Retirer
  Supprime l'icône RPS du TCO. Il s'agit d'une suppression définitive.
Aide
  Affiche cette page

## Filtrage et Plusieurs Locomotives

Nous essayons toujours de trouver la meilleure façon de configurer plusieurs icônes sur un TCO. Une icône unique, sans réglages spéciaux, sera sautillante sur le TCO quand les lectures entrent en jeu. Elle ira à la position d'une lecture, puis passera directement à la position de la prochaine lecture, qui pourrait provenir d'un autre émetteur de locomotive.

Si vous voulez avoir plusieurs icônes, chacune montrant la position d'une seul locomotive, vous pouvez configurer des filtres sur chaque icône.

- Ajouter une icône au panneau de RPS
- Ouvrez le menu contextuel sur l'icône et sélectionnez "Définir le filtre".
- Cela ouvrira une petite fenêtre dans laquelle vous pouvez saisir la valeur de l'ID de la locomotive que vous voulez que cette icône suive. Une fois que vous avez fait cela, l'icône ne se déplacera qu'à la position mesurée de cette locomotive.

Cette méthode est un peu fastidieuse, surtout si vous avez une liste importante, puisque vous aurez à le faire manuellement pour chaque locomotive. Et vous les aurez toutes à calibrer. (Une bonne façon de faire est de copier les lignes définissant une icône dans le fichier de TCO, en effet faites un tas de duplicata des icônes calibrées, puis définissez les filtres, voir ci-dessous). Mais il a l'avantage que vous pouvez contrôler exactement quelles locomotives sera afficher et celles qui ne le seront pas. Cette méthode permet également de joindre des images personnalisées (par exemple une image d'une locomotive spécifique) à l'icône spécifique qui représente chaque ID.

## Personnalisation

### Position de Départ

Lorsque vous ouvrez le TCO, les icônes sont remise à la même position sur l'écran qu'elles occupaient lorsque le TCO a été sauvegardé dans le fichier.

Vous pouvez l'utiliser pour par exemple mettre les icônes hors de la voie. Elles restent dans cette position jusqu'à ce qu'une lecture valide les déplace, donc Vous pouvez l'utiliser pour "parquer" les locomotives qui ne sont pas sur la bonne voie hors de la partie active du TCO.

### Afficher une Icône Personnalisée

Bien qu'il n'y ait pas encore d'interface graphique pour ça (ça vient!), vous pouvez modifier l'icône d'un émetteur qui est suivi par le système RPS afin qu'il affiche par exemple une petite image de la locomotive. Pour ce faire, vous allez éditer le fichier de définition de panneau directement. (Il ya plus d'informations sur le Format XML, que nous utilisons ici) Les étapes sont les suivantes:

- Créer une icône sur l'éditeur de TCO, et sauver le TCO dans un fichier.
- Faites une copie de sauvegarde du fichier, au cas où quelque chose tourne mal.
- A l'aide d'un éditeur de texte, ouvrez le fichier pour le modifier.
- Trouvez la ligne qui définit l'icône. Il contiendra la chaîne "RpsPositionIconXml», ainsi une approche est de rechercher cela. Il va ressembler à (il sera probablement sur une seule ligne):

          <Sensoricon x = "95" y = "150" level = "10"
                  actif = "resources/icons/smallschematics/tracksegments/circuit occupied.gif"
                  error = "resources/icons/smallschematics/tracksegments/circuit error.gif"
                  rotate = "0" forcecontroloff = "false" momentary = "false"
                  sxscale = "11.849106591612951" syscale = "-11,889381744148094"
                  sxorigin = "41" syorigin = "768"
                  class = "jmri.jmrit.display.configurexml.RpsPositionIconXml" />

- Pour que l'icône suive d'un émetteur spécifique, entrez l'ID de l'émetteur en tant qu'attribut "filtre". Par exemple, pour suivre l'émetteur 5510, modifiez la ligne:

          <Sensoricon filter = "5510" x = "95" y = "150" level = "10"
                  actif = "resources/icons/smallschematics/tracksegments/circuit occupied.gif"
                  error = "resources/icons/smallschematics/tracksegments/circuit error.gif"
                  rotate = "0" forcecontroloff = "false" momentary = "false" s
                  xscale = "11.849106591612951" syscale = "-11,889381744148094"
                  sxorigin = "41" syorigin = "768"
                  class = "jmri.jmrit.display.configurexml.RpsPositionIconXml" />

- Les attributs "actif" et "erreur" sont les icônes à afficher lorsque le système obtiennent des résultats fiables et n'obtiennent pas de bonnes lectures, respectivement. Vous pouvez modifier celle ci à l'emplacement de n'importe quel fichier d'icône que vous souhaitez. Par exemple, vous pouvez les changer pour une photo (petite) de la locomotive, ou pour une image avec le numéro du train.

Une belle interface graphique pour faire cela est à venir, mais elle n'est pas encore là.