# Guide d'utilisation — FL Briefing Board

Tout ce que l'outil sait faire, geste par geste. Pour démarrer : [README](../README.md).

## La palette — 28 formes

| Groupe | Formes |
|---|---|
| Aéronefs | chasseur, bombardier, ravitailleur, civil, hélicoptère, AWACS, drone |
| Armement / Effets | missile, bombe, explosion, abattu (« splash »), éjection, leurres |
| Sol / Mer | char, radar, menace sol-air (avec cercle d'engagement), aéroport, navire, porte-avions, FARP |
| Tactique | ami, hostile, inconnu, waypoint auto-numéroté, objectif, orbite d'attente, point IP, bullseye |

Les quatre voilures fixes sont volontairement **distinctes à petite taille** :
envergure, flèche, nombre de moteurs et taille par défaut diffèrent. Le ravitailleur
porte sa perche, le civil son empennage en T, le bombardier ses quatre moteurs.

Rien n'est une image : chaque forme est **paramétrique**. C'est ce qui la rend
orientable, redimensionnable et **recolorable sans perte**. Pour en ajouter une :
[docs/MODELE.md §8](MODELE.md).

## Kit radar — F/A-18C et F-16C

Deux groupes de la palette, **Radar F/A-18C** et **Radar F-16C**, pour expliquer la
page radar air-air de chaque appareil. Tout est dessiné d'après le manuel ED du module,
et chaque élément cite sa page : [RADAR.md](RADAR.md). Les deux symbologies ne se
mélangent pas : une marque ne se pose que sur une piste de son appareil.

**F/A-18C — page RDR ATTK**

- **Écrans RWS, TWS et STT** : l'écran de bord, ses 20 boutons et leurs libellés, le
  B-scope. Il se pose **sous** les autres objets et reste traversable : choisissez une
  piste, touchez l'écran, elle se pose dessus. Glisser en le posant l'agrandit ;
  ancrez-le (📌) pour ne plus le bousculer. Sélectionné, `↑` `↓` changent l'échelle
  (5 à 160 NM) et `←` `→` l'azimut balayé, comme ses boutons.
- **Pistes** : brique (contact brut), HAFU ami, inconnu ou hostile, posés à leur couleur
  d'identité. Le geste de pose oriente la **tige de cap** sans changer la taille ; la
  poignée tourne et redimensionne.
- **L&S et DT2** marquent une piste : choisissez-les, puis touchez un HAFU — ou tout
  près, le bout de sa tige suffit —, l'étoile ou le losange s'y inscrit. Touchée
  ailleurs, la marque désigne un écho, comme au cockpit : une brique devient la piste
  HAFU qui la porte, le fond de l'écran reçoit une nouvelle piste inconnue marquée. Une
  seule L&S et une seule DT2 par planche, sur deux pistes différentes, comme dans
  l'avion : l'une posée sur la piste de l'autre les échange, et la DT2 ne remplace
  jamais la seule L&S. Les reposer sur leur propre piste les retire. Jamais sur l'écran
  ou une piste du F-16C.
- **Curseur TDC** : deux traits verticaux, posés par-dessus la piste ou la brique
  désignée.
- Le rang de menace, la vitesse ou l'altitude d'une piste vont dans son étiquette
  (double-clic).

**F-16C — page FCR**

- **Écrans FCR RWS et TWS** : libellés des boutons, échelle entre ses flèches, largeur
  de balayage (`←` `→` : A6, A3, A1, dont les limites se tracent), échelle d'élévation
  d'antenne, horizon, repères de distance.
- **Cibles de recherche** chaude (trait dessous) ou froide (trait dessus).
- **Pistes TWS** (jaunes) et **pistes système** (blanches) : le symbole entier tourne
  avec le cap sol de la cible ; le geste de pose l'oriente.
- **Cible désignée** (bugged) : une marque, un cercle autour de la piste, une seule par
  planche. Posée sur une cible de recherche ou sur le fond de l'écran, elle en fait une
  piste système désignée — une cible chaude garde son cap, vers l'appareil.
- **Curseur A-A**, **brouillage** (chevrons) et **bullseye**.

Le radar se prépare de préférence sur une planche **sans carte** : sur une carte, un
écran suivrait le terrain au gré du zoom. La démo en ligne en montre deux (planches
« Radar F/A-18C » et « Radar F-16C »).

## Importer une mission DCS

**⇧ Mission**, ou glisser un fichier `.miz` sur la page : la mission devient une
nouvelle planche.

- S'il y a plusieurs **vols pilotables** (groupes dont un appareil est « Client » ou
  « Player »), choisissez le vôtre dans la liste.
