LiveText-Tags einrichten

Diese Anleitung beschreibt die manuelle Definition von LiveText-Tags in der XML-Projektdatei. Der Block <TAGS> steht auf der obersten Ebene innerhalb des Projekts, auf derselben Ebene wie Helligkeitszonen oder Segmente. Jeder Tag erhält einen eigenen <TAG>-Block.

Beispiel

<TAGS>
  <TAG>
    <TAG-FILE>BNN_LIVE_Premium_15min.avi</TAG-FILE>
    <TAG-NAME>#TAG1</TAG-NAME>
    <TAG-VALUE>2:0</TAG-VALUE>
    <TAG-DEFAULT>WILLKOMMEN</TAG-DEFAULT>
    <TAG-FONT>Tahoma</TAG-FONT>
    <TAG-SIZE>50</TAG-SIZE>
    <TAG-COLOR-RED>255</TAG-COLOR-RED>
    <TAG-COLOR-GREEN>255</TAG-COLOR-GREEN>
    <TAG-COLOR-BLUE>255</TAG-COLOR-BLUE>
    <TAG-BOLD>1</TAG-BOLD>
    <TAG-ITALIC>0</TAG-ITALIC>
    <TAG-CAPITALIZE>0</TAG-CAPITALIZE>
    <TAG-COUNT>4</TAG-COUNT>
    <TAG-Y>10</TAG-Y>
    <TAG-X>1024</TAG-X>
    <TAG-X2>2048</TAG-X2>
    <TAG-X3>4096</TAG-X3>
    <TAG-X4>8192</TAG-X4>
    <TAG-LINE-WIDTH>2550</TAG-LINE-WIDTH>
    <TAG-TIME-IN>2</TAG-TIME-IN>
    <TAG-TIME-OUT>20</TAG-TIME-OUT>
    <TAG-ALIGN>center</TAG-ALIGN>
  </TAG>
</TAGS>

Weitere <TAG>-Blöcke können vor dem schließenden </TAGS> ergänzt werden.

Zuordnung und Inhalt

Eigenschaft	Typ / Beispiel	Bedeutung
<TAG-FILE>	String, werbung.avi	Name der Datei, für die der Layer erstellt wird.
<TAG-NAME>	String, #TAG1	Eindeutiger Name, über den der Tag von außen angesprochen wird. Ein Name darf nur für diesen Tag verwendet werden.
<TAG-VALUE>	String, 2:0	Aktuell gespeicherter Wert. Optional, sofern kein Startwert vorgegeben werden soll.
<TAG-DEFAULT>	String, WILLKOMMEN	Ersatzwert, wenn ein leerer Text empfangen wurde beziehungsweise <TAG-VALUE> leer ist.
<TAG-MIDI>	Kommagetrennte Strings	Beschränkt die Anzeige zusätzlich zur Dateizuordnung auf Sequenzen mit den angegebenen MIDI-Keys. Mehrere Keys werden durch Kommas getrennt.

Schrift und Farbe

Eigenschaft	Typ / Werte	Bedeutung
<TAG-FONT>	String, Tahoma	Unter Windows registrierter Schriftname. Maßgeblich ist der Name in den installierten Windows-Schriftarten, nicht der Dateiname der Schriftdatei.
<TAG-SIZE>	Integer, z. B. 50	Schriftgröße. Die ursprüngliche Anleitung empfiehlt für gute Lesbarkeit Werte über 50.
<TAG-COLOR-RED>	Integer, 0 bis 255	Rotanteil der Textfarbe.
<TAG-COLOR-GREEN>	Integer, 0 bis 255	Grünanteil der Textfarbe.
<TAG-COLOR-BLUE>	Integer, 0 bis 255	Blauanteil der Textfarbe.
<TAG-BOLD>	Bool, 0 oder 1	Normale oder fette Darstellung.
<TAG-ITALIC>	Bool, 0 oder 1	Kursive Darstellung.
<TAG-CAPITALIZE>	Bool, 0 oder 1	Wandelt den gesamten Text in Großbuchstaben um.

Position und Textbreite

Eigenschaft	Typ / Werte	Bedeutung
<TAG-COUNT>	Integer, 0 bis 4	Anzahl der zu berücksichtigenden horizontalen Positionen.
<TAG-X>, <TAG-X2>, <TAG-X3>, <TAG-X4>	Integer	Horizontale Positionen in Pixeln innerhalb der Grafik. 0 liegt am linken Rand.
<TAG-Y>	Integer	Vertikale Position in Pixeln innerhalb der Grafik. 0 liegt am oberen Rand. Schriften können oberhalb ihrer Buchstaben Freiraum besitzen; der sichtbare Text beginnt deshalb nicht zwingend exakt an dieser Pixelposition.
<TAG-LINE-WIDTH>	Integer	Maximale Textbreite. Für die automatische Zeilenanpassung wird im aktuellen Programmstand zusätzlich TAG-LINE-AUTO benötigt.
<TAG-ALIGN>	String: left, right, center	Richtet den Text linksbündig, rechtsbündig oder zentriert an den angegebenen X-Positionen aus.

Ein- und Ausblendzeit

Eigenschaft	Typ / Beispiel	Bedeutung
<TAG-TIME-IN>	Decimal, 15.4	Zeitpunkt in Sekunden innerhalb der Wiedergabe, ab dem der Text erscheint. Dezimalwerte verwenden einen Punkt.
<TAG-TIME-OUT>	Decimal, 15.4	Zeitpunkt in Sekunden innerhalb der Wiedergabe, an dem der Text ausgeblendet wird.

Für die Positionierung kannst du zunächst <TAG-TIME-IN> auf 0 und <TAG-TIME-OUT> auf einen hohen Wert wie 999 setzen. Stimme die Ein- und Ausblendzeiten anschließend ab.

Der Renderer bereinigt vor der Darstellung unter anderem Zeilenumbrüche und doppelte Leerzeichen.

Andere Tag-Typen

Eigenschaft	Typ / Werte	Bedeutung
<TAG-TYPE>	String: text, progress, image	Standard ist text. Bei image werden <TAG-VALUE> und <TAG-DEFAULT> als Bildreferenzen interpretiert. Die ursprüngliche Referenz nennt außerdem progress, erläutert diesen Typ jedoch nicht näher.
<TAG-WIDTH>, <TAG-HEIGHT>	Integer	Ausgabebreite und -höhe des referenzierten Bildes bei <TAG-TYPE>image</TAG-TYPE>.

Automatische Zeilenanpassung

Im aktuellen Programmstand steuert <TAG-LINE-AUTO> die automatische Anpassung. Der Standardwert ist FALSE. Eine positive <TAG-LINE-WIDTH> allein aktiviert diese Funktion nicht. Setze <TAG-LINE-AUTO>TRUE</TAG-LINE-AUTO>, wenn du die automatische Anpassung verwenden möchtest. Prüfe die Darstellung in der eingesetzten LEDVIZ-Version.

Diese Referenz basiert auf der bisherigen LEDVIZ-Dokumentation. Abbildungen zeigen teilweise eine ältere Programmoberfläche. Ursprüngliche Dokumentation