AbsolutTV:Entwicklung:Screenfiles

Aus Sceneo Wiki

Inhaltsverzeichnis 1 Kapitel 1: 1.1 Screenfiles 1.1.1 Beispiel-Code 1.2 Labels 1.2.1 Struktur 1.2.2 Beispiel-Code 1.2.3 Standardeigenschaften 1.2.4 Elemente 1.2.5 Attribute 1.2.6 Sonderoptionen 1.3 Image-Button 1.3.1 Struktur 1.3.2 Beispiel-Code 1.3.3 Standardeigenschaften 1.3.4 Elemente 1.3.5 Control-Sprung-Ziele 1.4 Text-Button 1.5 Image-Menu 1.5.1 Struktur 1.5.2 Beispiel-Code 1.5.3 Standardeigenschaften 1.5.4 Elemente 1.5.5 Control-Sprung-Ziele 1.5.6 Attribute 1.6 Image 1.6.1 Struktur 1.6.2 Beispiel-Code 1.6.3 Standardeigenschaften 1.6.4 Elemente 1.6.5 Attribute 1.7 Panel 1.7.1 Struktur 1.7.2 Beispiel-Code 1.7.3 Standardeigenschaften 1.7.4 Elemente 1.7.5 Attribute 1.8 Progressbar 1.8.1 Struktur 1.8.2 Beispiel-Code 1.8.3 Standardeigenschaften 1.8.4 Elemente 1.8.5 Control-Sprung-Ziele 1.8.6 Attribute 1.9 Checkbox 1.9.1 Struktur 1.9.2 Beispiel-Code 1.9.3 Standardeigenschaften 1.9.4 Elemente 1.9.5 Control-Sprung-Ziele 1.9.6 Attribute

Kapitel 1:

Screenfiles

Jeder Screen der im Media-Center aufgebaut wird, basiert auf einer strukturierten XML Datei.

Beispiel-Code

<MediaCenterScreen visible="1.0.0">
    <globals>
        <position-left>0</position-left>
        <position-top>0</position-top>
        <position-width>800</position-width>
        <position-height>600</position-height>
        <background-image>bg_main.png</background-image>
        <first-focus>btnTV</first-focus>
        <global-video visible="TRUE">
            <position-left>15</position-left>
            <position-top>400</position-top>
            <position-width>200</position-width>
            <position-height>140</position-height>
        </global-video>
        <transparent-mode>FALSE</transparent-mode>
        <transparent-value>220</transparent-value>
         <language-profile>livetv-screens</language-profile>
    </globals>
    <elements>
              <!—- ELEMENTS -->
    </elements>
</MediaCenterScreen>

Element	Typ	Beschreibung
<position-left>		Linke Fensterposition. Die Angabe wird nur bei Popupscreens interpretiert.
<position-top>		Obere Fensterposition. Die Angabe wird nur bei Popupscreens interpretiert.
<position-width>		Skallierungsbasis auf deren Grundlage der gesamte Screen skalliert wird. Bei einem Popupscreen gilt die Angabe der wirklichen Fensterbreite.
<position-height>		Skallierungsbasis auf deren Grundlage der gesamte Screen skalliert wird. Bei einem Popupscreen gilt die Angabe der wirklichen Fensterhöhe.
<background-image>		Pfad + Dateiname zum Hintergrundbild. Wird kein Bild angegeben, wird der Hintergrund vom vorherigen Screen verwendet.
<first-focus>	Pflicht	Name des Elementes nach dem Laden des Screens automatisch fokussiert wird.
<global-video>	Optional	Definiert ein globales (Screenübergreifendes) Videopanel.
<transparent-mode>	-	Nicht vollständig implementiert Values [true, false]
<transparent-value>	-	Nicht vollständig implementiert Values [0..255]
<language-profile>	Pflicht	Name des Sprachprofis für den aktiven Screen

Labels

Labels dienen zur einfachen Informationsdarstellung in einem Screen. Dieses Objekt ist nicht fokussierbar, kann jedoch trotzdem mit einer Klickaktion belegt werden.

Struktur

<element type="label">...</element>

Beispiel-Code

<element type="label" command="" value="" hover="">
    <name>lInformation</name>
    In aller Freundschaft
    <position-left>220</position-left>
    <position-top>420</position-top>
    <position-width>380</position-width>
    <position-height>35</position-height>
    <align-h>center</align-h>
    <align-v>center</align-v>
    <font-size>16</font-size>
    <font-family>Trebuchet MS</font-family>
    <font-color>#eeeeee</font-color>
    <font-style>bold</font-style>
    <font-flags>wrap</font-flags>
