Benutzerdefinierte Schicht-API

Protokoll Version 1.2

Einführung

mimoLive verwendet Apples Quartz Composer Technologie und deren Dokumente für die Ebenen. Da mimoLive dem Quartz Composer-Dokument einige Umgebungsparameter mitteilen und Ergebnisse daraus lesen muss, haben wir ein Protokoll entwickelt, das Sie befolgen müssen, um alle Funktionen von mimoLive nutzen zu können. Im Folgenden finden Sie alle technischen Informationen über dieses Protokoll.

Wenn Sie erfahren möchten, wie Sie mit Quartz Composer benutzerdefinierte Layer erstellen können, lesen Sie bitte "Creating Customer Layers for mimoLive":de:pro:custom_layer:creating_custom_layers.

Eigenschaften

Sie können das Protokoll im Quartz Composer bearbeiten, indem Sie Herausgeber ⇢ Informationen bearbeiten (⌥⌘I)

Name	Erforderlich	Typ	Beispielwert
Kategorie		Zeichenfolge
Copyright		Zeichenfolge	© 2016 MySoftwareCompany
Beschreibung		Zeichenfolge	Spielt eine Vollbild-Eingabe ab
Name	ja	Zeichenfolge	Vollbildschirm-Player
ABGESCHLOSSEN tv_Kategorien		Zeichenfolge	Kulisse,Vollbild
tv_Debug		Boolesche
tv_FileData_ Eingabe-Name		Daten	(importierte XML-Datei)
tv_Dateiname_ Eingabe-Name		Zeichenfolge	Standings.xml
tv_HelpURL		Zeichenfolge
tv_HiddenInputKeys		Array von Zeichenketten
tv_InputLabel_ Eingabe-Name		Zeichenfolge	Video-Eingang
tv_LayerIdentifier	ja	Zeichenfolge	com.example.layer.mylayer
tv_LayerVersion	ja	Zahl (real)	1.01
tv_LayerPreview		Daten	(importierte PNG-Datei)
tv_LayerProtokollVersion	ja	Zahl (real)	1
tv_SortSchlüssel		Zeichenfolge
tv_StepSize_ Eingabe-Name		Zahl (real)	0.1
ABGESCHLOSSEN tv_Tagline		Zeichenfolge	Spielt eine Vollbild-Eingabe ab
tv_UseAudioFromSource		Zeichenfolge	tvIn_VideoSourceA
tv_UnitLabel_ Eingabe-Name		Zeichenfolge

Kategorie

Die Kategorie wird in der Regel vom Quartz-Composer gesetzt und wird für mimoLive-Ebenen nicht benötigt. Für mimoLive-Kategorien siehe tv_Kategorien stattdessen.

Copyright

Das Copyright wird normalerweise von Quartz composer gesetzt und wird für mimoLive-Ebenen nicht benötigt.

Beschreibung

Quartz Composer-Standard - halten Sie ihn etwa 3 Zeilen lang, damit er gut in die Vorschau passt.

Name

Der Name wird innerhalb von mimoLive angezeigt. Verwenden Sie einen kurzen und eindeutigen Namen, um Ihre Ebene schnell zu finden.

Protokolle

Dieses Array wird normalerweise vom Quartz-Composer gesetzt und wird für mimoLive-Schichten nicht benötigt.

tv_Kategorien

ABGESCHLOSSEN

Die Kategorien wurden zum Gruppieren und Filtern der Ebenen verwendet. Derzeit werden sie ignoriert, können aber wieder aktiviert werden. Verwenden Sie eine kommagetrennte Liste der folgenden vordefinierten Kategorien oder definieren Sie Ihre eigenen.