- La planche porte sa **route** — waypoints numérotés, avec leur nom et leur altitude,
  le nom du vol sur le premier —, le **bullseye** de sa coalition, les **défenses
  aériennes** (SAM, artillerie, radars d'alerte) et les **navires** des deux camps, à la
  couleur de leur camp et sous leur nom de groupe.
- La coupe s'ouvre, route liée : le profil du vol se lit tout de suite. Une altitude
  « sol » (AGL dans l'éditeur) est signalée « alt. sol ».
- Sur les théâtres dont la projection est mesurée — Caucase, Syrie, Golfe Persique,
  Sinaï, Afghanistan, Mariannes, Kola —, tout se pose **sur la carte**, au mètre près.
  Ailleurs, sur une **planche sans carte** à l'échelle exacte, nord de la grille DCS en
  haut ; ses caps portent alors un « G » (grille).
- Les unités au sol reconnues comme défense aérienne le sont par leur type DCS ; les
  autres (chars, camions…) ne sont pas importées.
- Les **ravitailleurs** et les **AWACS** de l'IA, reconnus à la tâche de leur groupe dans
  l'éditeur (« Refueling », « AWACS »), viennent aussi, des deux camps : leur **route**
  en tireté, leur **orbite** en symbole d'hippodrome, et l'appareil accroché dessus,
  étiqueté — « Texaco 11 · FL200 · TCN 12Y TEX · 251.000 ». Le niveau est celui de
  l'orbite, qui commande en vol. L'hippodrome est un symbole, pas un tracé à l'échelle :
  la mission ne donne ni la largeur d'un Race-Track ni le rayon d'un cercle, l'IA les
  vole. Un Race-Track est posé au milieu de sa branche, du point qui porte l'orbite au
  suivant. Les autres appareils de l'IA ne sont pas importés.

## Charger la route dans la DTC du F/A-18C

**⇩ DTC**, puis choisissez la mission DCS (`.miz`) qui sert de support : les waypoints
de la planche sont écrits dans la cartouche de données (DTC) des F/A-18C d'un vol de
cette mission. Le tableau rend une **copie**, `<mission> - FL Briefing.miz` ; la mission
d'origine n'est pas modifiée. Le pilote qui prend l'avion démarre ses points chargés,
sans outil tiers.

- **Le numéro ne change pas** : le waypoint 3 du tableau est le 3 dans l'avion (de 1 à
  59). Son altitude est celle de la coupe, au-dessus de la mer, et son étiquette devient
  la note du point. Les points forment la séquence 1, dans l'ordre des numéros.
- Plusieurs vols F/A-18C pilotables : choisissez celui qui reçoit la route.
- **Une cartouche déjà là sert de base** : radios, contre-mesures, TACAN et réglages de
  navigation sont gardés, seuls les waypoints sont remplacés. La nouvelle cartouche
  s'appelle « *ancienne* - FL Briefing » ; l'ancienne reste dans la mission. Sans
  cartouche, le vol en reçoit une qui ne contient que les waypoints.
- La cartouche est **chargée au démarrage** pour tous les F/A-18C du vol.
- Il faut un **repère DCS** : une planche sur carte, ou la planche d'une mission importée
  sans carte (et ses phases), et une mission **du même théâtre**.
- Réécrire sur la copie remplace la cartouche du tableau sans la doubler.
- Sur un serveur, c'est la mission en rotation qui compte : celui qui la prépare y met
  la copie.
- Seul le **F/A-18C** est couvert pour l'instant.

## Mode présentation

Pour mener le briefing en partage d'écran : **▶ Présenter** (ou `F5`). Le tableau passe
en plein écran, sans barre ni palette ; un repère discret, en haut à droite, dit la
phase affichée (« 2 / 4 · Attaque »).

- `→`, `Espace` ou `PgSuiv` : phase suivante ; `←` ou `PgPréc` : précédente ; `Début`
  et `Fin` : première et dernière.
- **Le passage d'une phase à l'autre est animé** : chaque appareil, flèche ou zone
  présent des deux côtés glisse de sa place à la nouvelle — position, cap, couleur —,
  ce qui apparaît ou disparaît le fait en fondu, la carte et la vue radar liée suivent.
  Il suffit de bâtir la phase suivante par **+ phase** et d'y déplacer les appareils :
  c'est ainsi qu'ils se reconnaissent d'une planche à l'autre. L'animation joue entre
  deux planches du même repère (même théâtre, ou toutes deux sans carte).
- La souris devient un **pointeur laser** : un point rouge suit le curseur, et un
  glissé bouton gauche trace un trait rouge qui s'éteint seul en une seconde et demie.
- La carte reste mobile : molette pour zoomer, clic droit glissé pour se déplacer.
- Rien ne s'édite : aucun outil, aucun raccourci d'édition ; rien de ce que trace le
  laser n'entre dans le tableau, l'historique ou les exports.
- `Échap` sort, et rend les barres.

## Vue radar liée

Le panneau du bas montre, au choix, la coupe ou **l'écran radar d'un appareil**,
calculé depuis la vue de dessus : ce que la manœuvre dessinée donne sur le B-scope.

1. Ouvrez la coupe (⊟), puis choisissez **RADAR F/A-18C** ou **RADAR F-16C** dans la
   liste du bandeau.
2. Sélectionnez un appareil dans la vue de dessus, puis **◎ Porteur**. Un seul porteur
   par planche ; son cône balayé se dessine en pointillés sur la vue de dessus.
3. Réglez l'**échelle** et le **balayage** dans le bandeau.

Chaque autre aéronef de la vue de dessus devient un contact, placé selon son gisement
et sa distance : déplacez une cible, tournez le porteur (`←` `→`), l'écran suit. Au
F/A-18C, un contact est un HAFU dont l'identité suit sa couleur (rouge hostile, bleu
ami, toute autre inconnue) ; au F-16C, une piste TWS. Sa tige ou son trait de nez
montre son cap rapporté au vôtre.

