{"id":32527,"date":"2023-03-09T08:30:37","date_gmt":"2023-03-09T07:30:37","guid":{"rendered":"https:\/\/mimolive.com\/?post_type=user-manual&p=32527"},"modified":"2023-07-03T17:22:19","modified_gmt":"2023-07-03T15:22:19","slug":"strato-api-personalizzato","status":"publish","type":"user-manual","link":"https:\/\/mimolive.com\/it\/user-manual\/custom-layers\/custom-layer-api\/","title":{"rendered":"API del livello personalizzato"},"content":{"rendered":"

Protocollo versione 1.2<\/p>\n\n\n\n

Introduzione<\/h3>\n\n\n\n

mimoLive utilizza la tecnologia Quartz Composer di Apple e i suoi documenti per i livelli. Poich\u00e9 mimoLive deve comunicare al documento Quartz Composer alcuni parametri ambientali e leggerne i risultati, abbiamo progettato un protocollo da seguire per sfruttare tutte le funzionalit\u00e0 offerte da mimoLive. Di seguito sono riportate tutte le informazioni tecniche relative a questo protocollo.<\/p>\n\n\n\n

Se si desidera imparare a creare livelli personalizzati con Quartz Composer, leggere \"Creare livelli personalizzati per mimoLive\":en:pro:custom_layer:creating_custom_layers.<\/p>\n\n\n\n

Propriet\u00e0<\/h3>\n\n\n\n

\u00c8 possibile modificare il protocollo in Quartz Composer selezionando Editore<\/strong> \u21e2 Modifica delle informazioni<\/strong> (\u2325\u2318I)<\/p>\n\n\n\n

Nome<\/th>Richiesto<\/th>Tipo<\/th>Valore del campione<\/th><\/tr>
categoria<\/td><\/td>Stringa<\/td><\/td><\/tr>
copyright<\/td><\/td>Stringa<\/td>\u00a9 2016 MySoftwareCompany<\/td><\/tr>
descrizione<\/td><\/td>Stringa<\/td>Riproduce un input a schermo intero<\/td><\/tr>
nome<\/td>s\u00ec<\/td>Stringa<\/td>Lettore a schermo intero<\/td><\/tr>
DEPRECATO<\/strong> tv_Categorie<\/td><\/td>Stringa<\/td>Sfondo, schermo intero<\/td><\/tr>
tv_Debug<\/td><\/td>Booleano<\/td><\/td><\/tr>
tv_FileData_<\/a> nome dell'ingresso<\/td><\/td>Dati<\/td>(file XML importato)<\/td><\/tr>
tv_FileName_<\/a> nome dell'ingresso<\/td><\/td>Stringa<\/td>Classifiche.xml<\/td><\/tr>
tv_HelpURL<\/td><\/td>Stringa<\/td><\/td><\/tr>
tv_HiddenInputKeys<\/td><\/td>Array di stringhe<\/td><\/td><\/tr>
tv_InputLabel_<\/a> nome dell'ingresso<\/td><\/td>Stringa<\/td>Ingresso video<\/td><\/tr>
tv_LayerIdentifier<\/td>s\u00ec<\/td>Stringa<\/td>com.example.layer.mylayer<\/td><\/tr>
tv_LayerVersion<\/td>s\u00ec<\/td>Numero (reale)<\/td>1.01<\/td><\/tr>
tv_LayerPreview<\/td><\/td>Dati<\/td>(file PNG importato)<\/td><\/tr>
tv_LayerProtocolVersion<\/td>s\u00ec<\/td>Numero (reale)<\/td>1<\/td><\/tr>
tv_SortKey<\/td><\/td>Stringa<\/td><\/td><\/tr>
tv_StepSize_<\/a> nome dell'ingresso<\/td><\/td>Numero (reale)<\/td>0.1<\/td><\/tr>
DEPRECATO<\/strong> tv_Tagline<\/td><\/td>Stringa<\/td>Riproduce un input a schermo intero<\/td><\/tr>
tv_UseAudioFromSource<\/td><\/td>Stringa<\/td>tvIn_VideoSourceA<\/td><\/tr>
tv_UnitLabel_<\/a> nome dell'ingresso<\/td><\/td>Stringa<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

categoria<\/h4>\n\n\n\n

La categoria \u00e8 solitamente impostata dal compositore Quartz e non \u00e8 necessaria per i livelli mimoLive. Per le categorie di mimoLive vedere tv_Categorie<\/a> invece.<\/p>\n\n\n\n

copyright<\/h4>\n\n\n\n

Il copyright viene solitamente impostato dal compositore Quartz e non \u00e8 necessario per i livelli mimoLive.<\/p>\n\n\n\n

descrizione<\/h4>\n\n\n\n

Quartz Composer standard: mantenetelo lungo circa 3 righe, in modo che si adatti bene all'anteprima.<\/p>\n\n\n\n

nome<\/h4>\n\n\n\n

Il nome viene visualizzato all'interno di mimoLive. Utilizzare un nome breve e unico per trovare rapidamente il livello.<\/p>\n\n\n\n

protocolli<\/h4>\n\n\n\n

Questo array viene solitamente impostato dal compositore Quartz e non \u00e8 necessario per i livelli mimoLive.<\/p>\n\n\n\n

tv_Categorie<\/h4>\n\n\n\n

DEPRECATO<\/strong><\/p>\n\n\n\n

Le categorie venivano utilizzate per raggruppare e filtrare i livelli. Attualmente sono ignorate, ma possono essere riattivate. Utilizzare un elenco separato da virgole delle seguenti categorie predefinite o definirne di proprie.<\/p>\n\n\n\n

- Audio\" - Livelli che offrono la possibilit\u00e0 di utilizzare una sorgente audio.
- Overlay\" - Livelli che sovrappongono dati o immagini: Terzi inferiori, titolo, logo, ...
- Fullscreen\" - Livelli che, almeno tramite le impostazioni predefinite, offrono uno schermo intero, ad esempio animazioni, video singolo, mappa meteorologica.
- \"Backdrop\" - Livelli che funzionano come sfondo\/parte di sfondo per altri elementi in cima.
- Testo\" - Livelli che forniscono un qualche tipo di visualizzazione del testo, ad esempio Crediti, Terzi inferiori, Intestazioni.
- Dati\" - Livelli che visualizzano dati, ad esempio indici azionari, punteggi di basket, ecc.
- Immagine\" - Livelli che consentono di visualizzare un'immagine statica.
- Multivideo\" - Livelli che combinano almeno due sorgenti, aggiungendo almeno una sorgente in aggiunta ai livelli sottostanti o utilizzando due o pi\u00f9 sorgenti.
- 3D\" - Livelli che forniscono un qualche tipo di posizionamento 3D degli elementi, ad esempio Presentatore
- \"Segmento\" - Livelli che forniscono un'animazione temporizzata per separare i segmenti, ad esempio Digital Upgrade Beitrag
- \"Effetto\" - Livelli che forniscono alcuni effetti di sovrapposizione, ad esempio Lente d'ingrandimento, Riflettore, Zoom...
- \"Demo\" - Livelli che servono principalmente a dimostrare le capacit\u00e0 piuttosto che a fornire funzionalit\u00e0 utili generiche, ad esempio Mappa meteo, che mostra solo una mappa della Germania.
- Consumer\" - Livelli che utilizzano l'immagine composita, ad esempio Video Switcher, Zoom, Presenter.
- \"Generatore\" - Livelli che forniscono una sorta di output generato, ad esempio animazioni.
- Debug\" - Livelli utili per il debug che non sono visibili nel prodotto finale.<\/p>\n\n\n\n

tv_Debug<\/h4>\n\n\n\n

Indicare all'applicazione che questa composizione deve essere usata solo in un ambiente di debug.<\/p>\n\n\n\n

tv_FileData_<\/h4>\n\n\n\n

Un blob di dati che verr\u00e0 creato e scritto nel documento per un file di input alla creazione del livello. Questo funziona per i file di testo che saranno forniti in un _TypeFilePath o per i file .mov per gli input di immagini. Vedere tv_FileName_<\/a> .<\/p>\n\n\n\n

tv_FileName_<\/h4>\n\n\n\n

Il nome del file corrispondente al file tv_FileData_<\/a> . Richiesto se esiste un ingresso tv_FileData_* .<\/p>\n\n\n\n

tv_HelpURL<\/h4>\n\n\n\n

Questa stringa pu\u00f2 contenere un URL con informazioni utili sull'uso di questo livello. mimoLive presenter\u00e0 un pulsante \"?\" nel popover delle informazioni per ogni livello. Se l'utente fa clic su questo pulsante, l'URL verr\u00e0 aperto dal browser Internet predefinito del sistema.<\/p>\n\n\n\n

tv_HiddenInputKeys<\/h4>\n\n\n\n

In questo array, la composizione contiene le chiavi di input che devono essere nascoste dall'interfaccia utente.<\/p>\n\n\n\n

tv_InputLabel_<\/h4>\n\n\n\n

Pu\u00f2 essere usato per fornire un'etichetta di nome alternativa per la chiave di input data nella vista dei parametri. Sono possibili anche stringhe vuote per non avere etichette. Funziona come l'opzione tv_hide_ouput<\/a> Il nome dell'ingresso del protocollo deve essere completo (ad esempio, \"tv_InputLabel_tvIn_VideoSourceAImage\").<\/p>\n\n\n\n

tv_LayerIdentifier<\/h4>\n\n\n\n

Per l'identificazione, Boinx ha spedito composizioni e ordinato diverse versioni. Deve essere unico. Si consiglia un dominio con notazione inversa. Esempio: com.mysoftware.layers.videofullscreen<\/p>\n\n\n\n

tv_LayerVersion<\/h4>\n\n\n\n

Per abbinare versioni diverse di una composizione in un documento\/applicazione. I numeri di versione maggiore denotano incompatibilit\u00e0 e non corrispondono ad altre versioni maggiori (ad esempio, \u00e8 necessario aumentare la versione maggiore se il nome delle chiavi di input cambia). I numeri di versione minori devono essere compatibili verso l'alto e possono essere incrementati di 0,001 per ogni iterazione. Ad esempio, \u00e8 necessario garantire che il caricamento delle impostazioni da un livello 1.0 per un livello 1.013 abbia esattamente lo stesso aspetto, il che significa che le nuove chiavi, se presenti, devono avere un valore predefinito che non le mostri o che sia uguale all'aspetto della versione precedente.<\/p>\n\n\n\n

tv_LayerPreview<\/h4>\n\n\n\n

Dati immagine da usare per l'anteprima di un livello nell'elenco dei livelli. Questo pu\u00f2 offrire un'esperienza migliore rispetto all'anteprima rapida predefinita. L'immagine di anteprima deve essere di 256 \u00d7 256 pixel.<\/p>\n\n\n\n

tv_LayerProtocolVersion<\/h4>\n\n\n\n

Per la futura retrocompatibilit\u00e0 se mimoLive cambia il protocollo in modo significativo. Attualmente deve essere impostato su 1.<\/p>\n\n\n\n

tv_SortKey<\/h4>\n\n\n\n

Definisce l'ordinamento dei livelli in mimoLive. In questo modo \u00e8 possibile ordinare i filtri in base alla probabilit\u00e0 di utilizzo. Attualmente viene utilizzato uno schema di 2 lettere maiuscole, ad esempio \"BM\", \"DE\", \"DM\", ecc. NOTA: attualmente questa funzione non \u00e8 utilizzata, ma lo sar\u00e0 in futuro.<\/p>\n\n\n\n

tv_StepSize_<\/h4>\n\n\n\n

Pu\u00f2 essere utilizzato per fornire uno StepSize personalizzato per le rotelle jog - il movimento del mouse di un pixel corrisponde a questa quantit\u00e0 di cambiamento (anche +\/-click).<\/p>\n\n\n\n

tv_Tagline<\/h4>\n\n\n\n

DEPRECATO<\/strong>
Stringa di una riga che sar\u00e0 visualizzata nel popover delle informazioni nel repository dei layer.<\/p>\n\n\n\n

tv_UseAudioFromSource<\/h4>\n\n\n\n

Attualmente mimoLive pu\u00f2 mostrare un solo controllo audio nell'interfaccia utente. Questa propriet\u00e0 indica il tasto di ingresso da controllare. Inserire il tasto di ingresso completo corrispondente. (Per compatibilit\u00e0 questo campo accetta anche \"A\", \"B\" o \"C\", che vengono tradotti nelle chiavi tvIn_VideoSourceAImage, tvIn_VideoSourceBImage o tvIn_VideoSourceCImage. Se non viene fornito, mimoLive presume che non venga utilizzato alcun audio con questo livello.<\/p>\n\n\n\n

tv_UnitLabel_<\/h4>\n\n\n\n

Pu\u00f2 essere utilizzato per fornire un'etichetta unitaria, ad esempio \"pt\", per il tasto di input dato nella vista dei parametri. Mantenere il pi\u00f9 breve possibile. Aiuta a comunicare il significato dell'input. Gli input dell'unit\u00e0 Boinx riceveranno automaticamente l'etichetta \"px\".<\/p>\n\n\n\n

Ingressi<\/h3>\n\n\n\n
Nome<\/th>Tipo<\/th><\/tr>
tvIn_AccountTwitterConsumerKey<\/td>Stringa<\/td><\/tr>
tvIn_AccountTwitterConsumerSecret<\/td>Stringa<\/td><\/tr>
tvIn_AccountTwitterTokenKey<\/td>Stringa<\/td><\/tr>
tvIn_AccountTwitterTokenSecret<\/td>Stringa<\/td><\/tr>
tvIn_CompositedLayersImage<\/td>Immagine<\/td><\/tr>
tvIn_FrameCount<\/td>Indice<\/td><\/tr>
tvIn_FrameDuration<\/td>Numero<\/td><\/tr>
tvIn_CompositedLayersImage<\/td>Immagine<\/td><\/tr>
tvIn_InTransitionDirection<\/td>Indice Direzione di transizione<\/a> Direzione<\/td><\/tr>
tvIn_InTransitionDuration<\/td>Numero<\/td><\/tr>
tvIn_InTransitionType<\/td>Indice Tipo di transizione<\/a> Tipo<\/td><\/tr>
tvIn_KeyboardModifierAlt<\/td>Booleano<\/td><\/tr>
tvIn_KeyboardModifierCommand<\/td>Booleano<\/td><\/tr>
tvIn_KeyboardModifierControl<\/td>Booleano<\/td><\/tr>
tvIn_KeyboardModifierFunction<\/td>Booleano<\/td><\/tr>
tvIn_KeyboardModifierShift<\/td>Booleano<\/td><\/tr>
tvIn_Oscurato<\/td>Booleano<\/td><\/tr>
tvIn_OnAir<\/td>Booleano<\/td><\/tr>
tvIn_OSVersion<\/td>Stringa<\/td><\/tr>
tvIn_OutTransitionDirection<\/td>Indice Direzione di transizione<\/a> Direzione<\/td><\/tr>
tvIn_OutTransitionDuration<\/td>Numero<\/td><\/tr>
tvIn_OutTransitionType<\/td>Indice Tipo di transizione<\/a> Tipo<\/td><\/tr>
tvIn_PreviewMode<\/td>Booleano<\/td><\/tr>
tvIn_Reset<\/td>Booleano (segnale)<\/td><\/tr>
tvIn_RuntimeIdentifier<\/td>Stringa<\/td><\/tr>
tvIn_condiviso<\/td>qualsiasi tipo di valore<\/td><\/tr>
tvIn_ShowDuration<\/td>Numero<\/td><\/tr>
tvIn_ShowTimer<\/td>Numero<\/td><\/tr>
tvIn_Switch<\/td>Booleano (segnale)<\/td><\/tr>
tvIn_TransitionDirection<\/td>Indice Direzione di transizione<\/a> Direzione<\/td><\/tr>
tvIn_TransitionDuration<\/td>Numero<\/td><\/tr>
tvIn_TransitionType<\/td>Indice Tipo di transizione<\/a> Tipo<\/td><\/tr>
tvIn_UISnapColor<\/td>Colore<\/td><\/tr>
tvIn_VideoSourceA B C D<\/td>Immagine<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

tvIn_AccountTwitterConsumerKey<\/h4>\n\n\n\n

tvIn_AccountTwitterConsumerSecret<\/h4>\n\n\n\n

tvIn_AccountTwitterTokenKey<\/h4>\n\n\n\n

tvIn_AccountTwitterTokenSecret<\/h4>\n\n\n\n

Questi quattro input AccountTwitter sono usati per alimentare i dati di accesso dalle Preferenze account Twitter di mimoLive nella composizione. I valori sono usati con le patch JSON e OAuth per leggere i dati dal servizio Twitter.<\/p>\n\n\n\n

tvIn_CompositedLayersImage<\/h4>\n\n\n\n

Se questo ingresso \u00e8 presente in una composizione e c'\u00e8 del contenuto dai livelli sottostanti, il risultato del disegno dei livelli sottostanti verr\u00e0 inserito in questo ingresso.<\/p>\n\n\n\n

tvIn_FrameCount<\/h4>\n\n\n\n

Questo input otterr\u00e0 il conteggio totale dei fotogrammi renderizzati dopo l'avvio di mimoLive. Se i fotogrammi sono stati eliminati perch\u00e9 il carico di rendering \u00e8 troppo alto, il conteggio dei fotogrammi salter\u00e0 oltre i numeri dei fotogrammi eliminati.<\/p>\n\n\n\n

tvIn_FrameDuration<\/h4>\n\n\n\n

La durata del fotogramma \u00e8 l'intervallo di tempo tra ciascun rendering, espresso in secondi.<\/p>\n\n\n\n

tvIn_InTransitionDirection<\/h4>\n\n\n\n

Una direzione in cui verr\u00e0 eseguita la Direzione di transizione.<\/p>\n\n\n\n

tvIn_InTransitionDuration<\/h4>\n\n\n\n

Un valore in secondi per il tvIn_InTransitionType<\/a> sar\u00e0 eseguito.<\/p>\n\n\n\n

tvIn_InTransitionType<\/h4>\n\n\n\n

Se utile per un livello che consente all'utente di scegliere il tipo di transizione in corso. Vedere anche Tipo di transizione Tipo.<\/p>\n\n\n\n

tvIn_KeyboardModifierAlt<\/h4>\n\n\n\n

tvIn_KeyboardModifierCommand<\/h4>\n\n\n\n

tvIn_KeyboardModifierControl<\/h4>\n\n\n\n

tvIn_KeyboardModifierFunction<\/h4>\n\n\n\n

tvIn_KeyboardModifierShift<\/h4>\n\n\n\n

Questi campi di input booleani saranno impostati su true quando l'utente premer\u00e0 il tasto di modifica corrispondente sulla tastiera. Questa funzione \u00e8 utilizzata principalmente per la funzione di manipolazione diretta. Consultare le Linee guida per l'utente umano di Apple per vedere quale tasto modificatore deve essere usato per quale funzione nell'interfaccia utente.<\/p>\n\n\n\n

tvIn_Oscurato<\/h4>\n\n\n\n

Questo input \u00e8 impostato su true se il livello non ha bisogno di renderizzare alcun output perch\u00e9 un livello superiore lo oscurer\u00e0 comunque disegnando l'intero schermo. Questo pu\u00f2 essere usato per evitare un disegno pesante da parte di livelli che non sono visibili ma che sono impostati per essere attivi. (Ad esempio, nel caso del livello Twitter, il livello viene comunque richiamato anche quando \u00e8 oscurato da un altro livello sovrastante e ha la possibilit\u00e0 di mantenere la connessione Internet al servizio Twitter).<\/p>\n\n\n\n

tvIn_OnAir<\/h4>\n\n\n\n

Questo ingresso inizia con il valore \"true\". Una volta che l'input passa a \"false\", la composizione deve eseguire qualsiasi transizione in uscita, quindi impostare l'uscita Done al termine. La composizione sar\u00e0 quindi disattivata. Pu\u00f2 accadere che l'applicazione disattivi un livello senza attendere il flag done.<\/p>\n\n\n\n

tvIn_OSVersion<\/h4>\n\n\n\n

Questa stringa di input sar\u00e0 impostata sulla versione corrente di OS X (ad esempio, \"Versione 10.11.2 (Build 265341)\").<\/p>\n\n\n\n

tvIn_OutTransitionDirection<\/h4>\n\n\n\n

Un valore in secondi del valore tvIn_OutTransitionType<\/a> sar\u00e0 eseguito. Vedere anche Direzione della transizione.<\/p>\n\n\n\n

tvIn_OutTransitionDuration<\/h4>\n\n\n\n

Un valore in secondi del valore tvIn_OutTransitionType<\/a> sar\u00e0 eseguito.<\/p>\n\n\n\n

tvIn_OutTransitionType<\/h4>\n\n\n\n

Se utile per un livello che consente all'utente di scegliere il tipo di transizione in corso. Vedere anche Tipo di transizione Tipo.<\/p>\n\n\n\n

tvIn_PreviewMode<\/h4>\n\n\n\n

Pu\u00f2 essere utilizzato per indicare alla composizione che si trova in modalit\u00e0 anteprima.<\/p>\n\n\n\n

tvIn_Reset<\/h4>\n\n\n\n

Utile per ripristinare la Logica della composizione. Questo flag viene impostato quando un livello viene commutato in live da off o quando si passa da un'impostazione a un'altra. tvIn_Switch<\/a> \u00e8 disponibile l'ingresso.<\/p>\n\n\n\n

tvIn_RuntimeIdentifier<\/h4>\n\n\n\n

Aiuta i livelli a comunicare tra l'anteprima e l'istanza live. Impostato dinamicamente da mimoLive.<\/p>\n\n\n\n

tvIn_condiviso<\/h4>\n\n\n\n

Vedi Condivisione dei valori tra i livelli<\/a> Valori tra i livelli.<\/p>\n\n\n\n

tvIn_ShowDuration<\/h4>\n\n\n\n

Se l'utente ha compilato la durata dello spettacolo nelle Impostazioni spettacolo, questo input avr\u00e0 il valore in secondi.<\/p>\n\n\n\n

tvIn_ShowTimer<\/h4>\n\n\n\n

Il timer di visualizzazione rifletter\u00e0 la visualizzazione del timer di visualizzazione del documento mimoLive in secondi.<\/p>\n\n\n\n

tvIn_Switch<\/h4>\n\n\n\n

Questo flag viene impostato al posto di tvIn_Reset]] quando si passa da un'impostazione all'altra di un livello senza disabilitarlo. Nel caso in cui questo ingresso non esista, il [[#tvIn_Reset<\/a> quando un livello passa da un'impostazione a un'altra senza disabilitare il livello. Nel caso in cui questo ingresso non esista, al suo posto viene impostato [[#tvIn_Reset] per mantenere la compatibilit\u00e0 con i livelli pi\u00f9 vecchi.<\/p>\n\n\n\n

tvIn_TransitionDirection<\/h4>\n\n\n\n

Una direzione in cui il Direzione di transizione<\/a> sar\u00e0 eseguito.<\/p>\n\n\n\n

tvIn_TransitionDuration<\/h4>\n\n\n\n

Un valore in secondi del valore tvIn_InTransitionType<\/a> sar\u00e0 eseguito.<\/p>\n\n\n\n

tvIn_TransitionType<\/h4>\n\n\n\n

Se utile per un livello che consente all'utente di scegliere il tipo di transizione in corso. Vedere anche Tipo di transizione Tipo.<\/p>\n\n\n\n

tvIn_UISnapColor<\/h4>\n\n\n\n

Per mantenere l'interfaccia utente coerente, mimoLive fornisce un \"colore di snap\" in cui disegnare le linee guida nell'anteprima ogni volta che l'interfaccia utente si sposta su un determinato valore (ad esempio, tenendo premuto il tasto \"shift\" durante la rotazione di un livello Placer in modalit\u00e0 di visualizzazione personalizzata, le linee guida verranno disegnate in quel colore quando l'angolo di rotazione si sposta a 0, 45 o 90 gradi).<\/p>\n\n\n\n

tvIn_VideoSource<\/a><\/h4>\n\n\n\n

Un livello pu\u00f2 avere fino a 8 ingressi di sorgenti video dinamiche: \"A\", \"B\", \"C\" e cos\u00ec via. Saranno rappresentati da una zona di caduta se l'utente trascina una sorgente video dal repository delle sorgenti allo stack del livello. \/\/Nota: per compatibilit\u00e0 con le versioni precedenti, l'estensione \"Image\" di questi ingressi viene ignorata.\/\/<\/p>\n\n\n\n

Opzioni di ingresso<\/h3>\n\n\n\n

Tasti di ingresso corrispondenti<\/h4>\n\n\n\n

Se \u00e8 presente un tasto di ingresso video, anche i tasti di ingresso successivi vengono riempiti di informazioni:<\/p>\n\n\n\n

(ad esempio \"tvIn_VideoSourceA\" -> \"tvIn_VideoSourceAName\")<\/p>\n\n\n\n

Chiave<\/th>Tipo<\/th>Descrizione<\/th><\/tr>
AudioGain<\/td>Numero<\/td>TBD<\/td><\/tr>
Livello audio0<\/td>Numero<\/td>Livello del canale audio sinistro in db dopo il controllo del guadagno<\/td><\/tr>
Livello audio1<\/td>Numero<\/td>Livello del canale audio destro in db dopo il controllo del guadagno<\/td><\/tr>
Livello audio0Raw<\/td>Numero<\/td>Livello del canale audio sinistro in db prima del controllo del guadagno<\/td><\/tr>
AudioLevel1Raw<\/td>Numero<\/td>Livello del canale audio destro in db prima del controllo del guadagno<\/td><\/tr>
AudioPanning<\/td>Numero<\/td>TBD<\/td><\/tr>
Volume audio<\/td>Numero<\/td>TBD<\/td><\/tr>
Dati<\/td>Struttura<\/td>Un dizionario di metadati della sorgente. Attualmente, le chiavi implementate sono: \"index\" \"duration\" \"title\" \"titleFallback\" \"artist\" \"album\" \"year\" \"fileReferenceIdentifier\"<\/td><\/tr>
Nome<\/td>Stringa<\/td>Nome dell'origine immagine associata. Pu\u00f2 essere usato per visualizzare il nome nell'anteprima o per calcolare il nome predefinito per la variante di livello. Vedere tvOut_SettingName<\/a> .<\/td><\/tr>
Tempo rimanente<\/td>Numero<\/td>In secondi. Verr\u00e0 fornito per le sorgenti di filmati. -1 se la sorgente filmato \u00e8 in loop (o qualsiasi altra sorgente).<\/td><\/tr>
Stato di conteggio<\/td>Indice<\/td>Stato del conteggio della sorgente collegata, vedere Conteggio degli Stati<\/a> Stati<\/td><\/tr>
Tipo<\/td>Indice<\/td>Valore di tipo di fonte<\/a> tipo<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Raggruppamento degli ingressi<\/h4>\n\n\n\n

Il raggruppamento viene fornito nell'interfaccia utente; per questo \u00e8 importante il prefisso dell'input. La sintassi funziona come tvGroup___<\/strong>. Si noti il doppio trattino basso _ _ dopo il nome del gruppo come separatore dal nome dell'input.<\/p>\n\n\n\n

Un gruppo speciale \u00e8 definito per gli ingressi che devono essere sempre nascosti: tvGroup_Hidden_Inputs__<\/strong> Questo gruppo pu\u00f2 essere reso visibile passando mimoLive in modalit\u00e0 di debug nella cartella debug|Preferenze di debug<\/a>|Preferenze di debug. Alcuni livelli utilizzano questi campi nascosti per comunicare tra l'\"istanza di anteprima\" e l'\"istanza live\" (ad esempio, il livello Video Switcher comunica all'istanza di anteprima quale sorgente video \u00e8 attualmente live).<\/p>\n\n\n\n

Nascondere gli ingressi in modo dinamico<\/h4>\n\n\n\n

Ogni ingresso di protocollo sar\u00e0 nascosto nell'interfaccia utente se l'opzione tvOut_hide_<\/strong> L'uscita \u00e8 impostata su \"true\". Questo valore viene osservato dall'applicazione e pu\u00f2 essere modificato dinamicamente. Si noti che \u00e8 necessario utilizzare il nome completo dell'ingresso, compreso \"tvIn\" (ad esempio, utilizzare l'uscita tvOut_hide_tvIn_Text_TypeMultiline<\/strong> per l'ingresso tvIn_Text_TypeMultiline<\/strong>).<\/p>\n\n\n\n

Uscite<\/h3>\n\n\n\n
Nome<\/th>Tipo<\/th><\/tr>
tvOut_Cursor<\/td>Stringa<\/td><\/tr>
tvOut_Done<\/td>Booleano (segnale)<\/td><\/tr>
tvOut_hide_<\/td>Booleano<\/td><\/tr>
tvOut_Opaque<\/td>Booleano<\/td><\/tr>
tvOut_SettingName<\/td>Stringa<\/td><\/tr>
tvOut_Share_<\/td>qualsiasi tipo<\/td><\/tr>
tvOut_TimeRemaining<\/td>Numero<\/td><\/tr>
tvOut_UseCompositedLayersImage<\/td>Booleano<\/td><\/tr>
tvOut_TallyState<\/td>Indice di Conteggio degli Stati<\/a> Stati<\/td><\/tr>
tvSet_<\/td>Tipo di ingresso da impostare<\/td><\/tr>
tvSetSignal_<\/td>Booleano<\/td><\/tr>
tvSetAudioVolume_<\/td>Numero<\/td><\/tr>
tvSetAudioVolumeSegnale_<\/td>Booleano<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

tvOut_Cursor<\/h4>\n\n\n\n

Questa uscita specifica l'aspetto del cursore del mouse se il puntatore del mouse si trova sopra l'anteprima o la vista di output del programma. Fare riferimento a Documentazione della classe NSCursor di Apple<\/a>) per i valori validi. Altri cursori del mouse forniti da mimoLive sono \"meno\" e \"pi\u00f9\".<\/p>\n\n\n\n

*<\/em>Rimuovere il prefisso \"_Cursor\" o \"Cursor\" dalle costanti NSCursor di Apple (ad esempio, usare \"openHand\" per ottenere un cursore del mouse a mano aperta).<\/p>\n\n\n\n

tvOut_Done<\/h4>\n\n\n\n

Utilizzato per indicare al livello successivo che questo livello \u00e8 terminato. Vedere tvIn_OnAir<\/a> per la documentazione.<\/p>\n\n\n\n

tvOut_hide_<\/h4>\n\n\n\n

Pu\u00f2 essere utilizzato per nascondere dinamicamente i valori di input nella vista dei parametri. Vedere Nascondere gli ingressi in modo dinamico<\/a> .<\/p>\n\n\n\n

tvOut_Opaque<\/h4>\n\n\n\n

Utilizzato per indicare all'applicazione che i livelli inferiori a questo non devono essere disegnati. Valore predefinito \"false\". Questo valore viene sovrascritto da qualsiasi sorgente collegata che contenga alfa.<\/p>\n\n\n\n

tvOut_SettingName<\/h4>\n\n\n\n

Le composizioni possono suggerire un nome utile per un'ambientazione in base ad alcuni input.<\/p>\n\n\n\n

tvOut_Share_<\/h4>\n\n\n\n

Vedi Condivisione dei valori tra i livelli<\/a> .<\/p>\n\n\n\n

tvOut_TimeRemaining<\/h4>\n\n\n\n

Consente all'applicazione di visualizzare un grande conto alla rovescia (ad esempio, 5 secondi prima della fine di un filmato). Attualmente si usa \"-1\" per indicare che non ci sono informazioni sul tempo rimanente o \"-2\" se si tratta di un filmato in loop.<\/p>\n\n\n\n

tvOut_UseCompositedLayersImage<\/h4>\n\n\n\n

Utilizzato per ottimizzare le prestazioni quando si usano i livelli sottostanti con transizioni ecc. Indica all'applicazione che il livello attualmente ha bisogno dell'input dell'immagine dei livelli composti. mimoLive inserir\u00e0 i livelli sotto l'immagine composta nel ciclo di rendering successivo. Se \"tvOut_UseCompositedLayersImage\" non \u00e8 presente, mimoLive presume che i livelli sotto l'immagine debbano sempre essere inseriti. Si tratta solo di un'ottimizzazione del disegno, tutti i supporti saranno comunque arrotolati. Utilizzato solo se tvIn_CompositedLayersImage<\/a> \u00e8 presente.<\/p>\n\n\n\n

tvOut_TallyState<\/h4>\n\n\n\n

Questo livello di uscita pu\u00f2 sovrascrivere lo stato di tally automatico della sorgente attualmente collegata a quell'ingresso. Ci\u00f2 \u00e8 utile per le transizioni o se la sorgente non viene utilizzata per l'uscita, lo stato di conteggio pu\u00f2 essere disattivato (ad esempio, il Video Switcher utilizza 3 telecamere ma ne mostra solo una alla volta, quindi deve impostare lo stato di conteggio per le sorgenti non utilizzate su \"TVTallyStateOff\"). Vedere Conteggio degli Stati<\/a> per l'elenco degli stati di conteggio.<\/p>\n\n\n\n

tvSet_<\/h4>\n\n\n\n

In mimoLive, un livello o un filtro pu\u00f2 manipolare i propri parametri. Questo serve principalmente per implementare la funzione di manipolazione diretta nell'anteprima della variante del livello (ad esempio, se l'utente trascina l'orologio analogico nell'anteprima, il livello dice a mimoLive quali tasti di ingresso devono essere cambiati in quale valore. Tuttavia, questa funzione viene utilizzata anche per trasferire dati live dall'istanza di program out all'istanza di preview e viceversa (ad esempio, nel livello Video Switcher l'istanza di program out dice all'istanza di preview quale sorgente video \u00e8 attualmente live e l'istanza di preview pu\u00f2 dire all'istanza di program out quale sorgente video \u00e8 stata selezionata dall'utente sullo schermo).<\/p>\n\n\n\n

Per utilizzare questa funzione sono necessarie due uscite che corrispondono al campo di ingresso che si desidera manipolare: Con 'tvSet_' si emette il nuovo valore che si vuole impostare e con 'tvSetSignal_' si segnala quando il valore \u00e8 valido e deve essere memorizzato.<\/p>\n\n\n\n

tvSetSignal_<\/h4>\n\n\n\n

Vedi tvSet_<\/a> .<\/p>\n\n\n\n

tvSetAudioVolume_<\/h4>\n\n\n\n

Questa uscita controlla il volume della sorgente audio associata (o dell'audio di una sorgente video). I valori validi sono da 0=silenzioso a 1=pieno. la composizione deve impostare il corrispondente \"tvSetAudioVolumeSignal_\" ogni volta che vuole cambiare il livello del volume audio. Ad esempio, \u00e8 utile se il livello ha una transizione in dissolvenza e vuole anche l'audio in dissolvenza.<\/p>\n\n\n\n

tvSetAudioVolumeSegnale_<\/h4>\n\n\n\n

Vedi tvSetAudioVolume_<\/a> .<\/p>\n\n\n\n

Condivisione dei valori tra i livelli<\/h3>\n\n\n\n

Un livello pu\u00f2 inviare dati ad altri livelli dello stack di livelli che si trovano sopra di lui. I dati vengono memorizzati da mimolive tramite la sua chiave di condivisione fino al ciclo di rendering successivo. Se un livello viene usato pi\u00f9 volte (o la stessa chiave di condivisione viene usata in livelli diversi) i dati vengono sovrascritti dal livello superiore. Per impostare i dati di condivisione, utilizzare l'uscita \"tvOut_Share_\". \u00c8 possibile memorizzare qualsiasi tipo di dati di QuartzComposer, ma si consiglia di utilizzare una struct perch\u00e9 \u00e8 sufficiente un'uscita per pi\u00f9 valori. Sul lato del livello ricevente, \u00e8 necessario un ingresso corrispondente \"tvIn_Shared_\" con lo stesso tipo di dati. Si noti che il livello di ricezione deve trovarsi sopra il livello di invio nella pila dei livelli.<\/p>\n\n\n\n

La condivisione dei valori \u00e8 utile se si ha bisogno degli stessi dati in pi\u00f9 livelli (ad esempio, il nome dell'avversario di casa e di quello ospite in una partita).<\/p>\n\n\n\n

Definizioni dei tipi (alias convenzioni di denominazione)<\/h3>\n\n\n\n
Chiave<\/th>Tipo<\/th>Descrizione<\/th><\/tr>
*_TypeAudio<\/td>Immagine<\/td>Si tratta di un caso molto particolare: Un _TypeAudio pu\u00f2 assegnare solo sorgenti che contengono audio (ad esempio sorgenti di film, sorgenti video o sorgenti solo audio). Il livello avr\u00e0 il controllo su questa sorgente (in futuro) e sui valori del volume audio per i canali destro e sinistro tramite gli ingressi \"_TypeAudioAudioLevel0\" e \"_TypeAudioAudioLevel1\".<\/td><\/tr>
*_TipoBoinxX<\/td>Numero<\/td>Un numero inserito nelle coordinate X di Boinx, ad esempio -1 \u00e8 il primo pixel, 1 \u00e8 l'ultimo pixel delle dimensioni correnti dello schermo. sar\u00e0 presentato all'utente in pixel<\/td><\/tr>
*_TipoBoinxY<\/td>Numero<\/td>Un numero immesso in coordinate Boinx Y, ad esempio -1 \u00e8 il pixel inferiore, 1 \u00e8 il pixel superiore delle dimensioni correnti dello schermo. sar\u00e0 presentato all'utente in pixel<\/td><\/tr>
*_TypeDirectoryPath<\/td>Stringa<\/td>Il risultato \u00e8 un pulsante \"Scegli...\" nell'interfaccia utente, magari con la visualizzazione di un controllo di percorso.<\/td><\/tr>
*_TipoDurata<\/td>Numero<\/td>Tempo in secondi - sar\u00e0 visualizzato in minuti:secondi e pu\u00f2 avere un'interfaccia utente personalizzata.<\/td><\/tr>
*_TypeFilePath<\/td>Stringa<\/td>Il risultato \u00e8 un pulsante \"Scegli...\" nell'interfaccia utente, magari con la visualizzazione di un controllo di percorso.<\/td><\/tr>
*_TypeFontBoinxSize<\/td>Stringa<\/td>Dimensione del carattere in coordinate Boinx Y (ad esempio, 2 \u00e8 l'altezza dello schermo intero), vedere la nota seguente<\/td><\/tr>
*_TypeFontColor<\/td>Colore<\/td>Immissione regolare del colore per specificare il colore del testo, vedere la nota seguente<\/td><\/tr>
*_TypeFontName<\/td>Stringa<\/td>Si otterr\u00e0 cos\u00ec un selezionatore di caratteri, vedi nota seguente<\/td><\/tr>
*_TipoMultilinea<\/td>Stringa<\/td>Un campo di testo multilinea che consente l'inserimento del ritorno<\/td><\/tr>
*_TipoPassword<\/td>Stringa<\/td>Visualizza una casella di testo per la password. Importante: la password stessa \u00e8 memorizzata in testo normale e leggibile nel documento!<\/td><\/tr>
*_TipoSegnale<\/td>Booleano<\/td>Per un segnale pulsato a fotogramma singolo, utilizzare le patch Pulse o Watcher.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

*<\/em>I campi _TypeFontName, _TypeFontBoinxSize e _TypeFontColor vengono combinati in un unico elemento dell'interfaccia utente Font Chooser nella vista dei parametri dei livelli se hanno la stessa etichetta di base.<\/p>\n\n\n\n

Modelli di filtro<\/h3>\n\n\n\n

Questi input e propriet\u00e0 sono specifici per la creazione di una composizione Quartz da utilizzare come filtro immagine in mimoLive. La maggior parte delle definizioni precedenti si applicano anche ai filtri.<\/p>\n\n\n\n

Ingressi del filtro<\/h4>\n\n\n\n

I seguenti campi di input sono richiesti da Quartz Composer per la composizione di un filtro:<\/p>\n\n\n\n

Nome<\/th>Tipo<\/th>Descrizione<\/th><\/tr>
_protocolInput_PreviewMode<\/td>Bool<\/td>Pu\u00f2 essere utilizzato per indicare alla composizione che si trova in modalit\u00e0 anteprima.<\/td><\/tr>
_protocolloInput_X<\/td>Numero<\/td>\u00e8 sempre 0.<\/td><\/tr>
_protocolloInput_Y<\/td>Numero<\/td>\u00e8 sempre 0.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Propriet\u00e0 del filtro<\/h4>\n\n\n\n

Le seguenti propriet\u00e0 sono definite da mimoLive. tv_FilterIdentifier e tv_FilterVersion sono necessarie per gestire il filtro e il suo percorso di aggiornamento con le nuove versioni:<\/p>\n\n\n\n

Nome<\/th>Tipo<\/th>Valore del campione<\/th>Descrizione<\/th><\/tr>
tv_FilterIdentifier<\/td>Stringa<\/td>com.boinx.mimoLive.layer.placer<\/td>Per l'identificazione, Boinx ha spedito composizioni e ordinato diverse versioni<\/td><\/tr>
tv_FilterVersion<\/td>Numero (doppio)<\/td>1<\/td>Per far corrispondere versioni diverse di una composizione in un documento\/applicazione. I numeri di versione maggiore denotano incompatibilit\u00e0 e non corrispondono ad altre versioni maggiori. I numeri di versione minori devono essere compatibili verso l'alto e aumentano di 0,001 a ogni iterazione. Ad esempio, \u00e8 necessario garantire che il caricamento delle impostazioni da un livello 1.0 per un livello 1.013 abbia lo stesso aspetto, il che significa che le nuove chiavi, se presenti, devono avere un valore predefinito che non le mostri o che sia uguale all'aspetto della versione precedente.<\/td><\/tr>
tv_FilterOutputIsOpaque<\/td>BOOL<\/td><\/td>Determina se l'uscita di un filtro \u00e8 opaca. L'impostazione predefinita \u00e8 NO<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Enumerazioni<\/h3>\n\n\n\n

Il tipo Quartz Composer Index consente di creare indici denominati. Possono essere modificati nell'Editor di Quartz Composer aggiungendo uno splitter di ingresso in modalit\u00e0 indice.<\/p>\n\n\n\n

Tipo di fonte<\/h4>\n\n\n\n

La fonte sar\u00e0 uno dei seguenti valori<\/p>\n\n\n\n

- 0 - Immagine
- 1 - Filmato, un filmato avr\u00e0 un tempo residuo
- 2 - Macchina fotografica, potrebbe anche essere una composizione<\/p>\n\n\n\n

Direzione di transizione<\/h4>\n\n\n\n

\u00c8 possibile definire le proprie direzioni. I livelli spediti utilizzano i seguenti valori.<\/p>\n\n\n\n

- Nessuno
- A sinistra
- Diritto
- Su
- In basso<\/p>\n\n\n\n

Tipo di transizione<\/h4>\n\n\n\n

\u00c8 possibile definire i propri tipi di transizione. Ecco alcuni utili valori di esempio.<\/p>\n\n\n\n

- Sciogliere
- Asciugare<\/p>\n\n\n\n

Conteggio degli Stati<\/h4>\n\n\n\n

Sono stati definiti diversi Stati Tally per le sorgenti video, che saranno rappresentati nell'interfaccia utente e nell'applicazione companion Tally Light.<\/p>\n\n\n\n

- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = Programma TVTallyState<\/p>","protected":false},"excerpt":{"rendered":"

Protocol Version 1.2 Introduction mimoLive uses Apple\u2019s Quartz Composer technology and its documents for the layers. Because mimoLive needs to tell the Quartz Composer document some environmental parameters as well as reading results from them, we designed a protocol that you have to follow in order to take advantage of all the features mimoLive has […]<\/p>","protected":false},"author":3,"featured_media":0,"parent":32482,"menu_order":0,"template":"","meta":{"_acf_changed":false,"_angie_page":false,"_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[258],"tags":[],"class_list":["post-32527","user-manual","type-user-manual","status-publish","hentry","category-manual"],"acf":[],"_links":{"self":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32527","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual"}],"about":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/types\/user-manual"}],"author":[{"embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/users\/3"}],"version-history":[{"count":0,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32527\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/user-manual\/32482"}],"wp:attachment":[{"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/media?parent=32527"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/categories?post=32527"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mimolive.com\/it\/wp-json\/wp\/v2\/tags?post=32527"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}