</element>

Standardeigenschaften

<name>, <position-left>, <position-top>, <position-width>, <position-height>

Die Eigenschaften <position-width> und <position-height> können auch weggelassen werden. Dann wird das Label automatisch anhand des Textes und der verwendeten Schriftart in der Breite und der Höhe skaliert. Erfolgt die Angabe über Breite und Höhe, dann ist es auch möglich Labels mehrteilig darzustellen.

Elemente

Element	Typ	Beschreibung
<caption>	Pflicht	Text der im Button eingeblendet wird. Die Angabe ist nicht notwendig.
<font-size>	Optional	Schriftgröße
<font-family>	Optional	Name der zu verwendenden Schriftart
<font-color>	Optional	Farbe in der die Schrift dargestellt werden soll. Die Angabe erfolgt als Farbdefinition im HTML-Format (Hex). Beispiel: #C40F4C
<font-style>	Optional	Formatierungsattribute der Schrift. Mehrfachangaben durch Trennung mit Semikolon (bold;underline;) möglich. Values [bold, italic, underline, strikeout]
<font-flags>	Optional	Verhaltensattribute bei der Darstellung Values [nowrap, vertical]
<align-h>	Optional	Bestimmt die horizontale Textausrichtung Values: [left, center, right]
<align-v>	Optional	Bestimmt die vertikale Textausrichtung Values: [top, center, bottom]

Attribute

command	Message welche beim Anklicken mit der Maus ausgeführt wird. Details siehe Kapitel 3.
value	Parameter welcher beim Absenden der Message mit übermittelt wird. Details siehe Kapitel 3.

Sonderoptionen

Es besteht die Möglichkeit ein Label zur Anzeige von Zeitinformationen zu verwenden.

aktuelle Uhrzeit anzeigen: <name>clock</name>

aktuelles Datum anzeigen: <name>date</name>

Image-Button

Image-Buttons stellen die einfachste Möglichkeit zur Interaktion mit dem Benutzer zur Verfügung. Es besteht hier die Möglichkeit sowohl Bilder im unselektierten bzw. selektierten Status anzuzeigen. Darüber hinaus ist es möglich auch einen Text in einer gewünschten Formatierung auf diese Bilder zu legen. Sowohl die Text als auch die Bildangaben sind optional und nicht zwigend notwendig.

Struktur

<element type="image-button">…</element>

Beispiel-Code

<element type="image-button" command="" value="" hover="">
    <name>btnOK</name>
    <caption>OK</caption>
    <position-left>20</position-left>
    <position-top>410</position-top>
    <position-width>570</position-width>
    <position-height>80</position-height>
    <client-left>5</client-left>
    <client-top>5</client-top>
    <client-width>560</client-width>
    <client-height>70</client-height>
    <image-normal>btn_unfocused.png</image-normal>
    <image-normal-hover>btn_focused.png</image-normal-hover>
    <image-down>btn_down_unfocused.png </image-down>
    <image-down-hover>btn_down_focused.png </image-down-hover>
    <allow-down>TRUE</allow-down>
    <align-h>center</align-h>
    <align-v>center</align-v>
    <font-size>16</font-size>
    <font-family>Trebuchet MS</font-family>
    <font-color>#eeeeee</font-color>
    <font-style>bold</font-style>
    <font-flags>wrap</font-flags>
    <control-jump-left></control-jump-left>
    <control-jump-right></control-jump-right>
    <control-jump-up></control-jump-up>
    <control-jump-down></control-jump-down>
</element>

Standardeigenschaften

<name>, <position-left>, <position-top>, <position-width>, <position-height>

Elemente