À droite, la lecture de chaque contact : distance, gisement, **aspect** au format du
F-16C (en dizaines de degrés, côté G ou D : « 9D » au travers, « 18 » de face),
**chaude** ou **froide**, et **radiale** — la part de sa vitesse le long de la ligne de
visée. Près de 0 %, la cible est au travers : c'est là qu'un radar Doppler peut la
rejeter en regardant vers le bas. Les contacts hors du balayage ou au-delà de l'échelle
sont comptés.

La vue montre la géométrie ; elle ne simule pas la détection. Il faut une carte ou une
planche étalonnée : sans échelle, un message, et rien d'inventé. La démo en ligne en
montre une (planche « Interception »), et le kneeboard l'emporte sous le plan.

## Cartes

La liste en haut à droite de la vue de dessus propose les **14 théâtres DCS**, en
**topographique**, **satellite** ou **plan routier**. Une version locale peut y ajouter
les aérodromes sous leur nom DCS (`python tools/build_theatres.py --aerodromes`). La carte est vivante : molette ou pincement pour zoomer ; clic droit glissé, clic
molette, espace + glisser ou outil main (`H`) pour se déplacer. Tout ce qui est posé
suit le terrain, et **l'échelle est automatique** : plus d'étalonnage.

**Caps vrais ou magnétiques** : bouton **Cap vrai / Cap mag.** La déclinaison est
calculée sur la carte par le modèle magnétique mondial WMM2025 ; bouton **Décl.** pour
saisir celle de votre mission DCS, qui l'emporte — les caps sont alors ceux du cockpit.
Chaque cap porte sa référence : `049°V`, `042°M`.