- "Audio" - Ebenen, die die Möglichkeit bieten, eine Audioquelle zu verwenden
- "Overlay" - Ebenen, die Daten oder Bilder überlagern: Lower Thirds, Titel, Logo, ...
- "Vollbild" - Ebenen, die zumindest in den Standardeinstellungen ein Vollbild bieten - z. B. Animationen, Einzelvideo, Wetterkarte
- "Backdrop" - Ebenen, die als Hintergrund für andere Dinge dienen, die darüber liegen.
- Text" - Ebenen, die eine Art von Textanzeige bieten, z. B. Abspann, Lower Thirds, Überschrift
- "Daten" - Ebenen, die Daten anzeigen, z. B. Börsenticker, Basketballergebnisse usw.
- "Bild" - Ebenen, die die Möglichkeit bieten, ein statisches Bild einzugeben
- "Multivideo" - Ebenen, die mindestens zwei Quellen kombinieren, entweder durch Hinzufügen von mindestens einer Quelle zusätzlich zu den darunter liegenden Ebenen oder durch Verwendung von zwei oder mehr Quellen.
- 3D" - Ebenen, die eine Art 3D-Positionierung von Elementen bieten, z. B. Presenter
- "Segment" - Ebenen, die eine zeitgesteuerte Animation für einzelne Segmente bieten, z. B. Digital Upgrade Beitrag
- "Effekt" - Ebenen, die einige Überlagerungseffekte bieten, z.B. Lupe, Spotlight, Zoom...
- "Demo" - Ebenen, die eher zur Demonstration von Fähigkeiten als zur Bereitstellung allgemeiner nützlicher Funktionen gedacht sind, z. B. die Wetterkarte, die lediglich eine Karte von Deutschland zeigt.
- "Consumer" - Ebenen, die das Compositedlayers-Bild verwenden, z. B. Video Switcher, Zoom, Presenter
- "Generator" - Ebenen, die eine Art von generierter Ausgabe liefern, z. B. Animationen
- Debug" - Für die Fehlersuche nützliche Ebenen, die im Endprodukt nicht sichtbar sind

tv_Debug

Der Anwendung mitteilen, dass diese Komposition nur in einer Debugging-Umgebung verwendet werden soll.

tv_FileData_

Ein Datenblob, der bei der Erstellung der Ebene für eine Dateieingabe erstellt und in das Dokument geschrieben wird. Dies funktioniert für Textdateien, die in einem _TypeFilePath angegeben werden, oder .mov-Dateien für Bildeingaben. Siehe tv_Dateiname_ .

tv_Dateiname_

Der entsprechende Dateiname für die tv_FileData_ . Erforderlich, wenn ein tv_FileData_*-Eingang vorhanden ist.

tv_HelpURL

In dieser Zeichenkette kann eine URL mit hilfreichen Informationen über die Verwendung dieser Ebene gespeichert werden. mimoLive präsentiert eine "?"-Schaltfläche im Informations-Popover für jede Ebene. Wenn der Benutzer auf diese Schaltfläche klickt, wird die URL mit dem Standard-Internetbrowser des Systems geöffnet.

tv_HiddenInputKeys

In diesem Array enthält die Komposition Eingabetasten, die vor der Benutzeroberfläche verborgen werden sollen.

tv_InputLabel_

Kann verwendet werden, um eine alternative Namensbezeichnung für den angegebenen Eingabeschlüssel in der Parameteransicht anzugeben. Leere Zeichenfolgen für keine Bezeichnungen sind ebenfalls möglich. Funktioniert wie der tv_hide_ouput z. B. muss der Protokolleingangsname vollständig sein (z. B. "tv_InputLabel_tvIn_VideoSourceAImage").

tv_LayerIdentifier

Zur Identifizierung lieferte Boinx Zusammenstellungen und sortierte verschiedene Versionen. Sie müssen eindeutig sein. Es wird eine Domäne mit umgekehrter Notation empfohlen. Beispiel: com.mysoftware.layers.videofullscreen

tv_LayerVersion

Für den Abgleich verschiedener Versionen einer Komposition in einem Dokument/einer Anwendung. Hauptversionsnummern stehen für Inkompatibilität und passen nicht zu anderen Hauptversionen (z. B. müssen Sie die Hauptversion erhöhen, wenn sich der Name des Eingabeschlüssels ändert). Minor-Versionsnummern müssen aufwärtskompatibel sein und können bei jeder Iteration um 0,001 erhöht werden. Es muss z. B. sichergestellt werden, dass das Laden von Einstellungen aus einer 1.0-Ebene in eine 1.013-Ebene genau gleich aussehen muss, d. h. neue Tasten müssen, falls vorhanden, einen Standardwert haben, der sie nicht anzeigt oder dem Aussehen der vorherigen Version entspricht.

tv_LayerPreview

Bilddaten, die für die Vorschau einer Ebene innerhalb der Ebenenliste verwendet werden sollen. Dies kann zu einem besseren Ergebnis führen als die standardmäßige Schnellvorschau. Das Vorschaubild sollte 256 × 256 Pixel groß sein.

tv_LayerProtokollVersion

Für zukünftige Abwärtskompatibilität, falls mimoLive das Protokoll wesentlich ändert. Muss derzeit auf 1 gesetzt werden.

tv_SortSchlüssel

