Aangepaste laag API

Protocol versie 1.2

Inleiding

mimoLive gebruikt Apple's Quartz Composer technologie en zijn documenten voor de lagen. Omdat mimoLive het Quartz Composer-document enkele omgevingsparameters moet vertellen en de resultaten ervan moet uitlezen, hebben we een protocol ontworpen dat u moet volgen om te kunnen profiteren van alle functies die mimoLive te bieden heeft. Hieronder vindt u alle technische informatie over dit protocol.

Als je wilt leren hoe je aangepaste lagen kunt maken met Quartz Composer, lees dan "Klantlagen maken voor mimoLive":en:pro:custom_layer:creating_custom_layers.

Eigenschappen

U kunt het protocol bewerken in Quartz Composer door te kiezen voor Redacteur ⇢ Informatie bewerken (⌥⌘I)

Naam	Vereist	Type	Voorbeeldwaarde
categorie		String
copyright		String	© 2016 MySoftwareCompany
beschrijving		String	Speelt een schermvullende invoer af
naam	ja	String	Volledig scherm-speler
GEDEELTE tv-categorieën		String	Achtergrond,Volledig scherm
tv_Debug		Booleaans
tv_bestandsgegevens_ invoernaam-		Gegevens	(geïmporteerd XML-bestand)
tv_bestandsnaam_ invoernaam-		String	Standen.xml
tv_HelpURL		String
tv_verborgeningangen		Array van strings
tv_InvoerLabel_ invoernaam-		String	Video-ingang
tv_LayerIdentifier	ja	String	com.example.layer.mylayer
tv_LayerVersion	ja	Getal (echt)	1.01
tv_laagweergave		Gegevens	(geïmporteerd PNG-bestand)
tv_LayerProtocolVersion	ja	Getal (echt)	1
tv_SortKey		String
tv_StepSize_ invoernaam-		Getal (echt)	0.1
GEDEELTE tv_Taglijn		String	Speelt een schermvullende invoer af
tv_UseAudioFromSource		String	tvIn_VideoSourceA
tv_UnitLabel_ invoernaam-		String

categorie

De categorie wordt meestal ingesteld door Quartz composer en is niet nodig voor mimoLive lagen. Voor mimoLive categorieën zie tv-categorieën in plaats daarvan.

copyright

De copyright wordt meestal ingesteld door Quartz composer en is niet nodig voor mimoLive lagen.

beschrijving

Quartz Composer standaard - houd het ongeveer 3 regels lang zodat het goed in de preview past.

naam

De naam wordt weergegeven in mimoLive. Gebruik een korte en unieke naam om je laag snel te vinden.

protocollen

Deze array wordt gewoonlijk ingesteld door Quartz composer en is niet nodig voor mimoLive lagen.

tv-categorieën

GEDEELTE

De categorieën werden gebruikt om de lagen te groeperen en te filteren. Momenteel worden ze genegeerd, maar het kan weer worden geactiveerd. Gebruik een door komma's gescheiden lijst van de volgende voorgedefinieerde categorieën of definieer uw eigen categorieën.

