Anteprima di file OpenSCENARIO su GitHub — l'estensione Chrome di drawtonomy

La maggior parte del lavoro su OpenSCENARIO comincia su GitHub. Gli scenari vivono in un repository e arrivano come pull request, e per capire cosa fa uno di essi di solito bisogna clonare il repository, configurare un simulatore ed eseguire il file solo per vedere il risultato.

drawtonomy for GitHub elimina tutto questo. È un’estensione Chrome gratuita che riproduce i file .xosc direttamente su github.com — niente download, niente installazione, niente simulatore.

Installa dal Chrome Web Store →

Anteprima degli scenari di esmini su GitHub, apertura di uno di essi nell'editor, modifica di un evento ed esportazione di una clip ritagliata.

Cosa fa

Dove funziona	github.com — pagine dei file ed elenchi delle cartelle
Cosa mostra in anteprima	File OpenSCENARIO .xosc in repository pubblici
Cosa risolve automaticamente	La rete stradale e i cataloghi veicoli richiesti dallo scenario
Cosa raccoglie	Niente — nessuna analitica, nessun account richiesto

Installazione

Installa drawtonomy for GitHub dal Chrome Web Store. Non c’è nulla da configurare né alcun account da creare. Visita una qualsiasi pagina GitHub con file .xosc ed è subito pronta all’uso.

Anteprima di uno scenario senza lasciare GitHub

Naviga verso un repository pubblico che contiene file OpenSCENARIO — per esempio esmini/esmini, la cui cartella resources/ contiene decine di scenari di esempio.

Ovunque compaia un file .xosc (o una cartella piena di essi) in un elenco GitHub, vedrai un piccolo chip di riproduzione ▶. Le cartelle che contengono scenari mostrano anche un conteggio, così sai quanti ce ne sono prima ancora di fare clic.

Fai clic su un chip e lo scenario si riproduce lì stesso — strada, veicoli e l’intera timeline degli eventi — in una finestra popup sopra la pagina.

Stai sfogliando un’intera cartella? Usa i pulsanti ◀ ▶ (o i tasti freccia) per passare allo scenario successivo senza chiudere l’anteprima. Fai clic sul nome del file in alto per saltare direttamente a qualsiasi scenario della cartella da un elenco, invece di scorrerli uno alla volta. Se un repository archivia uno scenario per ogni sottocartella, aprire il chip di una cartella percorre ogni scenario al suo interno e nelle sue sottocartelle in un’unica sequenza.

Aprire direttamente un file .xosc (invece di una cartella) mostra la stessa anteprima inline sulla pagina, accanto ai pulsanti Raw / Copy / Download di GitHub.

Scorciatoie da tastiera

Tasto	Azione
Esc	Chiude l’anteprima
← / →	Scenario precedente / successivo
↑ ↓	Scorre l’elenco di salto
Enter	Apre lo scenario selezionato

Aprirlo nell’editor completo

L’anteprima mostra cosa fa uno scenario. Quando vuoi modificarlo, fai clic su Open in drawtonomy per passare lo stesso scenario all’editor completo in una nuova scheda — la sua strada e gli eventuali cataloghi necessari sono già risolti, quindi è pronto a essere riprodotto immediatamente.

Il link su cui atterri è un normale URL condivisibile — chiunque può aprirlo, con o senza l’estensione.

Riproduci e segui l’azione

Una volta nell’editor, due impostazioni rendono uno scenario molto più facile da seguire:

• Follow: Ego mantiene la fotocamera bloccata sul veicolo ego, il che è utile per le strade importate che possono estendersi per chilometri.
• Ghost lascia una scia delle posizioni passate, così una manovra rapida come un cut-in si legge come un’unica immagine chiara invece di qualcosa da cogliere al volo.

Vedi Riproduzione per l’insieme completo dei controlli di riproduzione.

Modifica lo scenario

Uno scenario importato non è di sola lettura. Fai clic su una qualsiasi scheda evento per aprire l’editor di evento e cambiarne il trigger o l’azione, poi riproduci per vedere il nuovo comportamento.

Vedi Azioni e Trigger per cosa fa ciascuna opzione.

Esporta una clip solo della parte che conta

Raramente serve l’intera esecuzione — spesso bastano i pochi secondi in cui succede qualcosa di interessante. Export video registra esattamente quello come file .webm, pronto da inserire in un commento di pull request, un ticket o una presentazione di revisione.

Imposta Range su Trim, trascina le due maniglie sulla barra di ricerca fino al momento desiderato e fai clic su Start. Puoi anche scegliere le proporzioni, se la fotocamera segue il veicolo ego o inquadra l’intera scena, e se includere le scie ghost nella registrazione.

Privacy

L’estensione non raccoglie nulla — nessuna analitica, nessun account, niente inviato a un server proprio. Visualizzare in anteprima un file equivale ad aprire quello scenario su drawtonomy.com in una nuova scheda. Dettagli completi: Informativa sulla privacy dell’estensione Chrome.

Cose da sapere

• Solo repository pubblici. I repository privati non sono supportati.
• Solo file .xosc — un file strada .xodr isolato non è ancora visualizzabile in anteprima da solo.
• Gli scenari che fanno riferimento a un percorso in stile Windows o alla mappa integrata di un simulatore (invece di un .xodr nello stesso repository) non possono risolvere la loro strada automaticamente; drawtonomy ti chiederà di fornirne uno.
• I pulsanti di anteprima al momento non compaiono nei diff “Files changed” delle pull request — apri direttamente il file invece.

Puoi cambiare l’URL dell’app da cui carica l’anteprima, e attivare l’anteprima automatica, dalla pagina delle opzioni dell’estensione (popup della barra degli strumenti → Options).

Senza l’estensione

Tutto ciò che fa l’estensione, puoi farlo anche con un link. Aggiungi un URL di file GitHub a ?open=:

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

Apri lo scenario cut-in di esmini →

Quel link funziona per chiunque, con o senza estensione — utile quando condividi uno scenario con un collega. Vedi Aprire e riprodurre un .xosc.

Vedi anche

• Aprire e riprodurre un .xosc — ogni percorso verso l’editor di scenari, incluso il trascinamento.
• Simulare un file OpenSCENARIO nel browser — il lettore approfondito.
• Riproduzione — trasporto, fotocamera di follow, ghost ed esportazione video.
• Che cos’è esmini?