Definiert die Sortierung der Ebenen in mimoLive. So können Sie die Filter nach der Wahrscheinlichkeit der Verwendung sortieren. Derzeit wird ein Schema mit 2 Großbuchstaben verwendet, z.B. "BM", "DE", "DM", etc. HINWEIS: Derzeit wird diese Funktion nicht genutzt, aber in Zukunft wird sie genutzt werden.

tv_StepSize_

Kann verwendet werden, um eine benutzerdefinierte StepSize für die Jogwheels anzugeben - eine Ein-Pixel-Mausbewegung entspricht dann diesem Betrag der Veränderung (auch +/- Klick).

tv_Tagline

ABGESCHLOSSEN
Einzeilige Zeichenfolge, die im Info-Popover im Ebenen-Repository angezeigt wird.

tv_UseAudioFromSource

mimoLive kann derzeit nur eine Audiosteuerung in der Benutzeroberfläche anzeigen. Diese Eigenschaft teilt ihm mit, welche Eingabetaste gesteuert werden soll. Geben Sie die vollständige entsprechende Eingabetaste ein. (Aus Gründen der Abwärtskompatibilität akzeptiert dieses Feld auch "A", "B" oder "C", was in die Tasten tvIn_VideoSourceAImage, tvIn_VideoSourceBImage oder tvIn_VideoSourceCImage übersetzt wird. Wenn nicht angegeben, geht mimoLive davon aus, dass kein Audio mit dieser Ebene verwendet wird.

tv_UnitLabel_

Kann verwendet werden, um eine Einheitenbezeichnung, z. B. "pt", für die angegebene Eingabetaste in der Parameteransicht anzugeben. So kurz wie möglich halten. Hilft zu vermitteln, was die Eingabe bedeutet. Boinx-Einheitseingaben werden automatisch mit "px" beschriftet.

Eingaben

Name	Typ
tvIn_AccountTwitterConsumerKey	Zeichenfolge
tvIn_AccountTwitterConsumerSecret	Zeichenfolge
tvIn_AccountTwitterTokenKey	Zeichenfolge
tvIn_AccountTwitterTokenSecret	Zeichenfolge
tvIn_CompositedLayersImage	Bild
tvIn_FrameCount	Index
tvIn_FrameDuration	Nummer
tvIn_CompositedLayersImage	Bild
tvIn_InTransitionDirection	Index Richtung des Übergangs Richtung
tvIn_InTransitionDuration	Nummer
tvIn_InTransitionType	Index Übergangstyp Typ
tvIn_KeyboardModifierAlt	Boolesche
tvIn_KeyboardModifierCommand	Boolesche
tvIn_KeyboardModifierControl	Boolesche
tvIn_KeyboardModifierFunction	Boolesche
tvIn_KeyboardModifierShift	Boolesche
tvIn_Obscured	Boolesche
tvIn_OnAir	Boolesche
tvIn_OSVersion	Zeichenfolge
tvIn_OutTransitionDirection	Index Richtung des Übergangs Richtung
tvIn_OutTransitionDuration	Nummer
tvIn_OutTransitionType	Index Übergangstyp Typ
tvIn_PreviewMode	Boolesche
tvIn_Rücksetzen	Boolescher Wert (Signal)
tvIn_RuntimeIdentifier	Zeichenfolge
tvIn_Shared_	jede Wertart
tvIn_ShowDuration	Nummer
tvIn_ShowTimer	Nummer
tvIn_Switch	Boolescher Wert (Signal)
tvIn_TransitionDirection	Index Richtung des Übergangs Richtung
tvIn_TransitionDuration	Nummer
tvIn_TransitionType	Index Übergangstyp Typ
tvIn_UISnapColor	Farbe
tvIn_VideoSourceA B C D	Bild

tvIn_AccountTwitterConsumerKey

tvIn_AccountTwitterConsumerSecret

tvIn_AccountTwitterTokenKey

tvIn_AccountTwitterTokenSecret

Diese vier AccountTwitter-Eingänge werden verwendet, um die Anmeldedaten von mimoLive Twitter Account Preferences in die Komposition einzuspeisen. Die Werte werden mit dem JSON Patch und dem OAuth Patch Patch verwendet, um Daten aus dem Twitter-Dienst zu lesen.

tvIn_CompositedLayersImage

Wenn dieser Eingang in einer Komposition vorhanden ist und es Inhalte aus den darunter liegenden Ebenen gibt, wird das Ergebnis der Zeichnung der darunter liegenden Ebenen in diesen Eingang eingespeist.

tvIn_FrameCount

Diese Eingabe liefert die Gesamtzahl der gerenderten Bilder nach dem Start von mimoLive. Wenn Frames ausgelassen wurden, weil die Renderlast zu hoch ist, springt die Frame-Anzahl über diese ausgelassenen Frames.

tvIn_FrameDuration

Die Bilddauer ist der Zeitabstand zwischen den einzelnen Renderings in Sekunden.

tvIn_InTransitionDirection

Eine Richtung, in der die Übergangsrichtung ausgeführt wird.

tvIn_InTransitionDuration

Ein Wert in Sekunden, den die tvIn_InTransitionType durchgeführt werden.

tvIn_InTransitionType

Nützlich für eine Ebene, bei der der Benutzer den Typ des laufenden Übergangs wählen kann. Siehe auch Übergangstyp Typ.

tvIn_KeyboardModifierAlt

tvIn_KeyboardModifierCommand

tvIn_KeyboardModifierControl

tvIn_KeyboardModifierFunction

tvIn_KeyboardModifierShift

Diese booleschen Eingabefelder werden auf true gesetzt, wenn der Benutzer die entsprechende Modifizierungstaste auf der Tastatur drückt. Diese Funktion wird hauptsächlich für die direkte Manipulation verwendet. Welche Modifikatortaste für welche Funktion in der Benutzeroberfläche verwendet werden sollte, entnehmen Sie bitte den Apple Human User Guide Lines.

tvIn_Obscured

Diese Eingabe wird auf true gesetzt, wenn die Ebene keine Ausgabe benötigt, weil eine darüber liegende Ebene sie ohnehin verdeckt, indem sie den gesamten Bildschirm zeichnet. Dies kann verwendet werden, um ein starkes Zeichnen durch Ebenen zu vermeiden, die nicht sichtbar sind, aber als live eingestellt sind. (Im Fall der Twitter-Ebene wird die Ebene z. B. auch dann aufgerufen, wenn sie von einer anderen Ebene verdeckt wird, und erhält so die Möglichkeit, die Internetverbindung zum Twitter-Dienst aufrechtzuerhalten.)

tvIn_OnAir

Diese Eingabe beginnt mit einem Wert von "true". Sobald der Eingang den Wert "false" annimmt, sollte die Komposition alle ausgehenden Übergänge durchführen und dann den Ausgang "Done" setzen, wenn dieser beendet ist. Die Komposition wird dann deaktiviert. Es kann vorkommen, dass die Anwendung eine Schicht ausschaltet, ohne auf das Done-Flag zu warten.

tvIn_OSVersion

Diese Zeichenketteneingabe wird auf die aktuelle OS X-Version gesetzt (z.B. "Version 10.11.2 (Build 265341)").

tvIn_OutTransitionDirection

Ein Wert in Sekunden der tvIn_OutTransitionType durchgeführt werden. Siehe auch Transition Direction.

tvIn_OutTransitionDuration

Ein Wert in Sekunden der tvIn_OutTransitionType durchgeführt werden.

tvIn_OutTransitionType

Nützlich für eine Ebene, bei der der Benutzer den Typ des laufenden Übergangs wählen kann. Siehe auch Übergangstyp Typ.

tvIn_PreviewMode

Kann verwendet werden, um der Komposition mitzuteilen, dass sie sich im Vorschaumodus befindet.

tvIn_Rücksetzen

Nützlich zum Zurücksetzen der Logik der Komposition. Dieses Flag wird gesetzt, wenn eine Ebene von "Aus" auf "Live" umgeschaltet wird oder wenn zwischen Einstellungen und "Kein" gewechselt wird. tvIn_Switch Eingang verfügbar ist.

tvIn_RuntimeIdentifier

Hilft Ebenen bei der Kommunikation zwischen Vorschau und Live-Instanz. Wird dynamisch von mimoLive gesetzt.

tvIn_Shared_

Siehe Gemeinsame Nutzung von Werten zwischen Layern Werte zwischen Schichten.

tvIn_ShowDuration

Wenn der Benutzer in den Show-Einstellungen die Dauer der Show angegeben hat, enthält diese Eingabe den Wert in Sekunden.

tvIn_ShowTimer

Der Show-Timer spiegelt die Anzeige des Show-Timers des mimoLive-Dokuments in Sekunden wieder.

tvIn_Switch

Dieses Flag wird anstelle von tvIn_Reset]], wenn eine Ebene von einer Einstellung auf eine andere umgeschaltet wird, ohne die Ebene zu deaktivieren. Falls dieser Eingang nicht vorhanden ist, wird der [[#tvIn_Reset wenn eine Ebene von einer Einstellung auf eine andere umgestellt wird, ohne die Ebene zu deaktivieren. Falls dieser Eingang nicht vorhanden ist, wird stattdessen der Wert "#tvIn_Reset" gesetzt, um die Kompatibilität mit älteren Ebenen zu wahren.

tvIn_TransitionDirection

Eine Richtung, in der die Richtung des Übergangs durchgeführt werden.

tvIn_TransitionDuration

Ein Wert in Sekunden der tvIn_InTransitionType durchgeführt werden.

tvIn_TransitionType

Nützlich für eine Ebene, bei der der Benutzer den Typ des laufenden Übergangs wählen kann. Siehe auch Übergangstyp Typ.

tvIn_UISnapColor

Um die Benutzeroberfläche konsistent zu halten, bietet mimoLive eine "Fangfarbe", in der die Hilfslinien in der Vorschau gezeichnet werden, wenn die Benutzeroberfläche auf einen bestimmten Wert einrastet (z.B. halten Sie die "Shift"-Taste gedrückt, während Sie eine Placer-Ebene im benutzerdefinierten Anzeigemodus drehen, dann werden die Hilfslinien in dieser Farbe gezeichnet, wenn der Drehwinkel auf 0, 45 oder 90 Grad einrastet)

tvIn_VideoSource

Eine Ebene kann bis zu 8 dynamische Videoquelleneingänge haben: "A", "B", "C" und so weiter. Sie werden durch eine Drop-Zone dargestellt, wenn der Benutzer eine Videoquelle aus dem Quellenspeicher auf den Ebenenstapel zieht. //Hinweis: Aus Gründen der Abwärtskompatibilität wird die Erweiterung "Image" bei diesen Eingängen ignoriert.

Eingabe-Optionen

Entsprechende Eingabe-Tasten

Wenn eine Videoeingabetaste vorhanden ist, werden auch die folgenden Eingabetasten entsprechend mit Informationen gefüllt:

(z. B. "tvIn_VideoSourceA" -> "tvIn_VideoSourceAName")

Schlüssel	Typ	Beschreibung
AudioGain	Nummer	TBD
AudioLevel0	Nummer	Pegel des linken Audiokanals in db nach der Verstärkungsregelung
AudioLevel1	Nummer	Pegel des rechten Audiokanals in db nach der Verstärkungsregelung
AudioLevel0Raw	Nummer	Pegel des linken Audiokanals in db vor der Verstärkungsregelung
AudioLevel1Raw	Nummer	Pegel des rechten Audiokanals in db vor der Verstärkungsregelung
AudioPanning	Nummer	TBD
AudioVolume	Nummer	TBD
Daten	Struktur	Ein Wörterbuch mit Metadaten der Quelle. Derzeit sind folgende Schlüssel implementiert: "index" "duration" "title" "titleFallback" "artist" "album" "year" "fileReferenceIdentifier"
Name	Zeichenfolge	Name der zugehörigen Bildquelle. Kann verwendet werden, um den Namen in der Vorschau anzuzeigen oder um den Standardnamen für die Ebenenvariante zu berechnen. Siehe tvOut_SettingName .
Restlaufzeit	Nummer	In Sekunden. Wird für Filmquellen bereitgestellt. -1, wenn die Filmquelle eine Schleife ist (oder eine andere Quelle).
TallyState	Index	Tally Status der angeschlossenen Quelle, siehe Tally Staaten Staaten
Typ	Index	Wert der Quellentyp Typ

Eingaben gruppieren

Die Gruppierung erfolgt in der Benutzeroberfläche - dafür ist das Präfix der Eingabe relevant. Die Syntax funktioniert wie tvGroup___. Bitte beachten Sie den doppelten Unterstrich _ _ nach dem Gruppennamen als Trennzeichen zum Eingabenamen.

Für Eingaben, die immer ausgeblendet sein sollen, wird eine spezielle Gruppe definiert: tvGroup_Hidden_Inputs__ Diese Gruppe kann sichtbar gemacht werden, indem man mimoLive in den Debug-Modus in der debug|Debug-Einstellungen|Debug-Voreinstellungen. Einige Ebenen verwenden diese ausgeblendeten Felder zur Kommunikation zwischen der "Vorschauinstanz" und der "Live-Instanz" (z. B. teilt die Ebene "Video Switcher" der Vorschauinstanz mit, welche Videoquelle gerade live ist).

Eingaben dynamisch ausblenden

Jede Protokolleingabe wird in der Benutzeroberfläche ausgeblendet, wenn die tvOut_hide_ Die Ausgabe wird auf "wahr" gesetzt. Dieser Wert wird von der Anwendung beobachtet und kann dynamisch geändert werden. Beachten Sie, dass Sie den vollständigen Namen der Eingabe verwenden müssen, einschließlich "tvIn" (z. B. verwenden Sie die Ausgabe tvOut_hide_tvIn_Text_TypeMultiline für die Eingabe tvIn_Text_TypMehrzeilig).

Ausgänge

Name	Typ
tvOut_Cursor	Zeichenfolge
tvOut_Done	Boolescher Wert (Signal)
tvOut_hide_	Boolesche
tvOut_Opaque	Boolesche
tvOut_SettingName	Zeichenfolge
tvOut_Share_	jede Art
tvOut_TimeRemaining	Nummer
tvOut_UseCompositedLayersImage	Boolesche
tvOut_TallyState	Index der Tally Staaten Staaten
tvSet_	Art des zu setzenden Eingangs
tvSetSignal_	Boolesche
tvSetAudioVolume_	Nummer
tvSetAudioVolumeSignal_	Boolesche

tvOut_Cursor

Diese Ausgabe gibt an, wie der Mauszeiger aussieht, wenn er sich entweder über der Vorschau- oder der Programmausgabeansicht befindet. Bitte beachten Sie Apples NSCursor-Klassen-Dokumentation) für gültige Werte. Zusätzliche Mauszeiger, die mimoLive zur Verfügung stellt, sind "Minus" und "Plus".

*Entfernen Sie das Postfix "_Cursor" oder "Cursor" aus Apples NSCursor-Konstanten (z.B. verwenden Sie "openHand", um einen Mauszeiger mit offener Hand zu erhalten).

tvOut_Done

Wird verwendet, um der nächsten Ebene mitzuteilen, dass diese Ebene fertig ist. Siehe tvIn_OnAir für die Dokumentation.

tvOut_hide_

Kann verwendet werden, um Eingabewerte in der Parameteransicht dynamisch auszublenden. Siehe Eingaben dynamisch ausblenden .

tvOut_Opaque

Wird verwendet, um der Anwendung mitzuteilen, dass darunter liegende Ebenen nicht gezeichnet werden müssen. Voreinstellung "false". Dieser Wert wird von jeder verbundenen Quelle, die Alpha enthält, überschrieben.

tvOut_SettingName

Kompositionen können einen nützlichen Namen für eine Einstellung vorschlagen, der auf einigen Eingaben basiert.

tvOut_Share_

Siehe Gemeinsame Nutzung von Werten zwischen Layern .

tvOut_TimeRemaining

Ermöglicht es der Anwendung, einen großen Timer-Countdown anzuzeigen (z. B. 5 Sekunden bis zum Ende eines Films). Derzeit wird "-1" verwendet, um anzuzeigen, dass es keine Informationen über die verbleibende Zeit gibt, oder "-2", wenn es sich um eine Filmschleife handelt.

tvOut_UseCompositedLayersImage

Wird zur Optimierung der Leistung bei der Verwendung von Ebenen unterhalb von Übergängen usw. verwendet. Es teilt der Anwendung mit, dass die Ebene derzeit die Eingabe des Bildes der zusammengesetzten Ebenen benötigt. mimoLive wird die Ebenen unterhalb des zusammengesetzten Bildes im nächsten Rendering-Zyklus einfügen. Wenn "tvOut_UseCompositedLayersImage" nicht vorhanden ist, nimmt mimoLive an, dass die Ebenen unterhalb des Bildes immer eingefügt werden sollen. Nur Zeichenoptimierung, alle Medien werden trotzdem gerollt. Wird nur verwendet, wenn tvIn_CompositedLayersImage vorhanden ist.

tvOut_TallyState

Diese Ausgabeschicht kann den automatischen Tally-Status der Quelle überschreiben, die derzeit an diesen Eingang angeschlossen ist. Dies ist nützlich für Übergänge oder wenn die Quelle nicht für die Ausgabe verwendet wird, kann der Tally-Status ausgeschaltet werden (z. B. verwendet der Video Switcher drei Kameras, zeigt aber immer nur eine an, sodass der Tally-Status für nicht verwendete Quellen auf "TVTallyStateOff" gesetzt werden muss). Siehe dazu Tally Staaten für die Liste der Kontrollzustände.

tvSet_

In mimoLive kann eine Ebene oder ein Filter seine eigenen Parameter manipulieren. Dies dient hauptsächlich dazu, die direkte Manipulation in der Vorschau der Ebenenvariante zu implementieren (z.B. wenn der Benutzer die Analoguhr in der Vorschau zieht, sagt die Ebene mimoLive, welche Eingabetasten auf welchen Wert geändert werden sollen. Diese Funktion wird aber auch verwendet, um Live-Daten von der Programm-Out-Instanz an die Vorschau-Instanz zu übertragen und umgekehrt (z.B. in der Ebene Video Switcher teilt die Programm-Out-Instanz der Vorschau-Instanz mit, welche Videoquelle gerade live ist und die Vorschau-Instanz kann der Programm-Out-Instanz mitteilen, welche Videoquelle der Benutzer auf dem Bildschirm ausgewählt hat).

Um diese Funktion zu nutzen, benötigen Sie zwei Ausgänge, die dem Eingabefeld entsprechen, das Sie manipulieren wollen: Mit 'tvSet_' geben Sie den neuen Wert aus, den Sie setzen wollen, und mit 'tvSetSignal_' signalisieren Sie, wenn der Wert gültig ist und gespeichert werden soll.

tvSetSignal_

Siehe tvSet_ .

tvSetAudioVolume_

Dieser Ausgang steuert die Lautstärke der zugehörigen Audioquelle (oder Audio einer Videoquelle). Gültige Werte sind 0=leise bis 1=voll. Die Komposition muss das entsprechende "tvSetAudioVolumeSignal_" jedes Mal setzen, wenn sie die Audiolautstärke ändern will. Dies ist z. B. nützlich, wenn die Ebene einen Einblendungsübergang hat und auch den Ton einblenden möchte.

tvSetAudioVolumeSignal_

Siehe tvSetAudioVolume_ .

Gemeinsame Nutzung von Werten zwischen Layern

Eine Ebene kann Daten an andere Ebenen im Ebenenstapel senden, die sich über ihr befinden. Die Daten werden von mimolive unter ihrem Freigabeschlüssel bis zum nächsten Rendering-Zyklus gespeichert. Wenn eine Ebene mehrfach verwendet wird (oder derselbe Freigabeschlüssel in verschiedenen Ebenen verwendet wird), werden die Daten von der darüber liegenden Ebene überschrieben. Um diese Freigabedaten zu setzen, verwenden Sie einen "tvOut_Share_"-Ausgang. Sie können jeden QuartzComposer-Datentyp speichern, es wird jedoch ein struct empfohlen, da Sie nur einen Ausgang für mehrere Werte benötigen. Auf der Seite der empfangenden Schicht benötigen Sie einen entsprechenden "tvIn_Shared_"-Eingang mit demselben Datentyp. Bitte beachten Sie, dass die empfangende Ebene im Ebenenstapel über der sendenden Ebene liegen muss.

Die gemeinsame Nutzung von Werten ist nützlich, wenn Sie dieselben Daten in mehreren Ebenen benötigen (z. B. die Namen der Heim- und Gastgegner in einem Spiel).

Typdefinitionen (auch bekannt als Namenskonventionen)

Schlüssel	Typ	Beschreibung
*_TypAudio	Bild	Dies ist ein sehr spezieller Fall: Ein _TypeAudio kann nur Quellen zuweisen, die Audio enthalten (z.B. Filmquellen, Videoquellen oder reine Audioquellen). Der Layer erhält (in Zukunft) die Kontrolle über diese Quelle sowie die Lautstärkewerte für den linken und rechten Kanal über die Eingänge "_TypeAudioAudioLevel0" und "_TypeAudioAudioLevel1".
*_TypBoinxX	Nummer	Eine Zahl, die in Boinx X-Koordinaten eingegeben wird - z. B. -1 ist das erste Pixel, 1 ist das letzte Pixel der aktuellen Bildschirmabmessungen. wird dem Benutzer in Pixeln angezeigt
*_TypBoinxY	Nummer	Eine Zahl, die in Boinx-Y-Koordinaten eingegeben wird - z. B. -1 ist das unterste Pixel, 1 ist das oberste Pixel der aktuellen Bildschirmabmessungen. wird dem Benutzer in Pixeln angezeigt
*_TypeDirectoryPath	Zeichenfolge	Das Ergebnis ist eine Schaltfläche "Auswählen..." in der Benutzeroberfläche, die möglicherweise auch eine Pfadkontrolle anzeigt.
*_TypeDuration	Nummer	Zeit in Sekunden - wird in Minuten:Sekunden angezeigt und kann ein benutzerdefiniertes UI erhalten
*_TypDateipfad	Zeichenfolge	Das Ergebnis ist eine Schaltfläche "Auswählen..." in der Benutzeroberfläche, die möglicherweise auch eine Pfadkontrolle anzeigt.
*_TypeFontBoinxSize	Zeichenfolge	Schriftgröße in Boinx-Y-Koordinaten (z. B. 2 ist die Höhe des gesamten Bildschirms), siehe Hinweis unten
*_TypeFontColor	Farbe	Reguläre Farbeingabe zur Angabe einer Textfarbe, siehe Hinweis unten
*_TypeFontName	Zeichenfolge	Dies führt zu einer Schriftauswahl, siehe Hinweis unten
*_TypMehrzeilig	Zeichenfolge	Ein mehrzeiliges Textfeld, das die Eingabe von Rückgaben erlaubt
*_TypPasswort	Zeichenfolge	Zeigt ein Passwort-Textfeld an. Wichtig: Das Passwort selbst ist im Klartext gespeichert und im Dokument lesbar!
*_TypSignal	Boolesche	Für ein gepulstes Einzelbildsignal verwenden Sie die Patches Pulse oder Watcher

*Das Feld _TypeFontName, das Feld _TypeFontBoinxSize und das Feld _TypeFontColor werden in der Ebenenparameteransicht zu einem Font Chooser-Oberflächenelement zusammengefasst, wenn sie dieselbe Basisbezeichnung haben.

Filter-Vorlagen

Diese Eingaben und Eigenschaften sind spezifisch für den Fall, dass Sie eine Quartz-Komposition zur Verwendung als Bildfilter in mimoLive erstellen. Die meisten der vorherigen Definitionen gelten auch für Filter.

Filter-Eingänge

Die folgenden Eingabefelder werden vom Quartz Composer für eine Filterkomposition benötigt:

Name	Typ	Beschreibung
_protocolInput_PreviewMode	Bool	Kann verwendet werden, um der Komposition mitzuteilen, dass sie sich im Vorschaumodus befindet
_protokolleingabe_X	Nummer	Ist immer 0.
_protokolleingabe_Y	Nummer	Ist immer 0.

Filter-Eigenschaften

Die folgenden Eigenschaften werden von mimoLive definiert. tv_FilterIdentifier und tv_FilterVersion werden benötigt, um den Filter und seinen Update-Pfad mit neueren Versionen zu behandeln:

Name	Typ	Beispielwert	Beschreibung
tv_FilterBezeichner	Zeichenfolge	com.boinx.mimoLive.layer.placer	Zur Identifizierung lieferte Boinx Zusammensetzungen und sortierte verschiedene Versionen
tv_FilterVersion	Zahl (doppelt)	1	Zum Abgleich verschiedener Versionen einer Komposition in einem Dokument/einer Anwendung. Hauptversionsnummern bedeuten Inkompatibilität und stimmen nicht mit anderen Hauptversionen überein. Minor-Versionsnummern müssen aufwärtskompatibel sein und sich bei jeder Iteration um 0,001 erhöhen. So muss z. B. sichergestellt werden, dass das Laden von Einstellungen aus einer 1.0-Ebene in eine 1.013-Ebene genau gleich aussehen muss, d. h. neue Tasten müssen, falls vorhanden, eine Voreinstellung haben, die sie nicht zeigt oder dem Aussehen der vorherigen Version entspricht.
tv_FilterOutputIsOpaque	BOOL		Bestimmt, ob eine Filterausgabe undurchsichtig ist. Voreinstellung ist NEIN

Aufzählungen

Der Quartz Composer Typ Index ermöglicht benannte Indizes. Sie können im Quartz Composer Editor bearbeitet werden, indem ein Eingabesplitter im Indexmodus hinzugefügt wird.

Quelle Typ

Die Quelle wird einer der folgenden Werte sein

- 0 - Bild
- 1 - Film, ein Film hat eine Restlaufzeit
- 2 - Kamera, kann auch eine Komposition sein

Richtung des Übergangs

Sie können Ihre eigenen Richtungen definieren. Für die versendeten Ebenen werden die folgenden Werte verwendet.

- Keine
- Links
- Richtig
- Aufwärts
- Nach unten

Übergangstyp

Sie können Ihre eigenen Übergangsarten definieren. Hier sind einige nützliche Beispielwerte.

- Auflösen
- Wischen

Tally Staaten

Es wurden mehrere Tally-Zustände für Videoquellen definiert, die in der Benutzeroberfläche und in der Tally Light-Begleitanwendung dargestellt werden.

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