- "Audio" - Lagen die de mogelijkheid bieden om een audiobron te gebruiken
- "Overlay" - Lagen die gegevens of afbeeldingen overlappen: Lower Thirds, Titel, Logo, ...
- "Volledig scherm" - Lagen die ten minste via de standaardinstellingen een volledig scherm bieden - bijv. animaties, enkele video, weerkaart
- "Achtergrond" - Lagen die werken als achtergrond/achtergrond voor andere dingen erop.
- "Tekst" - Lagen die een soort tekstweergave bieden, bijv. Credits, Lower Thirds, Koptekst
- "Gegevens" - Lagen die gegevens weergeven, zoals aandelenkoersen, basketbalscores, enz.
- "Afbeelding" - Lagen die een manier bieden om weer te geven met behulp van een statische afbeeldingsinvoer
- "Multivideo" - Lagen die ten minste twee bronnen combineren, hetzij door ten minste één bron toe te voegen naast de lagen eronder of door twee of meer bronnen te gebruiken.
- 3D" - Lagen die een soort 3D-positionering van elementen bieden, bijv. Presenter
- "Segment" - Lagen die een getimede animatie bieden om segmenten te scheiden, bijv. Digital Upgrade Beitrag
- "Effect" - Lagen die overlappende effecten bieden, zoals vergrootglas, Spotlight, Zoom...
- "Demo" - Lagen die vooral bedoeld zijn om mogelijkheden te demonstreren in plaats van algemene nuttige functionaliteit te bieden, bijv. Weerkaart, die alleen een kaart van Duitsland toont.
- "Consumer" - Lagen die de samengestelde laagafbeelding gebruiken, bijv. Video Switcher, Zoom, Presenter
- "Generator" - Lagen die een soort gegenereerde uitvoer bieden, bijv. animaties
- "Debug" - Lagen die nuttig zijn voor het debuggen en die niet zichtbaar zijn in het eindproduct

tv_Debug

De applicatie vertellen dat deze samenstelling alleen mag worden gebruikt in een debugomgeving.

tv_bestandsgegevens_

Een gegevensblob die wordt gemaakt en weggeschreven in het document voor een bestandsinvoer bij het maken van lagen. Dit werkt voor tekstbestanden die worden opgegeven in een _TypeFilePath of .mov-bestanden voor invoer van afbeeldingen. Zie tv_bestandsnaam_ .

tv_bestandsnaam_

De overeenkomstige bestandsnaam voor de tv_bestandsgegevens_ . Vereist als er een tv_FileData_* ingang bestaat.

tv_HelpURL

Deze string kan een URL bevatten met nuttige informatie over het gebruik van deze laag. mimoLive toont een "?" knop in de informatie popover voor elke laag. Als de gebruiker op deze knop klikt, wordt de URL geopend door de standaard internetbrowser van het systeem.

tv_verborgeningangen

In deze array bevat de samenstelling invoersleutels die verborgen moeten worden voor de gebruikersinterface.

tv_InvoerLabel_

Kan worden gebruikt om een alternatief naamlabel op te geven voor de opgegeven invoersleutel in de parameterweergave. Lege strings voor geen labels zijn ook mogelijk. Werkt zoals de tv_verbergen_uitgang De naam van de protocolinvoer moet bijvoorbeeld volledig zijn (bijvoorbeeld "tv_InputLabel_tvIn_VideoSourceAImage").

tv_LayerIdentifier

Voor identificatie heeft Boinx verschillende versies samengesteld en gesorteerd. Moet uniek zijn. Een domein met omgekeerde notatie wordt aanbevolen. Voorbeeld: com.mysoftware.layers.videofullscreen

tv_LayerVersion

Voor het matchen van verschillende versies van een samenstelling in een document/toepassing. Major versienummers geven incompatibiliteit aan en komen niet overeen met andere major versies (je moet bijvoorbeeld de major versie verhogen als de naam van de invoersleutels verandert). Minor versienummers moeten naar boven toe compatibel zijn en kunnen voor elke iteratie met 0,001 worden verhoogd. Er moet bijvoorbeeld voor worden gezorgd dat het laden van instellingen van een 1.0 laag voor een 1.013 er precies hetzelfde uit moet zien, wat betekent dat nieuwe sleutels, indien aanwezig, een standaardwaarde moeten hebben die ze niet laat zien of gelijk is aan het uiterlijk van de vorige versie.

tv_laagweergave

Afbeeldingsgegevens die moeten worden gebruikt voor het weergeven van een voorvertoning van een laag in de lagenlijst. Dit kan een betere ervaring opleveren dan het standaardvoorbeeld met snelle weergave. De voorbeeldafbeelding moet 256 × 256 pixels zijn.

tv_LayerProtocolVersion

Voor toekomstige achterwaartse compatibiliteit als mimoLive het protocol aanzienlijk wijzigt. Moet momenteel worden ingesteld op 1.

tv_SortKey