Element	Typ	Beschreibung
<caption>	Pflicht	Text der im Button eingeblendet wird. Die Angabe ist nicht notwendig.
<client-top>	Optional	Schränkt Bereich für die Textausgabe ein
<client-left>	Optional	Schränkt Bereich für die Textausgabe ein
<client-width>	Optional	Schränkt Bereich für die Textausgabe ein
<client-height>	Optional	Schränkt Bereich für die Textausgabe ein
<image-normal>	Optional	Pfad + Dateiname zum Bild der im unselektierten Zustand angezeigt wird
<image-normal-hover>	Optional	Pfad + Dateiname zum Bild der im selektierten Zustand angezeigt wird
<image-down>	Optional	Pfad + Dateiname zum Bild der im unselektierten Zustand angezeigt wird (Down-State) Setzt Attribut <allow-down>TRUE</allow-down> voraus
<image-down-hover>	Optional	Pfad + Dateiname zum Bild der im selektierten Zustand angezeigt wird (Down-State) Setzt Attribut <allow-down>TRUE</allow-down> voraus
<allow-down>	Pflicht	Button kann durch Anklicken automatisch in den Down-State versetzt werden. Values: [TRUE, FALSE]
<font-size>	Optional	Schriftgröße
<font-family>	Optional	Name der zu verwendenden Schriftart
<font-color>	Optional	Farbe in der die Schrift dargestellt werden soll. Die Angabe erfolgt als Farbdefinition im HTML-Format (Hex). Beispiel: #C40F4C
<font-style>	Optional	Formatierungsattribute der Schrift. Mehrfachangaben durch Trennung mit Semikolon (bold;underline;) möglich. Values [bold, italic, underline, strikeout]
<font-flags>	Optional	Verhaltensattribute bei der Darstellung Values [wrap, vertical]
<align-h>	Optional	Bestimmt die horizontale Textausrichtung Values: [left, center, right]
<align-v>	Optional	Bestimmt die vertikale Textausrichtung Values: [top, center, bottom]

Control-Sprung-Ziele

<control-jump-left>, <control-jump-right>, <control-jump-up>, <control-jump

Text-Button

Noch nicht vollständig implementiert.

Image-Menu

Image-Menus stellen mehrere Image-Buttons in einem Control zur Verfügung. Somit ist es möglich mehr als die eigentlich sichtbaren Elemente in das Control aufzunehmen.

Struktur

<element type="image-menu">…</element>

Beispiel-Code

<element type="image-menu" command="" value="" hover="">
    <name>menuChannels</name>
    <position-left>20</position-left>
    <position-top>410</position-top>
    <position-width>465</position-width>
    <position-height>300</position-height>
    <element-width>440</element-width>
    <element-height>40</element-height>
    <element-distance>10</element-distance>
    <element-visible>6</element-visible>
    <image-normal>btn_unfocused.png</image-normal>
    <image-normal-hover>btn_focused.png</image-normal-hover>
    <image-down>btn_down_unfocused.png </image-down>
    <image-down-hover>btn_down_focused.png </image-down-hover>
    <allow-down>FALSE</allow-down>
    <align-h>center</align-h>
    <align-v>center</align-v>
    <font-size>16</font-size>
    <font-family>Trebuchet MS</font-family>
    <font-color>#eeeeee</font-color>
    <font-style>bold</font- style>
    <font-flags>wrap</font-flags>
    <control-jump-left></control-jump-left>
    <control-jump-right></control-jump-right>
    <control-jump-up></control-jump-up>
    <control-jump-down></control-jump-down>
    <items>
        <item caption="ARD“ command="" value="" hover="" />
        <item caption="ZDF“ command="" value="" hover="" />
        <item caption="RTL“ command="" value="" hover="" />
    </items>
</element>

Standardeigenschaften

<name>, <position-left>, <position-top>, <position-width>, <position-height>

Elemente

Element	Typ	Beschreibung
<element-width>	Pflicht	Breite eines Menuelements
<element-height>	Pflicht	Höhe eines Menuelements
<element-distance>	Pflicht	Vertikaler Abstand zwischen zwei Elementen
<element-visible>	Pflicht	Anzahl der maximal sichtbaren Elemente
<image-normal>	Optional	Pfad + Dateiname zum Bild der im unselektierten Zustand angezeigt wird
<image-normal-hover>	Optional	Pfad + Dateiname zum Bild der im selektierten Zustand angezeigt wird
<image-down>	Optional	Pfad + Dateiname zum Bild der im unselektierten Zustand angezeigt wird (Down-State) Setzt Attribut <allow-down>TRUE</allow-down> voraus
<image-down-hover>	Optional	Pfad + Dateiname zum Bild der im selektierten Zustand angezeigt wird (Down-State) Setzt Attribut <allow-down>TRUE</allow-down> voraus
<allow-down>	Pflicht	Button kann durch Anklicken automatisch in den Down-State versetzt werden. Values: [TRUE, FALSE]
<font-size>	Optional	Schriftgröße
<font-family>	Optional	Name der zu verwendenden Schriftart
<font-color>	Optional	Farbe in der die Schrift dargestellt werden soll. Die Angabe erfolgt als Farbdefinition im HTML-Format (Hex). Beispiel: #C40F4C
<font-style>	Optional	Formatierungsattribute der Schrift. Mehrfachangaben durch Trennung mit Semikolon (bold;underline;) möglich. Values [bold, italic, underline, strikeout]
<font-flags>	Optional	Verhaltensattribute bei der Darstellung Values [wrap, vertical]
<align-h>	Optional	Bestimmt die horizontale Textausrichtung Values: [left, center, right]
<align-v>	Optional	Bestimmt die vertikale Textausrichtung Values: [top, center, bottom]
<items>	Optional	Enthält die bereits in das Menu eingefügten Elemente

