Vlastní rozhraní API vrstvy

Protokol verze 1.2

Úvod

MimoLive používá pro vrstvy technologii Quartz Composer společnosti Apple a její dokumenty. Protože mimoLive potřebuje sdělit dokumentu Quartz Composer některé parametry prostředí a také z nich číst výsledky, navrhli jsme protokol, který musíte dodržovat, abyste mohli využívat všechny funkce, které mimoLive nabízí. V následujícím textu najdete veškeré technické informace o tomto protokolu.

Pokud se chcete naučit vytvářet vlastní vrstvy pomocí nástroje Quartz Composer, přečtěte si článek "Vytváření zákaznických vrstev pro mimoLive":cs:pro:custom_layer:creating_custom_layers.

Vlastnosti

Protokol můžete upravit v nástroji Quartz Composer výběrem možnosti Editor ⇢ Upravit informace (⌥⌘I)

Název	Požadované	Typ	Hodnota vzorku
kategorie		Řetězec
autorská práva		Řetězec	© 2016 MySoftwareCompany
popis		Řetězec	Přehraje vstup na celou obrazovku
název	ano	Řetězec	Přehrávač na celou obrazovku
ODSTRANĚNO tv_kategorie		Řetězec	Pozadí,Celá obrazovka
tv_Debug		Boolean
tv_FileData_ vstupní název-		Data	(importovaný soubor XML)
tv_FileName_ vstupní název-		Řetězec	Pořadí.xml
tv_HelpURL		Řetězec
tv_HiddenInputKeys		Pole řetězců
tv_InputLabel_ vstupní název-		Řetězec	Vstup videa
tv_LayerIdentifier	ano	Řetězec	com.example.layer.mylayer
tv_LayerVersion	ano	Číslo (skutečné)	1.01
tv_LayerPreview		Data	(importovaný soubor PNG)
tv_LayerProtocolVersion	ano	Číslo (skutečné)	1
tv_SortKey		Řetězec
tv_StepSize_ vstupní název-		Číslo (skutečné)	0.1
ODSTRANĚNO tv_Tagline		Řetězec	Přehraje vstup na celou obrazovku
tv_UseAudioFromSource		Řetězec	tvIn_VideoSourceA
tv_UnitLabel_ vstupní název-		Řetězec

kategorie

Kategorii obvykle nastavuje Quartz composer a pro vrstvy mimoLive není potřeba. Kategorie mimoLive viz tv_kategorie místo toho.

autorská práva

Autorská práva obvykle nastavuje Quartz composer a pro vrstvy mimoLive nejsou potřeba.

popis

Standard Quartz Composer - nechte ho dlouhý asi 3 řádky, aby se dobře vešel do náhledu.

název

Název se zobrazuje uvnitř mimoLive. Použijte krátký a jedinečný název, abyste svou vrstvu rychle našli.

protokoly

Toto pole obvykle nastavuje Quartz composer a pro vrstvy mimoLive není potřeba.

tv_kategorie

ODSTRANĚNO

Kategorie byly použity k seskupování a filtrování vrstev. V současné době jsou ignorovány, ale mohou být opět aktivovány. Použijte čárkou oddělený seznam následujících předdefinovaných kategorií nebo definujte vlastní.

