Protokoll version 1.2
Introduktion
mimoLive använder Apples Quartz Composer-teknik och dess dokument för skikten. Eftersom mimoLive behöver meddela Quartz Composer-dokumentet vissa miljöparametrar och läsa av resultat från dem, har vi utformat ett protokoll som du måste följa för att kunna dra nytta av alla funktioner som mimoLive har att erbjuda. I det följande hittar du all teknisk information om detta protokoll.
Om du vill lära dig hur du skapar anpassade lager med Quartz Composer, läs "Creating Customer Layers for mimoLive":en:pro:custom_layer:creating_custom_layers.
Fastigheter
Du kan redigera protokollet i Quartz Composer genom att välja Redaktör ⇢ Redigera information (⌥⌘I)
| Namn | Obligatoriskt | Typ | Provvärde |
|---|---|---|---|
| kategori | Sträng | ||
| upphovsrätt | Sträng | © 2016 MySoftwareCompany | |
| beskrivning | Sträng | Spelar upp en inmatning i helskärm | |
| namn | ja | Sträng | Fullskärmsspelare |
| DEPRECERAD tv_kategorier | Sträng | Bakgrund,Fullskärm | |
| tv_Debug | Boolesk | ||
| tv_FileData_ namn på ingång- | Data | (importerad XML-fil) | |
| tv_Filenamn_ namn på ingång- | Sträng | Ställning.xml | |
| tv_HjälpURL | Sträng | ||
| tv_HiddenInputKeys | Array av strängar | ||
| tv_InputLabel_ namn på ingång- | Sträng | Videoingång | |
| tv_LayerIdentifierare | ja | Sträng | com.example.layer.mylayer |
| tv_LayerVersion | ja | Tal (verkligt) | 1.01 |
| tv_LayerPreview | Data | (importerad PNG-fil) | |
| tv_LayerProtocolVersion | ja | Tal (verkligt) | 1 |
| tv_SortKey | Sträng | ||
| tv_StepSize_ namn på ingång- | Tal (verkligt) | 0.1 | |
| DEPRECERAD tv_Tagline | Sträng | Spelar upp en inmatning i helskärm | |
| tv_AnvändAudioFromSource | Sträng | tvIn_VideoSourceA | |
| tv_UnitLabel_ namn på ingång- | Sträng |
kategori
Kategorin anges vanligtvis av Quartz kompositör och behövs inte för mimoLive-lager. För mimoLive-kategorier se tv_kategorier istället.
upphovsrätt
Copyright anges vanligtvis av Quartz kompositör och behövs inte för mimoLive-lager.
beskrivning
Quartz Composer standard - håll den ca 3 rader lång så att den passar bra i förhandsgranskningen.
namn
Namnet visas inuti mimoLive. Använd ett kort och unikt namn för att snabbt hitta ditt lager.
protokoll
Denna array ställs vanligtvis in av Quartz-kompositören och behövs inte för mimoLive-lager.
tv_kategorier
DEPRECERAD
Kategorierna användes för att gruppera och filtrera lagren. För närvarande ignoreras de, men de kan komma att aktiveras igen. Använd en kommaseparerad lista med följande fördefinierade kategorier eller definiera dina egna.
- "Ljud" - Lager som ger möjlighet att använda en ljudkälla
- "Overlay" - lager som överlagrar data eller bilder: Lower Thirds, titel, logotyp, ...
- "Fullskärm" - lager som åtminstone via standardinställningarna ger en fullskärm - t.ex. animationer, enstaka video, väderkarta
- "Backdrop" - lager som fungerar som bakgrund/bakgrund för andra saker ovanpå.
- "Text" - lager som ger någon form av textvisning, t.ex. Credits, Lower Thirds, Heading
- "Data" - lager som visar data, t.ex. aktiekurser, basketresultat osv.
- "Bild" - Lager som tillhandahåller ett sätt att visa med hjälp av en statisk bildinmatning
- "Multivideo" - Lager som kombinerar minst två källor, antingen genom att lägga till minst en källa utöver lagren nedan eller genom att använda två eller flera källor.
- "3D" - Lager som ger någon form av 3d-positionering av element, t.ex. presentatör
- "Segment" - Lager som ger en tidsinställd animering för att separera segment, t.ex. Digital Upgrade Beitrag
- "Effekt" - lager som ger vissa överlagringseffekter, t.ex. förstoringsglas, spotlight, zoom...
- "Demo" - Lager som främst är avsedda för att demonstrera funktioner snarare än att tillhandahålla generisk användbar funktionalitet, t.ex. väderkartan, som bara visar en karta över Tyskland.
- "Konsument" - lager som använder den sammansatta lagerbilden, t.ex. videobrytare, zoom, presentatör
- "Generator" - Lager som ger någon form av genererad output, t.ex. animationer
- "Debug" - Lager som är användbara för felsökning och som inte syns i slutprodukten
tv_Debug
Tala om för applikationen att denna komposition endast bör användas i en felsökningsmiljö.
tv_FileData_
En datablob som kommer att skapas och skrivas in i dokumentet för en filinmatning vid skapande av lager. Detta fungerar för textfiler som kommer att tillhandahållas i en _TypeFilePath eller .mov-filer för bildinmatningar. Se tv_Filenamn_ .
tv_Filenamn_
Det motsvarande filnamnet till tv_FileData_ . Krävs om en tv_FileData_*-ingång finns.
tv_HjälpURL
Denna sträng kan lagra en URL med användbar information om hur man använder detta lager. mimoLive kommer att presentera en "?"-knapp i informationsfönstret för varje lager. Om användaren klickar på denna knapp öppnas URL:en av systemets standardwebbläsare.
tv_HiddenInputKeys
I denna matris innehåller kompositionen inmatningsnycklar som bör döljas från användargränssnittet.
tv_InputLabel_
Kan användas för att ange ett alternativt namn för den angivna inmatningsknappen i parametervyn. Tomma strängar för inga etiketter är också möjliga. Fungerar som tv_gömd_ouput , t.ex. måste namnet på protokollets indata vara fullständigt (t.ex. "tv_InputLabel_tvIn_VideoSourceAImage").
tv_LayerIdentifierare
För identifiering levererade Boinx kompositioner och sorterade olika versioner. Måste vara unik. En domän med omvänd notering rekommenderas. Exempel: com.mysoftware.layers.videofullscreen
tv_LayerVersion
För matchning av olika versioner av en komposition i ett dokument/applikation. Stora versionsnummer anger inkompatibilitet och matchar inte med andra stora versioner (t.ex. måste du öka den stora versionen om namnet på inmatningsnycklarna ändras). Mindre versionsnummer måste vara kompatibla uppåt och kan ökas med 0,001 för varje iteration. T.ex. måste det säkerställas att laddningsinställningar från ett 1.0-lager för ett 1.013 måste se exakt likadana ut, vilket innebär att nya nycklar om de finns måste ha ett standardvärde som inte visar dem eller som motsvarar utseendet på den tidigare versionen.
tv_LayerPreview
Bilddata som ska användas för förhandsgranskning av ett lager i lagerlistan. Detta kan ge en bättre upplevelse än standardförhandsgranskningen. Förhandsgranskningsbilden ska vara 256 × 256 pixlar.
tv_LayerProtocolVersion
För framtida bakåtkompatibilitet om mimoLive ändrar protokollet väsentligt. Måste för närvarande vara satt till 1.
tv_SortKey
Definierar sorteringen av skikten i mimoLive. Så du kan sortera filtren efter sannolikheten för användning. För närvarande används ett system med 2 versaler, t.ex. "BM", "DE", "DM", etc. OBS: För närvarande används inte denna funktion men kommer att göra det i framtiden.
tv_StepSize_
Kan användas för att ange en anpassad StepSize för jogghjulen - en pixels musrörelse motsvarar då denna förändring (även +/- klick).
tv_Tagline
DEPRECERAD
Enradig sträng som kommer att visas i informationsfönstret i lagerförvaret.
tv_AnvändAudioFromSource
mimoLive kan för närvarande endast visa en ljudkontroll i användargränssnittet. Denna egenskap talar om vilken inmatningsknapp som ska kontrolleras. Fyll i den fullständiga motsvarande inmatningsknappen. (För bakåtkompatibilitet accepterar detta fält även "A", "B" eller "C" som översätts till nyckeln tvIn_VideoSourceAImage, tvIn_VideoSourceBImage eller tvIn_VideoSourceCImage. Om inget anges antar mimoLive att inget ljud kommer att användas med detta lager.
tv_UnitLabel_
Kan användas för att ange en enhetsbeteckning, t.ex. "pt" för den givna inmatningsknappen i parametervyn. Håll så kort som möjligt. Hjälper till att kommunicera vad inmatning betyder. Inmatningar med Boinx-enheter kommer automatiskt att få "px"-etiketter.
Ingångar
| Namn | Typ |
|---|---|
| tvIn_AccountTwitterConsumerKey | Sträng |
| tvIn_AccountTwitterConsumerSecret | Sträng |
| tvIn_AccountTwitterTokenKey | Sträng |
| tvIn_AccountTwitterTokenSecret | Sträng |
| tvIn_CompositedLayersImage | Bild |
| tvIn_FrameCount | Index |
| tvIn_FrameDuration | Antal |
| tvIn_CompositedLayersImage | Bild |
| tvIn_InTransitionDirektion | Index Riktning för övergång Riktning |
| tvIn_InTransitionDuration | Antal |
| tvIn_InTransitionTyp | Index Typ av övergång Typ |
| tvIn_TangentbordsmodifierareAlt | Boolesk |
| tvIn_KeyboardModifierCommand | Boolesk |
| tvIn_KeyboardModifierControl | Boolesk |
| tvIn_TangentbordsmodifierareFunktion | Boolesk |
| tvIn_TangentbordModifierShift | Boolesk |
| tvIn_Obscured | Boolesk |
| tvIn_OnAir | Boolesk |
| tvIn_OSVersion | Sträng |
| tvIn_OutTransitionDirection | Index Riktning för övergång Riktning |
| tvIn_OutTransitionDuration | Antal |
| tvIn_OutTransitionType | Index Typ av övergång Typ |
| tvIn_PreviewMode | Boolesk |
| tvIn_Reset | Boolesk (signal) |
| tvIn_RuntimeIdentifierare | Sträng |
| tvIn_Shared_ | valfri värdetyp |
| tvIn_ShowDuration | Antal |
| tvIn_ShowTimer | Antal |
| tvIn_Switch | Boolesk (signal) |
| tvIn_TransitionDirection | Index Riktning för övergång Riktning |
| tvIn_TransitionDuration | Antal |
| tvIn_TransitionType | Index Typ av övergång Typ |
| tvIn_UISnapColor | Färg |
| tvIn_VideoSourceA B C D | Bild |
tvIn_AccountTwitterConsumerKey
tvIn_AccountTwitterConsumerSecret
tvIn_AccountTwitterTokenKey
tvIn_AccountTwitterTokenSecret
Dessa fyra AccountTwitter-ingångar används för att mata in inloggningsdata från mimoLive Twitter Account Preferences i kompositionen. Värdena används med JSON Patch och OAuth Patch Patch för att läsa data från Twitter-tjänsten.
tvIn_CompositedLayersImage
Om denna ingång finns i en komposition och det finns innehåll från lagren under, kommer resultatet av ritningen av dessa lager under att matas in i denna ingång.
tvIn_FrameCount
Denna ingång kommer att få det totala antalet renderade bilder efter start av mimoLive. Om bildrutor har tappats på grund av att renderingsbelastningen är för hög kommer bildruteantalet att hoppa över de tappade bildrutorna.
tvIn_FrameDuration
Frame duration är tidsintervallet mellan varje rendering i sekunder.
tvIn_InTransitionDirektion
En riktning i vilken Transition Direction kommer att utföras.
tvIn_InTransitionDuration
Ett värde i sekunder för tvIn_InTransitionTyp kommer att utföras.
tvIn_InTransitionTyp
Om användbart för ett lager som låter användaren välja typ av pågående övergång. Se även Övergångstyp Typ.
tvIn_TangentbordsmodifierareAlt
tvIn_KeyboardModifierCommand
tvIn_KeyboardModifierControl
tvIn_TangentbordsmodifierareFunktion
tvIn_TangentbordModifierShift
Dessa booleska inmatningsfält kommer att sättas till true när användaren trycker på motsvarande modifieringstangent på tangentbordet. Denna funktion används främst för direkt manipulering. Se Apple Human User Guide Lines för att se vilken modifieringstangent som ska användas för vilken funktion i användargränssnittet.
tvIn_Obscured
Denna indata sätts till true om lagret inte behöver rendera någon utdata eftersom ett lager ovanför ändå kommer att skymma den genom att rita hela skärmen. Detta kan användas för att undvika tung ritning av lager som inte är synliga men är inställda på att vara live. (T.ex. i fallet med Twitter-lagret anropas lagret även om det döljs av ett annat lager ovanför och får chansen att hålla internetanslutningen till Twitter-tjänsten uppe).
tvIn_OnAir
Denna indata börjar med värdet "true". När indata går till "false" ska kompositionen göra alla utgående övergångar och sedan ställa in sin Done-utgång när det är klart. Kompositionen kommer då att avaktiveras. Det kan hända att applikationen stänger av ett lager utan att vänta på done-flaggan.
tvIn_OSVersion
Denna stränginmatning kommer att ställas in på den aktuella OS X-versionen (t.ex. "Version 10.11.2 (Build 265341)").
tvIn_OutTransitionDirection
Ett värde i sekunder för tvIn_OutTransitionType kommer att utföras. Se även Övergångsriktning.
tvIn_OutTransitionDuration
Ett värde i sekunder för tvIn_OutTransitionType kommer att utföras.
tvIn_OutTransitionType
Om användbart för ett lager som låter användaren välja typ av pågående övergång. Se även Övergångstyp Typ.
tvIn_PreviewMode
Kan användas för att tala om för kompositionen att den är i förhandsgranskningsläge.
tvIn_Reset
Användbar för att återställa logiken i kompositionen. Denna flagga sätts när ett lager växlas till live från off eller när man växlar mellan inställningar och ingen tvIn_Switch inmatning är tillgänglig.
tvIn_RuntimeIdentifierare
Hjälper lager att kommunicera mellan förhandsgranskning och live-instansen. Ställs in dynamiskt av mimoLive.
tvIn_Shared_
Se Dela värderingar mellan lager Värden mellan lager.
tvIn_ShowDuration
Om användaren har fyllt i showens varaktighet i showinställningarna kommer denna inmatning att ha värdet i sekunder.
tvIn_ShowTimer
Showtimern kommer att återspegla Show Timer-visningen i mimoLive-dokumentet i sekunder.
tvIn_Switch
Denna flagga sätts istället för tvIn_Reset]] när ett lager växlas från en inställning till en annan utan att lagret inaktiveras. Om denna ingång inte finns kommer [[#tvIn_Reset när ett lager växlas från en inställning till en annan utan att lagret inaktiveras. Om denna ingång inte finns, sätts istället [[#tvIn_Reset för att bibehålla kompatibiliteten med äldre lager.
tvIn_TransitionDirection
En riktning i vilken Riktning för övergång kommer att utföras.
tvIn_TransitionDuration
Ett värde i sekunder för tvIn_InTransitionTyp kommer att utföras.
tvIn_TransitionType
Om användbart för ett lager som låter användaren välja typ av pågående övergång. Se även Övergångstyp Typ.
tvIn_UISnapColor
För att hålla användargränssnittet konsekvent tillhandahåller mimoLive en "snapfärg" för att rita riktlinjerna i förhandsgranskningen när användargränssnittet snappar till ett visst värde (t.ex. håll ned "shift"-tangenten medan du roterar ett Placer-lager i anpassat visningsläge, så kommer riktlinjerna att ritas i den färgen när rotationsvinkeln snappar till 0, 45 eller 90 grader)
tvIn_VideoSource
Ett lager kan ha upp till 8 dynamiska ingångar för videokällor: "A", "B", "C" och så vidare. De kommer att representeras av en släppzon om användaren drar en videokälla från källförrådet till lagerstacken. //Note: För bakåtkompatibilitet ignoreras tillägget "Image" på dessa ingångar.//
Alternativ för inmatning
Motsvarande inmatningsknappar
Om en videoinmatningsknapp finns kommer följande inmatningsknappar också att fyllas med motsvarande information:
(t.ex. "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")
| Nyckel | Typ | Beskrivning |
|---|---|---|
| AudioGain | Antal | TBD |
| Ljudnivå0 | Antal | Vänster ljudkanals nivå i db efter förstärkningskontroll |
| Ljudnivå1 | Antal | Höger ljudkanals nivå i db efter förstärkningskontroll |
| AudioLevel0Raw | Antal | Vänster ljudkanals nivå i db före förstärkningsreglering |
| AudioLevel1Raw | Antal | Höger ljudkanals nivå i db före förstärkningskontroll |
| AudioPanning | Antal | TBD |
| Ljudvolym | Antal | TBD |
| Data | Struktur | En ordlista med metadata för källan. För närvarande är implementerade nycklar: "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier" |
| Namn | Sträng | Namn på den associerade bildkällan. Kan användas för att visa dess namn i förhandsgranskningen eller för att beräkna standardnamnet för lagervarianten. Se tvOut_SettingName . |
| Återstående tid | Antal | Om några sekunder. Tillhandahålls för filmkällor. -1 om filmkällan är loopad (eller någon annan källa). |
| TallyState | Index | Tally Status för den anslutna källan, se Tally-stater stater |
| Typ | Index | Värde av typ av källa typ |
Gruppering av ingångar
Gruppering sker i användargränssnittet - för detta är prefixet för inmatningen relevant. Syntaxen fungerar som tvGroup___. Observera den dubbla understreckningen _ _ efter gruppnamnet som en separator till inmatningsnamnet.
En särskild grupp definieras för inmatningar som alltid ska vara dolda: tvGrupp_Gömda_Ingångar Denna grupp kan göras synlig genom att sätta mimoLive i felsökningsläge i debug|Inställningar för debug|Inställningar för felsökning. Vissa lager använder dessa dolda fält för att kommunicera mellan "förhandsgranskningsinstansen" och "live-instansen" (t.ex. berättar Video Switcher-lagret för förhandsgranskningsinstansen vilken videokälla som för närvarande är live).
Dölj indata dynamiskt
Varje protokollinmatning kommer att döljas i användargränssnittet om tvOut_gömd_ Utmatning är satt till "true". Detta värde observeras av applikationen och kan ändras dynamiskt. Observera att du måste använda det fullständiga indatanamnet, inklusive "tvIn" (t.ex. använda utdata tvOut_hide_tvIn_Text_TypMultilinje för inmatning tvIn_Text_TypMultilinje).
Utgångar
| Namn | Typ |
|---|---|
| tvOut_Cursor | Sträng |
| tvOut_Done | Boolesk (signal) |
| tvOut_gömd_ | Boolesk |
| tvOut_Opaque | Boolesk |
| tvOut_SettingName | Sträng |
| tvOut_Share_ | vilken typ som helst |
| tvOut_Tid kvar | Antal |
| tvOut_UseCompositedLayersImage | Boolesk |
| tvOut_TallyState | Index för Tally-stater stater |
| tvSet_ | Typ av ingång som ska ställas in |
| tvSetSignal_ | Boolesk |
| tvSetAudioVolume_ | Antal |
| tvSetAudioVolumeSignal_ | Boolesk |
tvOut_Cursor
Detta utdata anger hur muspekaren ser ut om muspekaren är över antingen förhandsgranskningen eller programutdatavyn. Se vidare Dokumentation för Apples NSCursor-klass) för giltiga värden. Ytterligare muspekare som tillhandahålls av mimoLive är "minus" och "plus".
*Ta bort postfixet "_Cursor" eller "Cursor" från Apples NSCursor-konstanter (använd t.ex. "openHand" för att få en muspekare med öppen hand).
tvOut_Done
Används för att tala om för nästa lager att detta lager är klart. Se tvIn_OnAir för dokumentation.
tvOut_gömd_
Kan användas för att dynamiskt dölja ingångsvärden i parametervyn. Se Dölj indata dynamiskt .
tvOut_Opaque
Används för att tala om för programmet att lager under detta inte behöver ritas. Standardvärde "false". Detta värde åsidosätts av alla anslutna källor som innehåller alfa.
tvOut_SettingName
Kompositioner kan föreslå ett användbart namn för en miljö baserat på viss(a) input(s).
tvOut_Share_
Se Dela värderingar mellan lager .
tvOut_Tid kvar
Gör det möjligt för applikationen att visa en stor timernedräkning (t.ex. 5 sekunder tills en film är klar). För närvarande används "-1" för att indikera att det inte finns någon information om återstående tid eller "-2" om det är en loopad film.
tvOut_UseCompositedLayersImage
Används för att optimera prestanda vid användning av lager under med övergångar etc. Den talar om för appen att lagret för närvarande behöver den sammansatta lagerbilden som indata. mimoLive kommer att lägga in lagren under den sammansatta bilden i nästa renderingscykel. Om "tvOut_UseCompositedLayersImage" inte är närvarande antar mimoLive att lagren under bilden alltid ska läggas in. Endast ritningsoptimering, alla medier kommer ändå att rullas. Används endast om tvIn_CompositedLayersImage är närvarande.
tvOut_TallyState
Detta utgångslager kan skriva över det automatiska tally-läget för den källa som för närvarande är ansluten till den ingången. Detta är användbart för övergångar eller om källan inte används för utmatning kan tally-tillståndet stängas av (t.ex. använder Video Switcher 3 kameror men visar bara en åt gången så den måste ställa in tally-tillståndet för oanvända källor till "TVTallyStateOff"). Vänligen se Tally-stater för listan över tallystater.
tvSet_
I mimoLive kan ett lager eller filter manipulera sina egna parametrar. Detta är främst för att implementera funktionen för direkt manipulation i förhandsgranskningen av lagervarianten (t.ex. om användaren drar den analoga klockan i förhandsgranskningen, talar lagret om för mimoLive vilka ingångsknappar som ska ändras till vilket värde. Men denna funktion används också för att överföra live-data från program out-instansen till preview-instansen och vice versa (t.ex. i Video Switcher-lagret berättar program out-instansen för preview-instansen vilken videokälla som för närvarande är live och preview-instansen kan berätta för program out-instansen vilken videokälla användaren valde på skärmen).
För att använda denna funktion behöver du två utgångar som motsvarar det inmatningsfält som du vill manipulera: I 'tvSet_' matar du ut det nya värde du vill ställa in och med 'tvSetSignal_' signalerar du när värdet är giltigt och ska lagras.
tvSetSignal_
Se tvSet_ .
tvSetAudioVolume_
Denna utgång styr volymen på den associerade ljudkällan (eller ljudet från en videokälla). Giltiga värden är 0=tyst till 1=full. kompositionen måste ställa in motsvarande "tvSetAudioVolumeSignal_" varje gång den vill ändra ljudvolymnivån. Detta är t.ex. användbart om lagret har en fade-in-övergång och vill fade in ljudet också.
tvSetAudioVolumeSignal_
Se tvSetAudioVolume_ .
Dela värderingar mellan lager
Ett lager kan skicka data till andra lager i lagerstacken som ligger ovanför det själv. Data lagras av mimolive med dess delningsnyckel fram till nästa renderingscykel. Om ett lager används flera gånger (eller om samma delningsnyckel används i olika lager) skrivs data över av lagret ovanför. För att ställa in dessa delningsdata använder du en "tvOut_Share_"-utgång. Du kan lagra vilken QuartzComposer-datatyp som helst, men en struct rekommenderas eftersom du bara behöver en utmatning för flera värden. På mottagarlagrets sida behöver du en motsvarande "tvIn_Shared_" input med exakt samma datatyp. Observera att det mottagande lagret måste vara ovanpå det sändande lagret i lagerstacken.
Att dela värden är användbart om du behöver samma data i flera lager (t.ex. namnet på hemmalagets och gästernas motståndare i en match).
Typdefinitioner (aka. namngivningskonventioner)
| Nyckel | Typ | Beskrivning |
|---|---|---|
| *_TypAudio | Bild | Detta är ett mycket speciellt fall: En _TypeAudio kan bara tilldela källor som innehåller ljud (t.ex. filmkällor, videokällor eller Audio Only-källor). Lagret kommer att få kontroll över denna källa (i framtiden) samt ljudvolymvärdena för vänster och höger kanal via ingångarna "_TypeAudioAudioLevel0" och "_TypeAudioAudioLevel1". |
| *_TypBoinxX | Antal | Ett tal som anges i Boinx X-koordinater - t.ex. -1 är den första pixeln, 1 är den sista pixeln i den aktuella skärmdimensionen. kommer att presenteras för användaren i pixlar |
| *_TypBoinxY | Antal | Ett tal som anges i Boinx Y-koordinater - t.ex. -1 är den nedersta pixeln, 1 är den översta pixeln i de aktuella skärmdimensionerna. kommer att presenteras för användaren i pixlar |
| *_TypDirectoryPath | Sträng | resulterar i en "Välj..."-knapp i användargränssnittet, kanske också med en sökvägskontroll |
| *_TypDuration | Antal | Tid i sekunder - visas i minuter:sekunder och kan få ett anpassat användargränssnitt |
| *_TypFilePath | Sträng | resulterar i en "Välj..."-knapp i användargränssnittet, kanske också med en sökvägskontroll |
| *_TypFontBoinxSize | Sträng | Fontstorlek i Boinx Y-koordinater (t.ex. 2 är hela skärmens höjd), se anmärkning nedan |
| *_TypFontFärg | Färg | Vanlig färginmatning för att ange en textfärg, se anmärkning nedan |
| *_TypFontName | Sträng | Detta kommer att resultera i en teckensnittsväljare, se anmärkning nedan |
| *_TypMultilinje | Sträng | Ett textfält med flera rader som tillåter inmatning av retur |
| *_TypLösenord | Sträng | Visar en textruta för lösenord. Viktigt: Själva lösenordet lagras i klartext och kan läsas i dokumentet! |
| *_TypSignal | Boolesk | För en pulsad signal med en bildruta, använd patcherna Pulse eller Watcher |
*Fälten _TypeFontName, _TypeFontBoinxSize och _TypeFontColor kombineras till ett Font Chooser UI element i parametervyn för lager om de har samma basetikett.
Filtermallar
Dessa ingångar och egenskaper är specifika för om du skapar en kvartskomposition som ska användas som ett bildfilter i mimoLive. De flesta av de tidigare definitionerna gäller även för filter.
Filteringångar
Följande inmatningsfält krävs av Quartz Composer för en filterkomposition:
| Namn | Typ | Beskrivning |
|---|---|---|
| _protokollInput_PreviewMode | Bool | Kan användas för att tala om för kompositionen att den är i förhandsgranskningsläge |
| _protokollInput_X | Antal | Är alltid 0. |
| _protokollInput_Y | Antal | Är alltid 0. |
Egenskaper för filter
Följande egenskaper definieras av mimoLive. tv_FilterIdentifier och tv_FilterVersion krävs för att hantera filtret och dess uppdateringsväg med nyare versioner:
| Namn | Typ | Provvärde | Beskrivning |
|---|---|---|---|
| tv_FilterIdentifierare | Sträng | com.boinx.mimoLive.lager.placer | För identifiering levererade Boinx kompositioner och sorterade olika versioner |
| tv_FilterVersion | Antal (dubbel) | 1 | För matchning av olika versioner av en komposition i ett dokument/applikation. Stora versionsnummer anger inkompatibilitet och matchar inte med andra stora versioner. Mindre versionsnummer måste vara kompatibla uppåt och ökas med 0,001 varje iteration. T.ex. måste det säkerställas att laddningsinställningar från ett 1.0-lager för ett 1.013-lager måste se exakt likadana ut, vilket innebär att nya tangenter, om de finns, måste ha en standard som inte visar dem eller som motsvarar utseendet på den tidigare versionen. |
| tv_FilterOutputIsOpaque | BOOL | Anger om en filterutmatning är ogenomskinlig. Standardvärdet är NO |
Uppräkningar
Quartz Composer-typen Index tillåter namngivna index. De kan redigeras i Quartz Composer Editor genom att lägga till en indatadelare i indexläge.
Källa Typ
Källan kommer att vara ett av följande värden
- 0 - Bild
- 1 - Film, en film kommer att ha en återstående tid
- 2 - Kamera, kan också vara en komposition
Riktning för övergång
Du kan definiera dina egna riktningar. De skickade lagren använder följande värden.
- Ingen
- Vänster
- Rätt
- Upp
- Ner
Typ av övergång
Du kan definiera dina egna övergångstyper. Här är några användbara exempelvärden.
- Upplösning
- Torka av
Tally-stater
Det finns flera Tally States för videokällor definierade som kommer att representeras i användargränssnittet och i Tally Light-appen.
- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram