Radar Avion
pour FS2004 et FSX

Cette section explique comment intégrer le radar dans un tableau de bord d'avion pour FS2004/FSX.

Integration

Le radar avion propose 4 gauges différentes, selon la couleur et la forme de l'écran radar que l'on souhaite utiliser:

• Ecran vert rectangulaire (Rectangular Green)
• Ecran ambre rectangulaire (Rectangular Amber)
• Ecran vert circulaire (Circular Green)
• Ecran ambre circulaire (Ciruclar Amber)

En outre, plusieurs gauges au format XML sont fournies pour contrôler le radar:

• Passer au mode précédent/suivant
• Augemnter/diminuer la portée
• Fixer un certain mode

L'utilisation de ces gauges sera détaillée plus loin.

Note:
Les gauges XML utilisées pour contrôler le radar sont extrèmement simples. Toute personne ayant un minimum de connaissances sur la construction de gauges en XML peut facilement les modifier ou s'en inspirer pour créer ses propres gauges de contrôle du radar.

Gauges pour l'écran radar

Pour intégrer l'écran radar dans un tableau de bord, il est nécessaire d'éditer le fichier de configuration du tableau de bord (panel.cfg) pour y ajouter la ligne qui décrit l'écran radar souhaité. Cette ligne respecte le format suivant, de la même façon que toutes les autres lignes qui décrivent les gauges utilisées dans le tableau de bord:

gaugeXX=NomGauge, X,Y,L,H

XX est le numéro de la gauge. Cela devrait être le plus haut numéro existant + 1
NomGauge est le nom de la gauge. Pour chaque forme/couleur d'écran radar, le nom à utiliser sera expliqué plus loin.
X,Y définit la position de la gauge
L,H définit la taille de la gauge (largeur et hauteur)
Il est fortement recommandé de définir une taille qui donne une zone carrée à l'écran. Sinon, le mode global du radar affichera une ellipse plutôt qu'un cercle.

Pour plus d'informations sur l'édition des tableaux de bord, Microsoft met à disposition le Microsoft Panel SDK.

Le tableau suivant donne le nom de gauge qui doit être utilisé en fonction de la forme et la couleur d'écran radar souhaité:

Usage	Nom de la Gauge
Ecran radar vert rectangulaire	Radar!Rectangular Green
Ecran radar ambre rectangulaire	Radar!Rectangular Amber
Ecran radar vert circulaire	Radar!Circular Green
Ecran radar ambre circulaire	Radar!Circular Amber

Example:

gauge12=Radar!Rectangular Green, 52,412,150,150

Sur cet exemple, un écran radar vert rectangulaire est utilisé, placé en 52,412 et de taille 150 par 150.

Gauges de Contrôle du Radar

Ces gauges permettent de contrôler le radar (mode et portée). Comme ce sont des gauges XML, leur contenu est lisible et modifiable à souhait. Elles sont extrèmement simples de telle sorte que toute personne ayant un minimum de connaissances sur la construction de gauges en XML peut facilement les modifier ou s'en inspirer pour créer ses propres gauges de contrôle du radar.
Certaines gauges utilisent des icônes graphiques fournies à titre d'exemple, d'autres gauges sont transparentes pour être utilisées en superposition au-dessus de l'image du tableau de bord.

Ces gauges sont installées dans le dossier: <Dossier Installation FS>\Gauges\RadarControl

Le tableau suivant montre comment les gauges XML peuvent être utilisées dans un tableau de bord:

Nom du fichier	Nom à utiliser dans le panel.cfg	Rôle	Icône
Global Mode.xml	RadarControl!Global Mode	Mets le radar en mode global
Transp Global Mode.xml	RadarControl!Transp Global Mode	Mets le radar en mode global (gauge transparente)	Aucune
Horizontal Mode.xml	RadarControl!Horizontal Mode	Mets le radar en mode horizontal
Transp Horizontal Mode.xml	RadarControl!Transp Horizontal Mode	Mets le radar en mode horizontal (gauge transparente)	Aucune
Vertical Mode.xml	RadarControl!Vertical Mode	Mets le radar en mode vertical
Transp Vertical Mode.xml	RadarControl!Transp Vertical Mode	Mets le radar en mode vertical (gauge transparente)	Aucune
Transp Off Mode.xml	RadarControl!Transp Off Mode	Eteins le radar	Aucune
Radar Mode Switch.xml	RadarControl!Radar Mode Switch	Fixe le mode précédent/suivant
Transp Horizontal Mode Switch.xml	RadarControl!Transp Horizontal Mode Switch.xml	Fixe le mode précédent/suivant (gauge transparente) Gauge à disposition horizontale (cliquer à gauche/droite pour passer au mode précédent/suivant)	Aucune
Transp Vertical Mode Switch.xml	RadarControl!Transp Vertical Mode Switch	Fixe le mode précédent/suivant (gauge transparente) Gauge à disposition verticale (cliquer en haut/en bas pour passer au mode précédent/suivant)	Aucune
Radar Range Switch.xml	RadarControl!Radar Range Switch	Augmente/diminue la portée du radar
Transp Horizontal Range Switch.xml	RadarControl!Transp Horizontal Range Switch.xml	Augmente/diminue la portée du radar (gauge transparente) Gauge à disposition horizontale (cliquer à gauche/droite pour diminuer/augmenter la portée)	Aucune
Transp Vertical Range Switch.xml	RadarControl!Transp Vertical Range Switch.xml	Augmente/diminue la portée du radar (gauge transparente) Gauge à disposition verticale (cliquer en haut/en bas pour diminuer/augmenter la portée)	Aucune

Important:

Pour pouvoir utiliser le contrôle du radar par le clavier (comme expliqué ici), il est nécessaire d'ajouter la gauge  RadarControl!Keyboard n'importe où dans le tableau de bord principal, comme ceci:

gaugeXX=RadarControl!Keyboard, 0,0,1,1

Le numéro de la gauge (XX) n'a pas d'importance à partir du moment où il n'est pas déjà utilisé. La position et la taille de la gauge ne sont pas importantes non plus car cette gauge n'a aucune apparence visuelle.

Integration du Radar à Ecran Circulaire

L'intégration du radar à écran circulaire nécessite un traitement particulier sur le tableau de bord. Ce n'est pas compliqué, mais il est toutefois nécessaire de l'expliquer sur un exemple. Cet exemple montre comment on peut utiliser plusieurs couches d'affichage dans un tableau de bord.

Imaginons l'intégration du radar circulaire à l'emplacement montré en rouge dans un panel comme celui-ci:

Dans le fichier panel.cfg, le tableau de bord principal est décrit dans une section appelée [Window00], ce qui indique qu'il s'agit de la première fenêtre du tableau de bord. Comme c'est la première fenêtre, toutes les autres fenêtre s'afficheront au-dessus de celle-ci.

Si le panel.cfg est modifié pour y ajouter le radar à écran circulaire en utilisant la gauge "Radar!Circular Green" ou "Radar!Circular Amber", le contenu du panel.cfg ressemble à ceci:



C'est exactement ce qu'il faut éviter car les coins de l'écran radar sont encore visible, comme le montre cette image:

Pour éviter cela, il suffit de créer une image supplémentaire qui servira de masque pour cacher les coins indésirables. Pour ce faire, il suffit de suivre les instructions suivantes:

• Copier l'image existante du tableau de bord en la nommant par exemple mask.bmp
• Modifier l'image en remplissant la zone dédiée à l'écran radar circulaire en noir pur (0,0,0). Cette zone deviendra transparente quand le tableau de bord sera affiché à l'écran dans FS. Dans cet exemple, l'image modifiée serait ainsi:
  
  
  
• Modifier le fichier panel.cfg de telle sorte que l'image masque soit dessinée au-dessus de l'image originale de base sur laquelle le radar est dessiné. Pour ce faire, il faut créer une nouvelle section, appelée [Window01], et lui faire utiliser l'image mask.bmp. La gauge radar soit rester dans la section [Window00], alors que toutes les autres gauges doivent être déplacées dans la nouvelle section [Window01].
  Le fichier panel.cfg résultant doit ressembler à ceci:
  
  
  Si une section [Window01] existe déjà, il faut la renommer en [WindowXX] de telle sorte que chaque numéro de section soit unique.

Le résultat obtenu est bien meilleur, conformément à ce qui était attendu.