- "Audio" - Vrstvy umožňující použití zdroje zvuku
- "Overlay" - vrstvy, které překrývají data nebo obrázky: Lower Thirds, Název, Logo, ...
- "Na celou obrazovku" - vrstvy, které alespoň ve výchozím nastavení poskytují zobrazení na celou obrazovku - např. animace, jednotlivá videa, mapa počasí.
- "Pozadí" - Vrstvy, které slouží jako pozadí/pozadí pro další věci na povrchu.
- "Text" - vrstvy, které zobrazují nějaký druh textu, např. Credits, Lower Thirds, Heading.
- "Data" - vrstvy, které zobrazují data, např. burzovní tikety, výsledky basketbalu atd.
- "Image" - Vrstvy, které umožňují zobrazení pomocí statického vstupního obrázku.
- "Multivideo" - Vrstvy, které kombinují alespoň dva zdroje, a to buď přidáním alespoň jednoho zdroje navíc k vrstvám pod nimi, nebo použitím dvou či více zdrojů.
- "3D" - Vrstvy, které poskytují určitý druh 3d umístění prvků, např. Presenter.
- "Segment" - Vrstvy, které poskytují časovanou animaci pro oddělené segmenty, např. Digital Upgrade Beitrag
- "Efekt" - vrstvy, které poskytují některé překryvné efekty, např. lupu, bodové světlo, zvětšení...
- "Demo" - Vrstvy, které slouží spíše k demonstraci možností než k poskytování obecných užitečných funkcí, např. Mapa počasí, která zobrazuje pouze mapu Německa.
- "Spotřebitel" - vrstvy, které používají složenýobrázek vrstvy, např. přepínač videa, zvětšení, prezentér.
- "Generátor" - Vrstvy, které poskytují nějaký druh generovaného výstupu, např. animace.
- "Debug" - Vrstvy užitečné pro ladění, které nejsou v konečném produktu viditelné.

tv_Debug

Říká aplikaci, že toto složení by mělo být použito pouze v prostředí pro ladění.

tv_FileData_

Datový blob, který se vytvoří a zapíše do dokumentu pro vstupní soubor při vytváření vrstvy. To funguje pro textové soubory, které budou zadány v _TypeFilePath, nebo soubory .mov pro obrazové vstupy. Viz tv_FileName_ .

tv_FileName_

Odpovídající název souboru tv_FileData_ . Povinné, pokud existuje vstup tv_FileData_*.

tv_HelpURL

V tomto řetězci může být uložena adresa URL s užitečnými informacemi o tom, jak tuto vrstvu používat. mimoLive zobrazí v informačním okně pro každou vrstvu tlačítko "?". Pokud uživatel na toto tlačítko klikne, otevře se URL adresa ve výchozím internetovém prohlížeči systému.

tv_HiddenInputKeys

V tomto poli jsou uloženy vstupní klíče, které mají být skryty před uživatelským rozhraním.

tv_InputLabel_

Lze použít k zadání alternativního názvu pro daný vstupní klíč v zobrazení parametrů. Možné jsou také prázdné řetězce pro žádné popisky. Funguje stejně jako tv_hide_ouput , např. název vstupu protokolu musí být úplný (např. "tv_InputLabel_tvIn_VideoSourceAImage").

tv_LayerIdentifier

Pro identifikaci Boinx dodával složení a třídění různých verzí. Musí být jedinečné. Doporučuje se doména s reverzním zápisem. Příklad: com.mysoftware.layers.videofullscreen

tv_LayerVersion

Pro porovnávání různých verzí složení v dokumentu/aplikaci. Čísla hlavních verzí označují nekompatibilitu a neshodují se s jinými hlavními verzemi (např. je třeba zvýšit hlavní verzi, pokud se změní název vstupních klíčů). Čísla menších verzí musí být kompatibilní směrem nahoru a mohou být zvyšována o 0,001 pro každou iteraci. Např. musí být zajištěno, že načtení nastavení z vrstvy 1.0 pro 1.013 musí vypadat úplně stejně, což znamená, že nové klíče, pokud jsou přítomny, musí mít výchozí hodnotu, která je nezobrazuje nebo se rovná vzhledu předchozí verze.

tv_LayerPreview

Obrázková data, která se použijí pro náhled vrstvy v seznamu vrstev. To může přinést lepší zážitek než výchozí rychlý náhled. Náhledový obrázek by měl mít velikost 256 × 256 pixelů.

tv_LayerProtocolVersion

Pro budoucí zpětnou kompatibilitu, pokud mimoLive výrazně změní protokol. V současné době musí být nastaveno na 1.

tv_SortKey

