Prévisualiser des fichiers OpenSCENARIO sur GitHub — l'extension Chrome drawtonomy

La plupart des travaux OpenSCENARIO commencent sur GitHub. Les scénarios vivent dans un dépôt et arrivent sous forme de pull requests ; comprendre l’un d’eux implique en général de cloner le dépôt, d’installer un simulateur, puis de lancer le fichier juste pour voir ce qu’il fait.

drawtonomy for GitHub évite tout cela. C’est une extension Chrome gratuite qui lit les fichiers .xosc directement sur github.com — sans téléchargement, sans installation, sans simulateur.

Installer depuis le Chrome Web Store →

Prévisualisation des scénarios d'esmini sur GitHub, ouverture de l'un d'eux dans l'éditeur, modification d'un événement, puis export d'un extrait recadré.

Ce que fait l’extension

Où elle s’exécute	github.com — pages de fichier et listings de dossiers
Ce qu’elle prévisualise	Les fichiers OpenSCENARIO .xosc dans les dépôts publics
Ce qu’elle résout automatiquement	Le réseau routier et les catalogues de véhicules dont le scénario a besoin
Ce qu’elle collecte	Rien — aucune télémétrie, aucun compte requis

Installation

Installez drawtonomy for GitHub depuis le Chrome Web Store. Il n’y a rien à configurer et aucun compte à créer. Visitez n’importe quelle page GitHub contenant des fichiers .xosc : l’extension est prête à l’emploi.

Prévisualiser un scénario sans quitter GitHub

Naviguez vers un dépôt public contenant des fichiers OpenSCENARIO — par exemple esmini/esmini, dont le dossier resources/ contient des dizaines de scénarios d’exemple.

Partout où un fichier .xosc (ou un dossier qui en contient) apparaît dans un listing GitHub, une petite pastille ▶ s’affiche. Les dossiers qui contiennent des scénarios affichent aussi un décompte, pour savoir combien il y en a avant même de cliquer.

Cliquez sur une pastille et le scénario se joue directement là — route, véhicules et chronologie complète des événements — dans une fenêtre superposée à la page.

Vous parcourez tout un dossier ? Utilisez les boutons ◀ ▶ (ou les touches directionnelles) pour passer au scénario suivant sans fermer l’aperçu. Cliquez sur le nom du fichier en haut pour sauter directement à n’importe quel scénario du dossier depuis une liste, plutôt que de les parcourir un par un. Si un dépôt stocke un scénario par sous-dossier, ouvrir la pastille d’un dossier parcourt tous les scénarios qu’il contient, y compris ses sous-dossiers, en une seule séquence.

Ouvrir directement un fichier .xosc (plutôt qu’un dossier) affiche le même aperçu en ligne sur la page, à côté des boutons Raw / Copy / Download de GitHub.

Raccourcis clavier

Touche	Action
Échap	Fermer l’aperçu
← / →	Scénario précédent / suivant
↑ ↓	Se déplacer dans la liste de saut
Entrée	Ouvrir le scénario sélectionné

L’ouvrir dans l’éditeur complet

L’aperçu montre ce que fait un scénario. Pour le modifier, cliquez sur Open in drawtonomy afin de transmettre ce même scénario à l’éditeur complet dans un nouvel onglet — sa route et les catalogues dont il a besoin sont déjà résolus, il est donc prêt à être rejoué immédiatement.

Le lien sur lequel vous arrivez est une URL partageable ordinaire — n’importe qui peut l’ouvrir, avec ou sans l’extension.

Lire et suivre l’action

Une fois dans l’éditeur, deux réglages rendent un scénario bien plus facile à suivre :

• Follow: Ego garde la caméra verrouillée sur le véhicule ego, ce qui compte pour les routes importées qui peuvent s’étendre sur plusieurs kilomètres.
• Ghost laisse une traînée des positions passées, de sorte qu’une manœuvre rapide comme un cut-in se lit comme une image claire au lieu d’un instant qu’il faut attraper au vol.

Voir Lecture pour l’ensemble des commandes de lecture.

Modifier le scénario

Un scénario importé n’est pas en lecture seule. Cliquez sur n’importe quelle carte d’événement pour ouvrir l’éditeur d’événement et changer son déclencheur ou son action, puis relancez la lecture pour voir le nouveau comportement.

Voir Actions et Déclencheurs pour le détail de chaque option.

Exporter un extrait du passage qui compte

Vous avez rarement besoin de l’exécution entière — souvent juste les quelques secondes où quelque chose d’intéressant se produit. Export video enregistre exactement cela sous forme de fichier .webm, prêt à glisser dans un commentaire de pull request, un ticket ou un support de revue.

Réglez Range sur Trim, faites glisser les deux poignées de la barre de lecture jusqu’au moment voulu, puis cliquez sur Start. Vous pouvez aussi choisir le ratio d’aspect, si la caméra suit le véhicule ego ou cadre toute la scène, et si les traînées fantômes sont incluses dans l’enregistrement.

Confidentialité

L’extension ne collecte rien — aucune télémétrie, aucun compte, rien envoyé vers un serveur qui lui soit propre. Prévisualiser un fichier revient à ouvrir ce scénario sur drawtonomy.com dans un nouvel onglet. Détails complets : Politique de confidentialité de l’extension Chrome.

Bon à savoir

• Dépôts publics uniquement. Les dépôts privés ne sont pas pris en charge.
• Fichiers .xosc uniquement — un fichier route .xodr isolé n’est pas encore prévisualisable à lui seul.
• Les scénarios qui référencent un chemin au format Windows ou la carte intégrée d’un simulateur (plutôt qu’un .xodr dans le même dépôt) ne peuvent pas résoudre leur route automatiquement ; drawtonomy vous demandera d’en fournir une.
• Les boutons d’aperçu n’apparaissent pas encore dans les diffs « Files changed » des pull requests — ouvrez plutôt le fichier lui-même.

Vous pouvez changer l’URL de l’application depuis laquelle l’aperçu se charge, et activer l’aperçu automatique, depuis la page d’options de l’extension (popup de la barre d’outils → Options).

Sans l’extension

Tout ce que fait l’extension, vous pouvez aussi le faire avec un lien. Ajoutez une URL de fichier GitHub après ?open= :

https://drawtonomy.com/?open=https://github.com/esmini/esmini/blob/master/resources/xosc/cut-in.xosc

Ouvrir le scénario cut-in d’esmini →

Ce lien fonctionne pour tout le monde, extension ou non — utile pour partager un scénario avec un collègue. Voir Ouvrir et lire un .xosc.

Voir aussi

• Ouvrir et lire un .xosc — toutes les façons d’accéder à l’éditeur de scénario, y compris le glisser-déposer.
• Simuler un fichier OpenSCENARIO dans le navigateur — le lecteur en détail.
• Lecture — transport, caméra de suivi, fantômes et export vidéo.
• Qu’est-ce qu’esmini ?