Ce sont les cartes réelles des régions que DCS reproduit, pas la carte F10 du jeu.
Il faut une connexion Internet pour les charger ; sans réseau, le glisser-déposer
d'une image reste possible.

## Gestes

- **Poser et orienter d'un seul geste** : cliquer la forme dans la palette, appuyer
  sur le tableau et — sans relâcher — tirer dans la direction du cap. La distance
  donne la taille. Un simple clic pose à la taille par défaut, cap au nord.
- **Numéros de waypoint** : un nouveau waypoint (posé ou copié) prend le **plus petit
  numéro libre** de la vue. Supprimez le 2 d'une route 1-2-3-4 : le prochain waypoint
  sera le 2, puis le 5. Tout supprimé, on repart de 1. Les autres gardent leur numéro,
  pour rester ceux de la mission importée et de la DTC.
- **Reprendre** : toucher une forme existante la saisit, sans changer d'outil —
  y compris **par le bout d'aile** ; l'outil sélection (`V`) attrape aussi flèches,
  traits et carte de fond ; la poignée bleue tourne et redimensionne ; `←` `→`
  tournent au degré près (`Maj` pour plus fin).
- **Revenir à la sélection** : clic droit sans bouger, ou `Échap`. Le geste en cours est
  abandonné (zone commencée, forme en cours de pose) et l'outil Sélection reprend la
  main. Glissé, le clic droit déplace toujours la carte. L'application s'ouvre sur
  l'outil Sélection : un premier clic dans le vide ne pose rien.
- **Ancrer** (📌 ou `K`) : la sélection ne se déplace plus, ne tourne plus et ne s'efface
  plus — ni gomme, ni `Suppr`. On pose et on saisit par-dessus sans la bousculer : zone
  SAM, bullseye, image de fond. Couleur, trait et étiquette restent modifiables ; une
  copie naît libre. Pour libérer : outil Sélection, toucher l'objet, puis 📌 ou `K`. Sur
  une carte, glisser sur un objet ancré déplace la carte.
- **Accrocher** (🔗 ou `J`) : un ravitailleur posé sur la branche de son hippodrome, une
  piste sur son écran radar, y restent. Sélectionner l'objet, 🔗, puis toucher le
  symbole qui le porte — toucher l'objet lui-même désigne le symbole dessous. Accroché,
  il garde sa place sur ce symbole **à tout zoom de la carte** (un symbole garde sa
  taille à l'écran : ce qui est posé dessus aussi), et le suit quand on le déplace, le
  tourne ou l'agrandit, cap compris. On peut encore le glisser ou le tourner : il reste
  accroché à sa nouvelle place. 🔗 de nouveau le décroche, sur place. Sélectionné, un
  pointillé le relie au centre de son hôte. Un symbole ou un texte s'accroche, à un
  symbole ; un texte peut s'accrocher au ravitailleur accroché à l'orbite. Une copie
  (`Ctrl+D`) reste accrochée au même hôte ; effacer l'hôte laisse l'objet en place.
- **Étiqueter** : double-clic sur une forme — « UZI 1-1 · FL250 · 450 kt ». L'étiquette
  suit la forme ; la vider la supprime.
- **Courber une flèche** : la tracer droite, puis tirer la **poignée du milieu**.
- **Styles de trait** : plein = réel, tirets = prévu, pointillés = menace.
- **Zone hachurée** (`Z`) : cliquer les sommets, refermer sur le premier point ou
  double-cliquer. Double-clic dedans pour la nommer (« CAP NORD », « SAM MEZ »).
- **Règle** (`M`) : distance et cap. Mesurer une distance connue, puis **Échelle** pour
  passer en NM ou en km.
- **Cotes** (📐) : distance et cap affichés sur les traits et les flèches. Sur une
  flèche courbe, la distance suit le chemin tracé. Bouton **NM / km** pour l'unité.
- **Planches** : un onglet par phase (ingress, attaque, egress…). « + phase » copie la
  planche affichée ; double-clic pour renommer ; `PgPréc` / `PgSuiv`.
- **Coupe** (⊟) : l'écran se partage, vue de dessus en haut, **vue de profil** en bas.
  Altitudes en pieds, niveaux de vol au-dessus de 18 000 ft, calées sur 500 ft. Les
  appareils y prennent leur silhouette de profil et affichent leur altitude. Le
  bandeau de la coupe offre **relief**, **menace sol-air** (dôme) et **bloc
  d'altitude**, et règle le plafond et la largeur.
- **Route liée** (case du bandeau de coupe) : la coupe suit les waypoints de la vue de
  dessus, dans l'ordre de leurs numéros, en distance cumulée. Tirez un waypoint de la
  coupe verticalement pour son altitude, double-cliquez pour la taper. La vue de
  dessus doit porter une carte, ou être étalonnée.
- **Recolorer** : une pastille de couleur repeint la sélection au lieu d'attendre le
  prochain tracé. Même chose pour l'épaisseur.
- Dupliquer (`Ctrl+D`), premier plan, flèche double sens, supprimer (`Suppr`).
- Crayon libre, trait, cercle, rectangle, texte restent disponibles.
- Image de fond (carte) par **glisser-déposer** ou `Ctrl+V`, redimensionnable, et
  **gardée d'une ouverture à l'autre**. La gomme ne la touche pas : elle se retire par
  sélection puis `Suppr`.
- **Enregistrer le briefing** (⇩ Briefing, `Ctrl+S`) : toutes les planches, leurs
  réglages et leurs images, dans un fichier `.json`. **L'ouvrir** (⇧ Ouvrir, `Ctrl+O`,
  ou glisser le fichier sur la page) sur un autre poste, ou le passer au meneur
  suivant : il remplace le tableau affiché, après confirmation. Un fichier qui n'est pas
  un briefing est refusé, et le tableau reste tel quel.
