Il telecomando OSC

OSC (Open Sound Control) è un linguaggio di comandi di rete molto usato nel mondo dello spettacolo: app per tablet, box con pulsanti programmabili, software di riproduzione di scalette o di video sanno inviare messaggi OSC. DreamShow li riceve per lanciare il Go, cambiare scena, fare il buio, forzare canali DMX… e rinvia il proprio stato (scena in corso, buio, Go possibile) ai dispositivi che gli scrivono, perché lo visualizzino.

Per aprirlo: menu DMX > Telecomando OSC….

Un messaggio OSC si compone di un indirizzo che somiglia a un percorso (/dreamshow/go) e, a volte, di argomenti (numeri o testo). Viaggia in UDP verso un indirizzo IP e una porta.

La finestra

• Attiva la ricezione OSC: mette DreamShow in ascolto. Disattivata per impostazione predefinita, perché apre una porta di rete.
• Solo da questo PC (127.0.0.1), ad esempio Companion installato qui: accetta solo i messaggi provenienti da un programma installato su questo stesso PC. I dispositivi della rete non possono più raggiungere DreamShow, e Windows non pone domande sul firewall.
• Porta di ascolto: la porta su cui DreamShow riceve, 8000 per impostazione predefinita.
• Porta di ritorno: la porta su cui DreamShow rinvia il proprio stato ai dispositivi, 9000 per impostazione predefinita.
• Ritorno anche verso (IP, facoltativo): un indirizzo IP a cui inviare lo stato in permanenza, anche se questo dispositivo non ha ancora inviato nulla. Vuoto = solo i dispositivi che hanno scritto.
• Applica: verifica i valori (porte da 1 a 65535, indirizzo IP valido), li salva e riavvia l'ascolto. Nulla cambia prima di Applica.
• La riga di stato: «OSC disattivato», oppure «OSC: in ascolto sulla porta 8000 — indirizzo di questo PC da indicare nel dispositivo: 192.168.1.10», oppure «OSC: la porta 8000 è già in uso o rifiutata (…)» se un altro programma occupa questa porta.
• Indirizzi riconosciuti: il promemoria dei comandi (dettagliati qui sotto).
• Messaggi ricevuti: gli ultimi messaggi arrivati (i 60 più recenti, il più recente in alto), con l'ora e l'indirizzo IP del mittente. Un indirizzo /dreamshow/… sconosciuto vi è segnalato con «indirizzo sconosciuto: …».
• Chiudi: chiude la finestra; l'ascolto continua.

Una volta attivato, l'ascolto OSC riparte automaticamente a ogni avvio di DreamShow.

I comandi ricevuti

Tutti gli indirizzi iniziano con /dreamshow/. Maiuscole e minuscole sono indifferenti, e una barra / finale è tollerata. I messaggi raggruppati («bundle» OSC) sono accettati; il loro timestamp viene ignorato, tutto viene eseguito subito.

Dettagli:

• Pulsanti (go, back, prev, pause, play, reset, tap): molti dispositivi inviano 1 alla pressione e 0 al rilascio. DreamShow agisce solo alla pressione: senza argomento, oppure con un valore di 0,5 o più. Un valore sotto 0,5 viene ignorato.
• Valori accettati: interi, numeri con la virgola, numeri scritti come testo e vero / falso (vero = 1).
• /dreamshow/scene n: il numero viene arrotondato; una scena inesistente viene ignorata.
• /dreamshow/fader u c v: universo e canale contati a partire da 1. Il valore v va da 0 a 255; se viene inviato come numero con la virgola tra 0.0 e 1.0 (caso di un fader di tablet), viene convertito da 0 a 255. Il canale viene preso come con DMX > Fader DMX…: passa davanti alla scaletta e al buio fino al suo rilascio.
• /dreamshow/release senza universo né canale (o con un solo numero, per esempio 1 inviato da un pulsante) restituisce tutti i canali.
• /dreamshow/key nome: il nome è un testo, quello del tasto atteso dal blocco, per esempio Space, A o F1. Vedere Le attese.

Comportamento a seconda della modalità:

• In modalità show (finestra della scaletta aperta): go parte solo se il Go è possibile (stessa regola del pulsante GO disattivato); back, prev e scene saltano alla scena senza dissolvenza e la fanno riprodurre.
• Nell'editor: go agisce come la barra spaziatrice (compreso l'effetto della casella Disinserisci l'auto-fade); back, prev e scene saltano alla scena senza cambiare lo stato riproduzione o pausa.
• pause, play e reset agiscono in entrambi i casi, anche durante uno spettacolo.
• live non cambia nulla all'uscita in modalità show: l'uscita vi è sempre attiva.

Il ritorno di stato

DreamShow rinvia il proprio stato:

• a ogni dispositivo che gli ha inviato un messaggio negli ultimi dieci minuti, all'indirizzo IP di quel dispositivo e sulla Porta di ritorno (9000 per impostazione predefinita, non la porta da cui il messaggio è partito);
• e, se è compilato, all'indirizzo Ritorno anche verso.

Lo invia dopo ogni comando ricevuto, e non appena lo stato cambia (verificato quattro volte al secondo). /dreamshow/refresh forza un invio completo.

Il testo «Pronto» segue la lingua dell'interfaccia.

Esempi

I passi qui sotto descrivono ciò che DreamShow si aspetta. Il modo di creare un pulsante o un messaggio in ciascuna applicazione dipende da quell'applicazione: consulti la sua documentazione.

Un tablet con TouchOSC

1. In DreamShow, spunti Attiva la ricezione OSC, lasci la porta 8000, Applica. Annoti l'indirizzo del PC visualizzato.
2. Nell'app del tablet, imposti la connessione OSC: host = l'indirizzo del PC, porta di invio = 8000, porta di ricezione = 9000.
3. Crei un pulsante che invia /dreamshow/go, un altro /dreamshow/back, un terzo /dreamshow/blackout.
4. Per un fader di intensità, gli faccia inviare /dreamshow/fader con gli argomenti universo, canale, poi il valore del fader (da 0.0 a 1.0).
5. Per mostrare il nome della scena, colleghi un'etichetta all'indirizzo /dreamshow/scene/name; per accendere il pulsante GO quando il Go è possibile, lo colleghi a /dreamshow/go/allowed.

Un box con pulsanti con Companion sullo stesso PC

1. In DreamShow, spunti Attiva la ricezione OSC e Solo da questo PC (127.0.0.1), ad esempio Companion installato qui, poi Applica.
2. In Companion, configuri l'invio OSC verso l'host 127.0.0.1, porta 8000.
3. Assegni a ogni tasto un messaggio: /dreamshow/go, /dreamshow/back, /dreamshow/blackout, /dreamshow/scene con il numero di scena…
4. Perché Companion riceva lo stato, lo faccia ascoltare sulla porta di ritorno (9000); DreamShow gli risponde non appena ha inviato un primo messaggio.

Lanciare il Go da una scaletta QLab

1. In DreamShow, attivi la ricezione OSC sulla porta 8000 (senza spuntare «Solo da questo PC» se QLab gira su un altro computer).
2. In QLab, crei un cue di rete che invia il messaggio OSC /dreamshow/go all'indirizzo del PC di DreamShow, porta 8000.
3. Collochi questo cue nella scaletta di QLab: ogni volta che parte, DreamShow fa un Go (se il Go è possibile in modalità show).
4. Per andare a una scena precisa: /dreamshow/scene 5.

   I nomi dei menu e delle impostazioni cambiano da una versione all'altra di TouchOSC, Companion o QLab: consulti la loro documentazione per sapere dove indicare l'indirizzo, la porta e il messaggio OSC. Dal lato DreamShow, contano solo l'indirizzo del PC, la porta (8000 per impostazione predefinita) e i messaggi elencati sopra.

Da sapere

• Al primo utilizzo, il firewall di Windows può chiedere di autorizzare DreamShow sulla rete: accetti, a meno che usi solo Solo da questo PC.
• L'elenco Messaggi ricevuti permette di verificare che un dispositivo stia davvero inviando, e che cosa: se non compare nulla, il problema è lato rete (indirizzo IP, porta, firewall).
• Gli stessi comandi servono ai controller MIDI e al telecomando web.
• L'audio-luce invia anch'esso i suoi Go automatici attraverso questo stesso percorso: obbediscono alle stesse regole.

Vedere anche

• Il telecomando web
• I controller MIDI
• La modalità show e la finestra della scaletta
• Valori DMX e fader DMX
• Le attese (tasto, ora, data, sole)