Control-Sprung-Ziele

<control-jump-left>, <control-jump-right>, <control-jump-up>, <control-jump-down>

Attribute

command	Message welche beim Anklicken oder beim Auswählen mit der Tastatur ausgeführt wird. Details siehe Kapitel 3.
value	Parameter welcher beim Absenden der Message mit übermittelt wird. Details siehe Kapitel 3.
hover	Scriptkommandos die bei Selektion des Objektes ausgeführt werden. Details siehe Kapitel 2.

Image

Struktur

<element type="image">…</element>

Beispiel-Code

<element type="image" command="" value="">
    <name>imgBack</name>
    <position-left>30</position-left>
    <position-top>10</position-top>
    <position-width>40</position-width>
    <position-height>40</position-height>
    <image>icons\epg_previous.png</image>
    <visible>FALSE</visible>
</element>

Standardeigenschaften

<name>, <position-left>, <position-top>, <position-width>, <position-height>

Elemente

Element	Typ	Beschreibung
<image>	Pflicht	Pfad + Dateiname zum Bild der im unselektierten Zustand angezeigt wird
<visible>	Optional	Legt die Sichtbarkeit des Bildes fest

Attribute

command	Message welche beim Anklicken ausgeführt wird. Details siehe Kapitel 3.
value	Parameter welcher beim Absenden der Message mit übermittelt wird. Details siehe Kapitel 3.

Panel

Struktur

<element type="panel">…</element>

Beispiel-Code

<element type="panel" command="" value="">
    <name>panelTV</name>
    <caption></caption>
    <position-left>0</position-left>
    <position-top>0</position-top>
    <position-width>800</position-width>
    <position-height>600</position-height>
    <background-color>#000000</background-color>
    <visible>TRUE</visible>
</element>

Standardeigenschaften

<name>, <position-left>, <position-top>, <position-width>, <position-height>

Elemente

Element	Typ	Beschreibung
<background-color>	Optional	Farbe in der der Hintergrund dargestellt werden soll. Die Angabe erfolgt als Farbdefinition im HTML-Format (Hex). Beispiel: #C40F4C
<visible>	Optional	Sichtbarkeit des Panels Values: [true, false]

Attribute

command	Message welche beim Anklicken ausgeführt wird. Details siehe Kapitel 3.
value	Parameter welcher beim Absenden der Message mit übermittelt wird. Details siehe Kapitel 3.

Progressbar

Struktur

<element type="progressbar">…</element>

Beispiel-Code

<element type="progressbar" command="" value="">
    <name>progressSearch</name>
    <position-left>50</position-left>
    <position-top>500</position-top>
    <position-width>700</position-width>
    <position-height>10</position-height>
    <color>#cecece</color>
    <color-selected>#44FD1D</color-selected>
    <background-color>#dddddd</background-color>
    <value-min>0</value-min>
    <value-max>100</value-max>
    <value-position>0</value-position>
    <read-only>TRUE</read-only>
    <control-jump-left></control-jump-left>
    <control-jump-right></control-jump-right>
    <control-jump-up></control-jump-up>
    <control-jump-down></control-jump-down>
</element>

Standardeigenschaften

<name>, <position-left>, <position-top>, <position-width>, <position-height>

Elemente

Element	Typ	Beschreibung
<color>	Pflicht	Farbe des Fortschrittsbalkens im unselektierten Zustand. Die Angabe erfolgt als Farbdefinition im HTML-Format (Hex). Beispiel: #C40F4C
<color-selected>	Pflicht	Farbe des Fortschrittsbalkens im selektierten Zustand. Die Angabe erfolgt als Farbdefinition im HTML-Format (Hex). Beispiel: #C40F4C
<background-color>	-	Momentan ohne Funktion
<value-min>	Pflicht	Minimale Position des Fortschrittsbalkens
<value-max>	Pflicht	Maximale Position des Fortschrittsbalkens
<value-position>	Pflicht	Aktuelle Position des Fortschrittsbalkens
<read-only>	Optional	Bestimmt die horizontale Textausrichtung Values: [true, false]

Control-Sprung-Ziele

<control-jump-left>, <control-jump-right>, <control-jump-up>, <control-jump-down>

Attribute

command	Message welche beim Anklicken oder beim Auswählen mit der Tastatur ausgeführt wird. Details siehe Kapitel 3.
value	Parameter welcher beim Absenden der Message mit übermittelt wird. Details siehe Kapitel 3.
hover	Scriptkommandos die bei Selektion des Objektes ausgeführt werden. Details siehe Kapitel 2.

Checkbox

Struktur

<element type="check-box">...</element>

Beispiel-Code

<element type="check-box" translate="true">
    <name>chkScrambled</name>
    Catch PayTV channels
    <position-left>40</position-left>
    <position-top>480</position-top> 
    <position-width>500</position-width>
    <position-height>38</position-height>
    <image-normal>round_a_unselected.png</image-normal>
    <image-normal-hover>round_a_selected.png</image-normal-hover>
    <image-down>round_b_unselected.png</image-down>
    <image-down-hover>round_b_selected.png</image-down-hover>
    <image-width>30</image-width>
    <image-height>30</image-height>
    <align-h>left</align-h>
    <align-v>center</align-v>
    <image-align-v>right</image-align-v>
    <font-size>16</font-size>
    <font-family>Arial</font-family>
    <font-color>#000000</font-color>
    <font-style></font-style>
    <control-jump-left></control-jump-left>
    <control-jump-right></control-jump-right>
    <control-jump-up></control-jump-up>
    <control-jump-down></control-jump-down>
</element>

Standardeigenschaften

<name>, <position-left>, <position-top>, <position-width>, <position-height>

Elemente

Element	Typ	Beschreibung
<caption>	Pflicht	Text der im Button eingeblendet wird. Die Angabe ist nicht notwendig.
<image-normal>	Optional	Pfad + Dateiname zum Bild der im unselektierten Zustand angezeigt wird
<image-normal-hover>	Optional	Pfad + Dateiname zum Bild der im selektierten Zustand angezeigt wird
<image-down>	Optional	Pfad + Dateiname zum Bild der im unselektierten Zustand angezeigt wird (Down-State)
<image-down-hover>	Optional	Pfad + Dateiname zum Bild der im selektierten Zustand angezeigt wird (Down-State)
<image-width>	Pflicht	Breite des Bildelements
<image-height>	Pflicht	Höhe des Bildelements
<font-size>	Optional	Schriftgröße
<font-family>	Optional	Name der zu verwendenden Schriftart
<font-color>	Optional	Farbe in der die Schrift dargestellt werden soll. Die Angabe erfolgt als Farbdefinition im HTML-Format (Hex). Beispiel: #C40F4C
<font-style>	Optional	Formatierungsattribute der Schrift. Mehrfachangaben durch Trennung mit Semikolon (bold;underline;) möglich. Values [bold, italic, underline, strikeout]
<font-flags>	Optional	Verhaltensattribute bei der Darstellung Values [wrap, vertical]
<align-h>	Optional	Bestimmt die horizontale Textausrichtung Values: [left, center, right]
<align-v>	Optional	Bestimmt die vertikale Textausrichtung Values: [top, center, bottom]
<image-align-h>	Optional	Bestimmt die horizontale Bildausrichtung Values: [left, right]

Control-Sprung-Ziele

<control-jump-left>, <control-jump-right>, <control-jump-up>, <control-jump-down>

Attribute

command	Message welche beim Anklicken oder beim Auswählen mit der Tastatur ausgeführt wird. Details siehe Kapitel 3.
value	Parameter welcher beim Absenden der Message mit übermittelt wird. Details siehe Kapitel 3.
hover	Scriptkommandos die bei Selektion des Objektes ausgeführt werden. Details siehe Kapitel 2.