- **Nouveau briefing** (✚ Nouveau) : le tableau se garde tout seul dans le navigateur et
  revient à chaque ouverture. Pour repartir d'une page blanche, ✚ Nouveau efface toutes
  les planches et leurs images, après confirmation, et ne s'annule pas : enregistrez
  d'abord (⇩ Briefing) ce que vous voulez garder. Unité, cap vrai ou magnétique, fond et
  coupe restent réglés. **Effacer**, lui, ne vide que la planche affichée.
- Annuler / rétablir, export **PNG** horodaté, fond sombre ou clair, palette
  masquable.
- **Kneeboard DCS** (⇩ Kneeboard) : PNG portrait 768 × 1157, à copier dans
  `Saved Games\DCS\Kneeboard\`. Ce sont les proportions de la planchette du jeu, qui
  étire toute image à sa taille : une page d'autres proportions y sortirait déformée.
  Sans cadre, la page montre toute la planche.
- **Cadrer le kneeboard** (⬚ Cadre) : un cadre pointillé doré, aux proportions de la
  page, se pose au milieu du plan. On le déplace par son bord ou son titre, on
  l'agrandit par sa poignée ; dedans, on continue de travailler sur le plan. L'export
  ne prend alors que ce qu'il contient, sur toute la page. Un cadre par planche,
  recopié par « + phase » ; il ne sort ni dans le PNG ni en présentation. Un second
  clic sur ⬚ Cadre l'ôte. La page n'a pas encore été vue dans le cockpit.

**Raccourcis** — `V` sélection · `A` flèche · `L` trait · `P` crayon · `C` cercle ·
`R` rectangle · `Z` zone · `M` règle · `T` texte · `E` gomme · `H` main · `Ctrl+Z` /
`Ctrl+Y` / `Ctrl+D` · `PgPréc` / `PgSuiv` planches · `+` / `−` zoom de la carte · `K`
ancrer · `J` accrocher · `Échap` ou clic droit : retour à la sélection · `Ctrl+S` enregistrer le briefing ·
`Ctrl+O` l'ouvrir · `F5` présenter · glisser un `.miz` : importer la mission.

## Ce qu'il ne fait pas

Pas de zoom ni de défilement sans carte (le tableau blanc, c'est l'écran) · pas de collaboration temps
réel · pas de carte hors ligne · pas de sélection multiple ni de groupes. Ces
absences sont des décisions, pas des oublis : [docs/ETAT.md §5](ETAT.md).