Definuje třídění vrstev v mimoLive. Filtry tak můžete třídit podle pravděpodobnosti použití. V současné době se používá schéma 2 velkých písmen, např. "BM", "DE", "DM" atd. POZNÁMKA: V současné době se tato funkce nepoužívá, ale v budoucnu se používat bude.

tv_StepSize_

Lze použít k zadání vlastní velikosti kroku StepSize pro jog wheels - této velikosti změny pak odpovídá pohyb myši o jeden pixel (také +/- kliknutí).

tv_Tagline

ODSTRANĚNO
Jednořádkový řetězec, který se zobrazí ve vyskakovacím okně s informacemi v úložišti vrstev.

tv_UseAudioFromSource

MimoLive v současné době umí v uživatelském rozhraní zobrazit pouze jeden ovládací prvek zvuku. Tato vlastnost mu říká, která vstupní klávesa je ta, která má být ovládána. Vyplňte kompletní odpovídající vstupní klávesu. (Kvůli zpětné kompatibilitě toto pole akceptuje také "A", "B" nebo "C", což se překládá na klíč tvIn_VideoSourceAImage, tvIn_VideoSourceBImage nebo tvIn_VideoSourceCImage. Pokud není uveden, mimoLive předpokládá, že s touto vrstvou nebude použit žádný zvuk.

tv_UnitLabel_

Lze použít k zadání označení jednotky, např. "pt" pro daný vstupní klíč v zobrazení parametrů. Buďte co nejkratší. Pomůže sdělit, co vstup znamená. Jednotkové vstupy Boinx dostanou automatické označení "px".

Vstupy

Název	Typ
tvIn_AccountTwitterConsumerKey	Řetězec
tvIn_AccountTwitterConsumerSecret	Řetězec
tvIn_AccountTwitterTokenKey	Řetězec
tvIn_AccountTwitterTokenSecret	Řetězec
tvIn_CompositedLayersImage	Obrázek
tvIn_FrameCount	Index
tvIn_FrameDuration	Číslo
tvIn_CompositedLayersImage	Obrázek
tvIn_InTransitionDirection	Index Směr přechodu Směr
tvIn_InTransitionDuration	Číslo
tvIn_InTransitionType	Index Typ přechodu Typ
tvIn_KeyboardModifierAlt	Boolean
tvIn_KeyboardModifierCommand	Boolean
tvIn_KeyboardModifierControl	Boolean
tvIn_KeyboardModifierFunction	Boolean
tvIn_KeyboardModifierShift	Boolean
tvIn_Obscured	Boolean
tvIn_OnAir	Boolean
tvIn_OSVersion	Řetězec
tvIn_OutTransitionDirection	Index Směr přechodu Směr
tvIn_OutTransitionDuration	Číslo
tvIn_OutTransitionType	Index Typ přechodu Typ
tvIn_PreviewMode	Boolean
tvIn_Reset	Boolean (Signál)
tvIn_RuntimeIdentifier	Řetězec
tvIn_Shared_	libovolný typ hodnoty
tvIn_ShowDuration	Číslo
tvIn_ShowTimer	Číslo
tvIn_Switch	Boolean (Signál)
tvIn_TransitionDirection	Index Směr přechodu Směr
tvIn_TransitionDuration	Číslo
tvIn_TransitionType	Index Typ přechodu Typ
tvIn_UISnapColor	Barva
tvIn_VideoSourceA B C D	Obrázek

tvIn_AccountTwitterConsumerKey

tvIn_AccountTwitterConsumerSecret

tvIn_AccountTwitterTokenKey

tvIn_AccountTwitterTokenSecret

Tyto čtyři vstupy AccountTwitter slouží k zadávání přihlašovacích údajů z předvoleb účtu mimoLive Twitter do kompozice. Tyto hodnoty se používají s patchem JSON a patchem OAuth, aby bylo možné načíst data ze služby Twitter.

tvIn_CompositedLayersImage

Pokud je tento vstup přítomen ve složení a existuje obsah z vrstev pod ním, bude do tohoto vstupu přiveden výsledek kreslení těchto vrstev pod ním.

tvIn_FrameCount

Tímto vstupem získáte celkový počet vykreslených snímků po spuštění mimoLive. Pokud byly snímky vypuštěny z důvodu příliš vysokého zatížení vykreslování, počet snímků přeskočí čísla těchto vypuštěných snímků.

tvIn_FrameDuration

Doba trvání snímku je časový interval mezi jednotlivými vykresleními v sekundách.

tvIn_InTransitionDirection

Směr, ve kterém bude proveden Směr přechodu.

tvIn_InTransitionDuration

Hodnota v sekundách, kterou tvIn_InTransitionType bude provedeno.

tvIn_InTransitionType

Pokud je to užitečné pro vrstvu, která umožňuje uživateli vybrat typ probíhajícího přechodu. Viz také Typ přechodu.

tvIn_KeyboardModifierAlt

tvIn_KeyboardModifierCommand

tvIn_KeyboardModifierControl

tvIn_KeyboardModifierFunction

tvIn_KeyboardModifierShift

Tato logická vstupní pole budou nastavena na hodnotu true, když uživatel stiskne příslušnou modifikační klávesu na klávesnici. Tato funkce se používá především pro funkci přímé manipulace. Informace o tom, která modifikátorová klávesa má být použita pro kterou funkci v uživatelském rozhraní, naleznete v řádcích příručky Apple Human User Guide.

tvIn_Obscured

Tento vstup je nastaven na hodnotu true, pokud vrstva nepotřebuje vykreslit žádný výstup, protože vrstva nad ní ji stejně zakryje vykreslením celé obrazovky. Toho lze využít, aby se zabránilo silnému vykreslování vrstvami, které nejsou viditelné, ale jsou nastaveny jako živé. (Např. v případě vrstvy Twitter se vrstva stále volá, i když je zakryta jinou vrstvou nad ní, a má možnost udržovat internetové připojení ke službě Twitter).

tvIn_OnAir

Tento vstup začíná hodnotou "true". Jakmile vstup přejde na hodnotu "false", kompozice by měla provést jakýkoli odchozí přechod a po jeho dokončení nastavit výstup Hotovo. Kompozice bude poté deaktivována. Může se stát, že aplikace vypne vrstvu, aniž by čekala na příznak Done.

tvIn_OSVersion

Tento vstupní řetězec bude nastaven na aktuální verzi systému OS X (např. "Version 10.11.2 (Build 265341)").

tvIn_OutTransitionDirection

Hodnota v sekundách tvIn_OutTransitionType bude provedeno. Viz také část Směr přechodu.

tvIn_OutTransitionDuration

Hodnota v sekundách tvIn_OutTransitionType bude provedeno.

tvIn_OutTransitionType

Pokud je to užitečné pro vrstvu, která umožňuje uživateli vybrat typ probíhajícího přechodu. Viz také Typ přechodu.

tvIn_PreviewMode

Lze použít k upozornění kompozice, že je v režimu náhledu.

tvIn_Reset

Slouží k obnovení funkce Logika kompozice. Tento příznak se nastaví, když se vrstva přepne z vypnutého stavu na živý nebo když se přepíná mezi nastavením a žádným nastavením. tvIn_Switch je k dispozici vstup.

tvIn_RuntimeIdentifier

Pomáhá vrstvám komunikovat mezi náhledem a živou instancí. Nastavuje se dynamicky pomocí mimoLive.

tvIn_Shared_

Viz . Sdílení hodnot mezi vrstvami Hodnoty mezi vrstvami.

tvIn_ShowDuration

Pokud uživatel vyplnil dobu trvání pořadu v Nastavení pořadu, bude mít tento údaj hodnotu v sekundách.

tvIn_ShowTimer

Časovač zobrazení bude odrážet zobrazení časovače zobrazení v dokumentu mimoLive v sekundách.

tvIn_Switch

Tento příznak je nastaven místo tvIn_Reset]], když je vrstva přepnuta z jednoho nastavení na druhé, aniž by byla vypnuta. V případě, že tento vstup neexistuje, [[#tvIn_Reset když se vrstva přepne z jednoho nastavení na druhé, aniž by se vrstva deaktivovala. V případě, že tento vstup neexistuje, nastaví se místo něj [[#tvIn_Reset, aby byla zachována kompatibilita se staršími vrstvami.

tvIn_TransitionDirection

Směr, kterým se Směr přechodu bude provedeno.

tvIn_TransitionDuration

Hodnota v sekundách tvIn_InTransitionType bude provedeno.

tvIn_TransitionType

Pokud je to užitečné pro vrstvu, která umožňuje uživateli vybrat typ probíhajícího přechodu. Viz také Typ přechodu.

tvIn_UISnapColor

Aby bylo uživatelské rozhraní konzistentní, poskytuje mimoLive "barvu přichycení", ve které se vykreslují vodítka v náhledu, kdykoli se uživatelské rozhraní přichytí na určitou hodnotu (např. podržte klávesu "shift" při otáčení vrstvy Placer v režimu vlastního zobrazení, pak se vodítka vykreslí v této barvě, když se úhel otočení přichytí na 0, 45 nebo 90 stupňů).

tvIn_VideoSource

Vrstva může mít až 8 dynamických vstupů zdroje videa: "A", "B", "C" atd. Ty budou reprezentovány zónou pro upuštění, pokud uživatel přetáhne zdroj videa z úložiště zdrojů do zásobníku vrstvy. /Poznámka: Kvůli zpětné kompatibilitě se rozšíření "Image" na těchto vstupech ignoruje.

Možnosti vstupu

Odpovídající vstupní klávesy

Pokud je přítomna vstupní klávesa videa, budou odpovídajícím způsobem vyplněny i následující vstupní klávesy:

(např. "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")

Klíč	Typ	Popis
AudioGain	Číslo	TBD
AudioLevel0	Číslo	Úroveň levého zvukového kanálu v db po regulaci zisku
AudioLevel1	Číslo	Úroveň pravého zvukového kanálu v db po regulaci zisku
AudioLevel0Raw	Číslo	Úroveň levého zvukového kanálu v db před řízením zisku
AudioLevel1Raw	Číslo	Úroveň pravého zvukového kanálu v db před řízením zisku
AudioPanning	Číslo	TBD
AudioVolume	Číslo	TBD
Data	Struktura	Slovník metadat zdroje. V současné době jsou implementovány tyto klíče: "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier"
Název	Řetězec	Název přidruženého zdroje obrázků. Lze použít pro zobrazení jeho názvu v náhledu nebo pro výpočet výchozího názvu varianty vrstvy. Viz . tvOut_SettingName .
Zbývající čas	Číslo	Za několik sekund. Bude poskytnuta pro filmové zdroje. -1, pokud je zdroj filmu ve smyčce (nebo jakýkoli jiný zdroj).
TallyState	Index	Tally Stav připojeného zdroje, viz Sčítací státy Státy
Typ	Index	Hodnota typ zdroje typ

Seskupování vstupů

Seskupování je zajištěno v uživatelském rozhraní - pro toto seskupení je důležitý prefix vstupu. Syntaxe funguje takto tvGroup___. Všimněte si dvojitého podtržítka _ _ za názvem skupiny jako oddělovače názvu vstupu.

Pro vstupy, které mají být vždy skryté, je definována zvláštní skupina: tvGroup_Hidden_Inputs__ Tuto skupinu lze zviditelnit přepnutím mimoLive do režimu ladění v příkazu ladění|Předvolby ladění|Předvolby ladění. Některé vrstvy používají tato skrytá pole ke komunikaci mezi "instancí náhledu" a "instancí živého vysílání" (např. vrstva Přepínač videa říká instanci náhledu, který zdroj videa je právě živé vysílání).

Dynamické skrývání vstupů

Každý vstup protokolu se v uživatelském rozhraní skryje, pokud se tvOut_hide_ Výstup je nastaven na hodnotu "true". Tuto hodnotu sleduje aplikace a lze ji dynamicky měnit. Všimněte si, že je třeba použít celý název vstupu, včetně "tvIn" (např. použít výstupní tvOut_hide_tvIn_Text_TypeMultiline pro vstup tvIn_Text_TypeMultiline).

Výstupy

Název	Typ
tvOut_Cursor	Řetězec
tvOut_Done	Boolean (Signál)
tvOut_hide_	Boolean
tvOut_Opaque	Boolean
tvOut_SettingName	Řetězec
tvOut_Share_	jakýkoli typ
tvOut_TimeRemaining	Číslo
tvOut_UseCompositedLayersImage	Boolean
tvOut_TallyState	Rejstřík Sčítací státy Státy
tvSet_	Typ vstupu, který se má nastavit
tvSetSignal_	Boolean
tvSetAudioVolume_	Číslo
tvSetAudioVolumeSignal_	Boolean

tvOut_Cursor

Tento výstup určuje vzhled kurzoru myši, pokud je ukazatel myši nad náhledem nebo výstupním zobrazením programu. Viz Dokumentace třídy Apples NSCursor) pro platné hodnoty. Další kurzory myši, které mimoLive nabízí, jsou "minus" a "plus".

*Odstranění postfixu "_Cursor" nebo "Cursor" z konstant NSCursor společnosti Apple (např. pro získání kurzoru myši s otevřenou rukou použijte "openHand").

tvOut_Done

Slouží k oznámení další vrstvě, že tato vrstva je hotová. Viz tvIn_OnAir pro dokumentaci.

tvOut_hide_

Lze použít k dynamickému skrývání vstupních hodnot v zobrazení parametrů. Viz Dynamické skrývání vstupů .

tvOut_Opaque

Slouží k tomu, aby aplikace věděla, že vrstvy pod touto vrstvou se nemusí vykreslovat. Výchozí hodnota "false". Tato hodnota je nadřazena jakémukoli připojenému zdroji, který obsahuje alfa.

tvOut_SettingName

Kompozice mohou na základě některých vstupních údajů navrhnout užitečný název nastavení.

tvOut_Share_

Viz . Sdílení hodnot mezi vrstvami .

tvOut_TimeRemaining

Umožňuje aplikaci zobrazit velký časový odpočet (např. 5 sekund do konce filmu). V současné době se používá "-1" pro označení, že není k dispozici žádná informace o zbývajícím čase, nebo "-2", pokud se jedná o film ve smyčce.

tvOut_UseCompositedLayersImage

Slouží k optimalizaci výkonu při použití vrstev pod sebou s přechody atd. Říká aplikaci, že vrstva aktuálně potřebuje vstupní obrázek složených vrstev. mimoLive vloží vrstvy pod složený obrázek v dalším cyklu vykreslování. Pokud není příkaz "tvOut_UseCompositedLayersImage" přítomen, mimoLive předpokládá, že vrstvy pod obrázkem mají být vloženy vždy. Pouze optimalizace kreslení, všechna média budou přesto přetočena. Používá se pouze v případě, že tvIn_CompositedLayersImage je přítomen.

tvOut_TallyState

Tato výstupní vrstva může přepsat automatický stav tally zdroje, který je aktuálně připojen k danému vstupu. To je užitečné pro přechody nebo pokud se zdroj nepoužívá pro výstup, lze stav tally vypnout (např. přepínač videa používá 3 kamery, ale zobrazuje vždy jen jednu, takže je třeba nastavit stav tally pro nepoužívané zdroje na "TVTallyStateOff"). Viz Sčítací státy pro seznam sčítacích stavů.

tvSet_

V mimoLive může vrstva nebo filtr manipulovat s vlastními parametry. To slouží především k implementaci funkce přímé manipulace v náhledu varianty vrstvy (např. pokud uživatel v náhledu přetáhne Analogové hodiny, vrstva sdělí mimoLive, které vstupní klávesy se mají změnit na jakou hodnotu. Tato funkce se však také používá k přenosu živých dat z instance program out do instance náhledu a naopak (např. ve vrstvě Video Switcher instance program out řekne instanci náhledu, který zdroj videa je právě živý, a instance náhledu může instanci program out říci, který zdroj videa uživatel na obrazovce vybral).

Chcete-li tuto funkci využít, potřebujete dva výstupy, které odpovídají vstupnímu poli, s nímž chcete manipulovat: V 'tvSet_' vyvedete novou hodnotu, kterou chcete nastavit, a pomocí 'tvSetSignal_' signalizujete, kdy je hodnota platná a má být uložena.

tvSetSignal_

Viz . tvSet_ .

tvSetAudioVolume_

Tento výstup ovládá hlasitost přidruženého zdroje zvuku (nebo zvuku zdroje videa). Platné hodnoty jsou 0=tichý až 1=plný. složení musí nastavit odpovídající "tvSetAudioVolumeSignal_" pokaždé, když chce změnit úroveň hlasitosti zvuku. Např. je to užitečné, pokud má vrstva přechod fade in a chce také fade in audio.

tvSetAudioVolumeSignal_

Viz . tvSetAudioVolume_ .

Sdílení hodnot mezi vrstvami

Vrstva může posílat data jiným vrstvám v zásobníku vrstev, které jsou nad ní. Data jsou uložena v mimolive podle klíče sdílení až do dalšího cyklu vykreslování. Pokud je vrstva použita vícekrát (nebo je stejný klíč sdílení použit v různých vrstvách), jsou data přepsána vrstvou nad ní. Pro nastavení těchto dat sdílení použijte výstup "tvOut_Share_". Můžete uložit libovolný datový typ QuartzComposer, nicméně doporučuje se struct, protože pro více hodnot stačí jeden výstup. Na straně přijímající vrstvy budete potřebovat odpovídající vstup "tvIn_Shared_" se zcela stejným datovým typem. Upozorňujeme, že přijímající vrstva musí být v zásobníku vrstev nad odesílající vrstvou.

Sdílení hodnot je užitečné, pokud potřebujete stejná data ve více vrstvách (např. jména domácích a hostujících protivníků ve hře).

Definice typů (také známé jako pojmenovací konvence)

Klíč	Typ	Popis
*_TypeAudio	Obrázek	Jedná se o velmi zvláštní případ: _TypeAudio lze přiřadit pouze zdroje, které obsahují zvuk (např. zdroje filmů, zdroje videa nebo pouze zdroje zvuku). Vrstva získá kontrolu nad tímto zdrojem (v budoucnu) a také nad hodnotami hlasitosti zvuku pro levý a pravý kanál prostřednictvím vstupů "_TypeAudioAudioLevel0" a "_TypeAudioAudioLevel1".
*_TypeBoinxX	Číslo	Číslo zadané v souřadnicích Boinx X - např. -1 je první pixel, 1 je poslední pixel aktuálních rozměrů obrazovky. bude uživateli zobrazeno v pixelech.
*_TypeBoinxY	Číslo	Číslo zadané v souřadnicích Boinx Y - např. -1 je spodní pixel, 1 je nejvyšší pixel aktuálních rozměrů obrazovky. bude uživateli zobrazeno v pixelech.
*_TypeDirectoryPath	Řetězec	Výsledkem je tlačítko "Zvolit..." v uživatelském rozhraní, možná také zobrazení ovládacího prvku cesty.
*_TypeDuration	Číslo	Čas v sekundách - zobrazí se v minutách:sekundách a může získat vlastní uživatelské rozhraní.
*_TypeFilePath	Řetězec	Výsledkem je tlačítko "Zvolit..." v uživatelském rozhraní, možná také zobrazení ovládacího prvku cesty.
*_TypeFontBoinxSize	Řetězec	Velikost písma v souřadnicích Boinx Y (např. 2 je výška celé obrazovky), viz poznámka níže.
*_TypeFontColor	Barva	Běžný barevný vstup pro zadání barvy textu, viz poznámka níže
*_TypeFontName	Řetězec	Výsledkem bude výběr písma, viz poznámka níže.
*_TypeMultiline	Řetězec	Víceřádkové textové pole, které umožňuje zadat návratové údaje.
*_TypeHeslo	Řetězec	Zobrazí textové pole s heslem. Důležité: samotné heslo je uloženo v prostém textu a je v dokumentu čitelné!
*_TypeSignal	Boolean	Pro jednosnímkový pulzní signál použijte políčka Pulse nebo Watcher.

*Pole _TypeFontName, _TypeFontBoinxSize a _TypeFontColor jsou v zobrazení parametrů vrstev sloučena do jednoho prvku uživatelského rozhraní Výběr písma, pokud mají stejný základní popisek.

Šablony filtrů

Tyto vstupy a vlastnosti jsou specifické pro případ, že vytváříte kompozici Quartz, kterou chcete použít jako obrazový filtr v mimoLive. Většina předchozích definic platí i pro filtry.

Vstupy filtru

Následující vstupní pole jsou vyžadována nástrojem Quartz Composer pro složení filtru:

Název	Typ	Popis
_protocolInput_PreviewMode	Bool	Lze použít k upozornění kompozice, že je v režimu náhledu.
_protocolInput_X	Číslo	je vždy 0.
_protocolInput_Y	Číslo	je vždy 0.

Vlastnosti filtru

Následující vlastnosti jsou definovány mimoLive. tv_FilterIdentifier a tv_FilterVersion jsou vyžadovány pro zpracování filtru a jeho cesty aktualizace s novějšími verzemi:

Název	Typ	Hodnota vzorku	Popis
tv_FilterIdentifier	Řetězec	com.boinx.mimoLive.layer.placer	Společnost Boinx dodávala složení a třídění různých verzí pro identifikaci.
tv_FilterVersion	Číslo (double)	1	Pro porovnávání různých verzí složení v dokumentu/aplikaci. Čísla hlavních verzí označují nekompatibilitu a neshodují se s jinými hlavními verzemi. Čísla menších verzí musí být kompatibilní směrem nahoru a při každé iteraci se zvyšují o 0,001. Např. musí být zajištěno, že načtení nastavení z vrstvy 1.0 pro 1.013 musí vypadat naprosto stejně, což znamená, že nové klíče, pokud jsou přítomny, musí mít výchozí nastavení, které je nezobrazuje nebo se rovná vzhledu předchozí verze.
tv_FilterOutputIsOpaque	BOOL		Určuje, zda je výstup filtru neprůhledný. Výchozí hodnota je NE

Výčty

Typ Quartz Composer Index umožňuje pojmenované indexy. Lze je upravovat v editoru Quartz Composer přidáním vstupního rozdělovače v indexovém režimu.

Typ zdroje

Zdrojem bude jedna z následujících hodnot

- 0 - Obrázek
- 1 - Film, film bude mít zbývající čas.
- 2 - Fotoaparát, také může být složení

Směr přechodu

Můžete si určit vlastní směr. Dodané vrstvy používají následující hodnoty.

- Žádné
- Vlevo
- Vpravo
- Nahoru
- Dolů

Typ přechodu

Můžete definovat vlastní typy přechodů. Zde je několik užitečných příkladů hodnot.

- Rozpustit
- Otřete

Sčítací státy

Pro zdroje videa je definováno několik stavů Tally, které budou zastoupeny v uživatelském rozhraní a v doprovodné aplikaci Tally Light.

- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram