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 in Quartz Composer bewerken door Editor ⇢ Informatie bewerken (⌥⌘I) te selecteren.
| 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 gewoonlijk ingesteld door Quartz composer en is niet nodig voor mimoLive lagen. Zie in plaats daarvan tv_Categories voor mimoLive-categorieën.
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
DEPRECATED
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 data of afbeeldingen overlappen: Lower Thirds, Titel, Logo, ...
- "Volledig scherm" - Lagen die tenminste via de standaardinstellingen een volledig scherm bieden - bijv. Animaties, Enkele video, Weerkaart
- "Achtergrond" - Lagen die werken als achtergrond voor andere dingen erop.
- "Tekst" - Lagen die een soort tekstweergave bieden, bijv. Credits, Lower Thirds, Kop
- "Data" - Lagen die Data weergeven, bijv. aandelenkoersen, basketbalscores, etc.
- "Afbeelding" - Lagen die een manier bieden om een statische afbeelding weer te geven
- "Multivideo" - Lagen die minstens twee bronnen combineren, ofwel door minstens éé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 overlay effecten bieden, bijv. Loep, Spotlight, Zoom...
- "Demo" - Lagen die vooral bedoeld zijn om mogelijkheden te demonstreren in plaats van algemene nuttige functionaliteit te bieden, bijv.Bijvoorbeeld Weerkaart, die alleen een kaart van Duitsland toont.
- "Consument" - Lagen die gebruik maken van de compositedlayersimage, bijvoorbeeld Video Switcher, Zoom, Presenter
- "Generator" - Lagen die een soort gegenereerde uitvoer bieden, bijvoorbeeld Animaties
- "Debug" - Lagen die nuttig zijn voor 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 zal worden aangemaakt en weggeschreven in het document voor een bestandsinvoer bij het aanmaken van lagen. Dit werkt voor tekstbestanden die worden opgegeven in een _TypeFilePath of .mov bestanden voor afbeeldingsinvoer. Zie tv_FileName_ .
tv_bestandsnaam_
De bijbehorende bestandsnaam van de tv_FileData_ . 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 als de tv_hide_ouput , bijv. de protocolinvoernaam moet volledig zijn (bijv. "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
DEPRECATED
Eén regel die wordt weergegeven in de info popover in het lagenarchief.
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 het tvIn_InTransitionType zal uitvoeren.
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 het tvIn_OutTransitionType wordt uitgevoerd. Zie ook Overgangsrichting.
tvIn_OutTransitionDuration
Een waarde in seconden van het tvIn_OutTransitionType wordt 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 naar live vanuit uit of wanneer er wordt overgeschakeld tussen instellingen en er geen tvIn_Switch 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 van de ene instelling naar de andere wordt geschakeld zonder de laag uit te schakelen. Als deze ingang niet bestaat, wordt de [[#tvIn_Reset ingesteld om compatibiliteit met oudere lagen te behouden.
tvIn_Overgangsrichting
Een richting waarin de Overgangsrichting zal worden uitgevoerd.
tvIn_OvergangsDuur
Een waarde in seconden van het tvIn_InTransitionType wordt 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
Groepering is voorzien in de gebruikersinterface - daarvoor is het voorvoegsel van de invoer relevant. De syntaxis werkt als tvGroup___. Let op het dubbele onderstrepingsteken _ _ na de groepsnaam als scheidingsteken voor de invoernaam.
Er is een speciale groep gedefinieerd voor ingangen die altijd verborgen moeten zijn: tvGroup_Hidden_Inputs__ Deze groep kan zichtbaar gemaakt worden door mimoLive in debug-modus te zetten in de debug|Debug Voorkeuren|Debug 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 Protocolingang wordt verborgen in de UI als de tvOut_hide_ Uitvoer is ingesteld op "true". Deze waarde wordt waargenomen door de toepassing en kan dynamisch worden gewijzigd. Merk op dat u de volledige ingangsnaam moet gebruiken, inclusief "tvIn" (gebruik bijvoorbeeld de uitgang tvOut_hide_tvIn_Text_TypeMultiline voor de ingang tvIn_Text_TypeMultiline).
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 bepaalt het uiterlijk van de muiscursor als de muisaanwijzer zich boven de voorbeeldweergave of de programma-uitvoerweergave bevindt. Raadpleeg Apples NSCursor Class 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 gebruikt worden om invoerwaarden in de parameterweergave dynamisch te verbergen. 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 lagenafbeelding invoer 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 toegevoegd. 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 op die ingang is aangesloten. Dit is handig voor overgangen of als de bron niet voor uitvoer wordt gebruikt, kan de status van de tally worden uitgeschakeld (bijv. de Video Switcher gebruikt 3 camera's, maar laat er maar één tegelijk zien, dus moet de status van de tally voor ongebruikte bronnen worden ingesteld op "TVTallyStateOff"). Zie Tally States voor de lijst met tally states.
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
- Boven
- Onder
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