Bepaalt de sortering van de lagen in mimoLive. Zo kun je de filters sorteren op waarschijnlijkheid van gebruik. Momenteel wordt een schema van 2 hoofdletters gebruikt, bijv. "BM", "DE", "DM", enz. OPMERKING: Momenteel wordt deze functie niet gebruikt, maar dat zal in de toekomst wel gebeuren.

tv_StepSize_

Kan worden gebruikt om een aangepaste StepSize op te geven voor de jogwielen - een muisbeweging van één pixel komt dan overeen met deze hoeveelheid verandering (ook +/- klik).

tv_Taglijn

GEDEELTE
Eén regel die wordt weergegeven in de info popover in de laagarchieven.

tv_UseAudioFromSource

mimoLive kan momenteel slechts één audioregeling tonen in de gebruikersinterface. Deze eigenschap vertelt welke invoertoets moet worden bestuurd. Vul de volledige corresponderende invoertoets in. (Voor achterwaartse compatibiliteit accepteert dit veld ook "A", "B" of "C" wat vertaald wordt naar de sleutel tvIn_VideoSourceAImage, tvIn_VideoSourceBImage of tvIn_VideoSourceCImage. Als deze niet wordt opgegeven, neemt mimoLive aan dat er geen audio wordt gebruikt met deze laag.

tv_UnitLabel_

Kan worden gebruikt om een eenheidslabel op te geven, bijvoorbeeld "pt" voor de opgegeven invoertoets in de parameterweergave. Zo kort mogelijk houden. Helpt te communiceren wat invoer betekent. Boinx unit inputs krijgen automatisch "px" labels.

Ingangen

Naam	Type
tvIn-AccountTwitterConsumerKey	String
tvIn-AccountTwitterConsumerSecret	String
tvIn-AccountTwitterTokenKey	String
tvIn-AccountTwitterTokenSecret	String
tvIn_CompositedLayersImage	Afbeelding
tvIn_FrameCount	Index
tvIn_FrameDuration	Aantal
tvIn_CompositedLayersImage	Afbeelding
tvIn_InTransitionDirection	Index Overgangsrichting Richting
tvIn_InTransitionDuration	Aantal
tvIn_InTransitionType	Index Overgangstype Type
tvIn_KeyboardModifierAlt	Booleaans
tvIn_KeyboardModifierCommand	Booleaans
tvIn_KeyboardModifierControl	Booleaans
tvIn_KeyboardModifierFunctie	Booleaans
tvIn_KeyboardModifierShift	Booleaans
tvIn_Obscured	Booleaans
tvIn_OnAir	Booleaans
tvIn_OSVersion	String
tvIn_OutTransitionDirection	Index Overgangsrichting Richting
tvIn_OutTransitionDuration	Aantal
tvIn_OutTransitionType	Index Overgangstype Type
tvIn_PreviewMode	Booleaans
tvIn_Reset	Booleaans (Signaal)
tvIn_RuntimeIdentifier	String
tvIn_Gedeeld_	elk waardetype
tvIn_ShowDuration	Aantal
tvIn_ShowTimer	Aantal
tvIn_Schakelaar	Booleaans (Signaal)
tvIn_Overgangsrichting	Index Overgangsrichting Richting
tvIn_OvergangsDuur	Aantal
tvIn_Overgangstype	Index Overgangstype Type
tvIn_UISnapColor	Kleur
tvIn_VideoSourceA B C D	Afbeelding

tvIn-AccountTwitterConsumerKey

tvIn-AccountTwitterConsumerSecret

tvIn-AccountTwitterTokenKey

tvIn-AccountTwitterTokenSecret

Deze vier AccountTwitter-ingangen worden gebruikt om de aanmeldingsgegevens van mimoLive Twitter-accountvoorkeuren in de compositie in te voeren. De waarden worden gebruikt met de JSON Patch en OAuth Patch om gegevens van de Twitter-service te lezen.

tvIn_CompositedLayersImage

Als deze ingang aanwezig is in een compositie en er is inhoud van de lagen eronder, dan wordt het resultaat van het tekenen van die lagen eronder in deze ingang ingevoerd.

tvIn_FrameCount

Deze invoer geeft het totaal aantal gerenderde frames na het starten van mimoLive. Als er frames zijn weggevallen omdat de renderbelasting te hoog is, springt de frametelling over deze weggevallen framenummers heen.

tvIn_FrameDuration

De frameduur is het tijdsinterval tussen elke rendering in seconden.

tvIn_InTransitionDirection

Een richting waarin de Overgangsrichting zal worden uitgevoerd.

tvIn_InTransitionDuration

Een waarde in seconden die de tvIn_InTransitionType worden uitgevoerd.

tvIn_InTransitionType

Indien nuttig voor een laag die de gebruiker het type van de lopende overgang laat kiezen. Zie ook Type overgang.

tvIn_KeyboardModifierAlt

tvIn_KeyboardModifierCommand

tvIn_KeyboardModifierControl

tvIn_KeyboardModifierFunctie

tvIn_KeyboardModifierShift

Deze booleaanse invoervelden worden op waar gezet als de gebruiker op de overeenkomstige modificatietoets op het toetsenbord drukt. Deze functie wordt voornamelijk gebruikt voor de directe manipulatiefunctie. Raadpleeg de Apple Human User Guide Lines om te zien welke modificatietoets moet worden gebruikt voor welke functie in de UI.

tvIn_Obscured

Deze ingang wordt ingesteld op waar als de laag geen uitvoer hoeft te renderen omdat een laag erboven deze toch zal vertroebelen door het volledige scherm te tekenen. Dit kan worden gebruikt om te voorkomen dat lagen die niet zichtbaar zijn, maar wel zijn ingesteld om live te zijn, veel worden getekend. (Bijvoorbeeld in het geval van de Twitter-laag wordt de laag nog steeds aangeroepen, zelfs als deze wordt verborgen door een andere laag erboven, en krijgt deze laag de kans om de internetverbinding met de Twitter-service in stand te houden).

tvIn_OnAir

Deze ingang begint met de waarde "true". Zodra de ingang naar "false" gaat, moet de compositie alle uitgaande overgangen uitvoeren en vervolgens de uitvoer Done instellen als die klaar is. De samenstelling wordt dan gedeactiveerd. Het kan gebeuren dat de applicatie een laag uitschakelt zonder op de done vlag te wachten.

tvIn_OSVersion

Deze tekenreeksinvoer wordt ingesteld op de huidige OS X-versie (bijvoorbeeld "Version 10.11.2 (Build 265341)").

tvIn_OutTransitionDirection

Een waarde in seconden van de tvIn_OutTransitionType worden uitgevoerd. Zie ook Overgangsrichting.

tvIn_OutTransitionDuration

Een waarde in seconden van de tvIn_OutTransitionType worden uitgevoerd.

tvIn_OutTransitionType

Indien nuttig voor een laag die de gebruiker het type van de lopende overgang laat kiezen. Zie ook Type overgang.

tvIn_PreviewMode

Kan worden gebruikt om de compositie aan te geven dat deze in voorbeeldmodus staat.

tvIn_Reset

Nuttig voor het resetten van de logica van de samenstelling. Deze vlag wordt ingesteld wanneer een laag wordt overgeschakeld van live naar uit of wanneer wordt overgeschakeld tussen instellingen en geen tvIn_Schakelaar ingang beschikbaar is.

tvIn_RuntimeIdentifier

Helpt lagen om te communiceren tussen preview en live instantie. Dynamisch ingesteld door mimoLive.

tvIn_Gedeeld_

Zie Waarden delen tussen lagen Waarden tussen lagen.

tvIn_ShowDuration

Als de gebruiker de duur van de show heeft ingevuld in de Showinstellingen, dan zal deze invoer de waarde in seconden hebben.

tvIn_ShowTimer

De showtimer geeft de Show Timer-weergave van het mimoLive-document in seconden weer.

tvIn_Schakelaar

Deze vlag wordt ingesteld in plaats van tvIn_Reset]] wanneer een laag wordt overgeschakeld van de ene instelling naar de andere zonder de laag uit te schakelen. Als deze ingang niet bestaat, wordt de [[#tvIn_Reset wanneer een laag wordt overgeschakeld van de ene instelling naar de andere zonder de laag uit te schakelen. Als deze ingang niet bestaat, wordt in plaats daarvan de [[#tvIn_Reset ingesteld om compatibiliteit met oudere lagen te behouden.

tvIn_Overgangsrichting

Een richting waarin de Overgangsrichting worden uitgevoerd.

tvIn_OvergangsDuur

Een waarde in seconden van de tvIn_InTransitionType worden uitgevoerd.

tvIn_Overgangstype

Indien nuttig voor een laag die de gebruiker het type van de lopende overgang laat kiezen. Zie ook Type overgang.

tvIn_UISnapColor

Om de UI consistent te houden biedt mimoLive een "snap color" om de richtlijnen in de preview te tekenen wanneer de UI op een bepaalde waarde klikt (houd bijvoorbeeld de "shift"-toets ingedrukt terwijl u een Placer-laag draait in de aangepaste weergavemodus, dan worden de richtlijnen in die kleur getekend wanneer de rotatiehoek op 0, 45 of 90 graden klikt).

tvIn_VideoBron

Een laag kan tot 8 dynamische videobron-ingangen hebben: "A", "B", "C" enzovoort. Ze worden weergegeven door een dropzone als de gebruiker een videobron uit de bronarchieven naar de laagstapel sleept. //Opmerking: Voor achterwaartse compatibiliteit wordt de extensie "Afbeelding" op deze ingangen genegeerd.//

Invoeropties

Overeenkomstige invoertoetsen

Als er een video-invoersleutel aanwezig is, worden de volgende invoersleutels ook gevuld met de overeenkomstige informatie:

(bijv. "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")

Sleutel	Type	Beschrijving
AudioGain	Aantal	TBD
AudioNiveau0	Aantal	Linkeraudiokanaalniveau in db na versterkingsregeling
AudioNiveau1	Aantal	Rechteraudiokanaalniveau in db na versterkingsregeling
AudioNiveau0Ruw	Aantal	Linkeraudiokanaalniveau in db vóór gain-regeling
AudioLevel1Raw	Aantal	Rechteraudiokanaalniveau in db vóór gain-regeling
AudioPanning	Aantal	TBD
AudioVolume	Aantal	TBD
Gegevens	Struct	Een woordenboek met metadata van de bron. Momenteel zijn de geïmplementeerde sleutels: "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier".
Naam	String	Naam van de gekoppelde afbeeldingsbron. Kan worden gebruikt om de naam weer te geven in de preview of om de standaardnaam voor de laagvariant te berekenen. Zie tvUit_SettingName .
ResterendeTijd	Aantal	In seconden. Wordt gegeven voor filmbronnen. -1 als de filmbron in lus is (of een andere bron).
TallyState	Index	Tally State van de aangesloten bron, zie Tally Staten Staten
Type	Index	Waarde van brontype type

Ingangen groeperen

Groeperen wordt aangeboden in de gebruikersinterface - daarvoor is het voorvoegsel van de invoer relevant. De syntaxis werkt als tvGroep___. Let op de dubbele underscore _ _ na de groepsnaam als scheidingsteken voor de invoernaam.

Er wordt een speciale groep gedefinieerd voor ingangen die altijd verborgen moeten zijn: tvGroep_verborgen_ingangen__ Deze groep kan zichtbaar gemaakt worden door mimoLive in debug-modus te zetten in de debug|Debug Voorkeuren|Voorkeuren. Sommige lagen gebruiken deze verborgen velden om te communiceren tussen de "Preview-instantie" en de "Live-instantie" (bijv. de Video Switcher-laag vertelt de Preview-instantie welke videobron momenteel live is).

Invoer dynamisch verbergen

Elke Protocolinvoer wordt verborgen in de UI als de tvUit_verbergen De uitvoer is ingesteld op "true". Deze waarde wordt waargenomen door de toepassing en kan dynamisch worden gewijzigd. Merk op dat je de volledige naam van de invoer moet gebruiken, inclusief "tvIn" (gebruik bijvoorbeeld de uitvoer tvOut_hide_tvIn_Text_TypeMultiline voor de invoer tvIn_Tekst_TypeMeervoudige regel).

Uitgangen

Naam	Type
tvUit_Cursor	String
tvUit_Daan	Booleaans (Signaal)
tvUit_verbergen	Booleaans
tvUit_Ondoorzichtig	Booleaans
tvUit_SettingName	String
tvUit_Delen_	elk type
tvUit_TijdResterend	Aantal
tvOut_UseCompositedLayersImage	Booleaans
tvUit_TallyState	Index van Tally Staten Staten
tvSet_	Type ingang dat moet worden ingesteld
tvSetSignaal_	Booleaans
tvSetAudioVolume_	Aantal
tvSetAudioVolumeSignaal_	Booleaans

tvUit_Cursor

Deze uitvoer specificeert het uiterlijk van de muiscursor als de muisaanwijzer zich boven de voorbeeldweergave of de programma-uitvoerweergave bevindt. Raadpleeg Apples NSCursor-klasse documentatie) voor geldige waarden. Extra muiscursors die door mimoLive worden geleverd zijn "min" en "plus".

*Verwijder het achtervoegsel "_Cursor" of "Cursor" uit de NSCursor constanten van Apple (gebruik bijvoorbeeld "openHand" voor een muiscursor met open hand).

tvUit_Daan

Wordt gebruikt om de volgende laag te vertellen dat deze laag klaar is. Zie tvIn_OnAir voor documentatie.

tvUit_verbergen

Kan worden gebruikt om invoerwaarden dynamisch te verbergen in de parameterweergave. Zie Invoer dynamisch verbergen .

tvUit_Ondoorzichtig

Wordt gebruikt om de toepassing te vertellen dat lagen onder deze laag niet hoeven te worden getekend. Standaard "false". Deze waarde wordt overschreven door elke verbonden bron die alfa bevat.

tvUit_SettingName

Samenstellingen kunnen een bruikbare naam voorstellen voor een instelling op basis van bepaalde input(s).

tvUit_Delen_

Zie Waarden delen tussen lagen .

tvUit_TijdResterend

Hiermee kan de applicatie een grote aftelklok weergeven (bijvoorbeeld 5 seconden tot een film klaar is). Op dit moment wordt "-1" gebruikt om aan te geven dat er geen informatie is over de resterende tijd of "-2" als het een film in lus is.

tvOut_UseCompositedLayersImage

Wordt gebruikt om de prestaties te optimaliseren bij het gebruik van lagen eronder met overgangen enz. Het vertelt de app dat de laag op dit moment de samengestelde lagen beeldinvoer nodig heeft. mimoLive zal de lagen onder de samengestelde afbeelding in de volgende rendercyclus plaatsen. Als "tvOut_UseCompositedLayersImage" niet aanwezig is, neemt mimoLive aan dat de lagen onder de afbeelding altijd moeten worden geplaatst. Alleen tekenoptimalisatie, alle media worden toch ingerold. Alleen gebruikt als tvIn_CompositedLayersImage aanwezig is.

tvUit_TallyState

Deze outputlaag kan de automatische tally-status overschrijven van de bron die op dat moment is aangesloten op die ingang. Dit is handig voor overgangen of als de bron niet wordt gebruikt voor uitvoer, kan de status van de kubus worden uitgeschakeld (de Video Switcher gebruikt bijvoorbeeld 3 camera's, maar toont er maar één tegelijk, dus moet de status van de kubus voor ongebruikte bronnen worden ingesteld op "TVTallyStateOff"). Zie Tally Staten voor de lijst met statusstaten.

tvSet_

In mimoLive kan een laag of filter zijn eigen parameters manipuleren. Dit is voornamelijk om de directe manipulatiefunctie in de preview van de laagvariant te implementeren (bijv. als de gebruiker de analoge klok in de preview sleept, vertelt de laag mimoLive welke invoertoetsen in welke waarde moeten worden veranderd. Deze functie wordt echter ook gebruikt om live gegevens van de program out-instantie naar de preview-instantie over te brengen en omgekeerd (bijv. in de Video Switcher-laag vertelt de program out-instantie de preview-instantie welke videobron momenteel live is en de preview-instantie kan de program out-instantie vertellen welke videobron de gebruiker op het scherm heeft geselecteerd).

Om deze functie te gebruiken heb je twee uitgangen nodig die overeenkomen met het invoerveld dat je wilt manipuleren: In 'tvSet_' voer je de nieuwe waarde uit die je wilt instellen en met 'tvSetSignal_' geef je een signaal wanneer de waarde geldig is en moet worden opgeslagen.

tvSetSignaal_

Zie tvSet_ .

tvSetAudioVolume_

Deze uitgang regelt het volume van de bijbehorende audiobron (of audio van een videobron). Geldige waarden zijn 0=stil tot 1=vol. De compositie moet het corresponderende "tvSetAudioVolumeSignal_" instellen telkens als het audiovolumeniveau moet worden gewijzigd. Dit is bijvoorbeeld handig als de laag een fade-in overgang heeft en ook audio wil laten fade-in.

tvSetAudioVolumeSignaal_

Zie tvSetAudioVolume_ .

Waarden delen tussen lagen

Een laag kan gegevens verzenden naar andere lagen in de lagenstapel die boven zichzelf staan. De gegevens worden door mimolive opgeslagen met de gedeelde sleutel tot de volgende rendercyclus. Als een laag meerdere keren wordt gebruikt (of als dezelfde delingssleutel in verschillende lagen wordt gebruikt), wordt de data overschreven door de laag erboven. Gebruik een "tvOut_Share_" uitgang om deze gegevens in te stellen. Je kunt elk QuartzComposer datatype opslaan, maar een struct wordt aanbevolen omdat je maar één uitgang nodig hebt voor meerdere waarden. Aan de kant van de ontvangende laag heb je een overeenkomstige "tvIn_Shared_" ingang nodig met hetzelfde gegevenstype. Let op: de ontvangende laag moet boven de zendende laag staan in de lagenstapel.

Het delen van waarden is handig als je dezelfde gegevens in meerdere lagen nodig hebt (bijvoorbeeld de naam van de thuis- en gasttegenstanders in een spel).

Type definities (ook wel naamgevingsconventies genoemd)

Sleutel	Type	Beschrijving
*_TypeAudio	Afbeelding	Dit is een heel speciaal geval: Een _TypeAudio kan alleen bronnen toewijzen die audio bevatten (bijv. Filmbronnen, Videobronnen of Alleen audiobronnen). De laag krijgt (in de toekomst) controle over deze bron en over de volumewaarden van het geluid voor het linker- en rechterkanaal via de ingangen "_TypeAudioAudioLevel0" en "_TypeAudioAudioLevel1".
*_TypeBoinxX	Aantal	Een getal dat wordt ingevoerd in Boinx X-coördinaten - bijvoorbeeld -1 is de eerste pixel, 1 is de laatste pixel van de huidige schermafmetingen. zal aan de gebruiker worden gepresenteerd in pixels.
*_TypeBoinxY	Aantal	Een getal dat wordt ingevoerd in Boinx Y-coördinaten - bijv. -1 is de onderste pixel, 1 is de bovenste pixel van de huidige schermafmetingen. wordt aan de gebruiker gepresenteerd in pixels.
*_TypeDirectoryPath	String	Resulterend in een "Kies..." knop in de UI, misschien ook met een padcontrole
*_TypeDuration	Aantal	Tijd in seconden - wordt weergegeven in minuten:seconden en kan een aangepaste UI krijgen
*_TypeBestandPad	String	Resulterend in een "Kies..." knop in de UI, misschien ook met een padcontrole
*_TypeFontBoinxSize	String	Lettergrootte in Boinx Y-coördinaten (bijv. 2 is de schermvullende hoogte), zie opmerking hieronder
*_TypeFontColor	Kleur	Normale kleurinvoer om een tekstkleur op te geven, zie opmerking hieronder
*_TypeFontName	String	Dit resulteert in een lettertypekiezer, zie opmerking hieronder
*_TypeMultilijn	String	Een tekstveld met meerdere regels waarin retouren kunnen worden ingevoerd
*_TypeWachtwoord	String	Geeft een wachtwoord-tekstvak weer. Belangrijk: Het wachtwoord zelf wordt opgeslagen in platte tekst en is leesbaar in het document!
*_TypeSignaal	Booleaans	Gebruik voor een gepulseerd signaal met één frame de patches Pulse of Watcher.

*Het veld _TypeFontName, het veld _TypeFontBoinxSize en het veld _TypeFontColor worden gecombineerd in één UI-element Font Chooser in de lagenparameterweergave als ze hetzelfde basislabel hebben.

Filtersjablonen

Deze ingangen en eigenschappen zijn specifiek voor als u een Quartz Compositie maakt om te gebruiken als afbeeldingsfilter in mimoLive. De meeste van de vorige definities zijn ook van toepassing op filters.

Filteringangen

De volgende invoervelden zijn vereist door Quartz Composer voor een filtersamenstelling:

Naam	Type	Beschrijving
_protocolInvoer_PreviewModus	Bool	Kan worden gebruikt om de compositie te laten weten dat deze in voorbeeldmodus is
_protocolInvoer_X	Aantal	Is altijd 0.
_protocolInvoer_Y	Aantal	Is altijd 0.

Eigenschappen filter

De volgende eigenschappen worden gedefinieerd door mimoLive. tv_FilterIdentifier en tv_FilterVersion zijn nodig om het filter en zijn updatepad met nieuwere versies te behandelen:

Naam	Type	Voorbeeldwaarde	Beschrijving
tv_FilterIdentifier	String	com.boinx.mimoLive.layer.placer	Voor identificatie verscheepte Boinx samenstellingen en sorteerde verschillende versies
tv_FilterVersion	Aantal (dubbel)	1	Voor het matchen van verschillende versies van een samenstelling in een document/toepassing. Major versienummers geven incompatibiliteit aan en komen niet overeen met andere major versies. Minor versienummers moeten naar boven toe compatibel zijn en elke iteratie met 0.001 toenemen. Er moet bijvoorbeeld voor worden gezorgd dat het laden van instellingen van een 1.0 laag voor een 1.013 er precies hetzelfde uit moet zien, wat betekent dat nieuwe sleutels, indien aanwezig, een standaard moeten hebben die ze niet laat zien of gelijk is aan het uiterlijk van de vorige versie.
tv_FilterOutputIsOpaque	BOOL		Bepaalt of een filteruitvoer ondoorzichtig is. Standaard is NEE

Opsommingen

Het Quartz Composer type Index maakt benoemde indexen mogelijk. Ze kunnen worden bewerkt in de Quartz Composer Editor door een ingangssplitter toe te voegen in indexmodus.

Bron Type

De bron is een van de volgende waarden

- 0 - Afbeelding
- 1 - Film, een film heeft een resterende tijd
- 2 - Camera, kan ook een compositie zijn

Overgangsrichting

Je kunt je eigen richtingen definiëren. De verzonden lagen gebruiken de volgende waarden.

- Geen
- Links
- Rechts
- Omhoog
- Omlaag

Overgangstype

Je kunt je eigen overgangstypes definiëren. Hier zijn enkele nuttige voorbeeldwaarden.

- Oplossen
- Vegen

Tally Staten

Er zijn verschillende Tally-staten voor videobronnen gedefinieerd die worden weergegeven in de UI en de Tally Light companion app.

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