logomask version 0.21

Diese Plugin dient dazu, senderspezifisch die Senderlogos oder auch Laufschrif-
ten (z.B bei n-tv)mit einer oder mehreren schwarzen Masken abzudecken, um das 
Fernsehbild ruhiger zu gestalten. Position und Gre der Masken werden dabei fr 
jeden Sender separat gespeichert und knnen auch fr jeden einzelnen Videomodus 
des Senders (4:3, 16:9 usw.) getrennt konfiguriert werden. Zur schnellen Anpassung 
der Masken ber die Fernbedienung enthlt das Archiv auch das Konfigurationstool
"logoset".

Installation
Die Speicherorte der Dateien ergeben sich aus der Archivstruktur. Das eigent-
liche Plugin "logomask" kommt mit den Rechten 755 nach /var/plugins/. Seine
Konfigurationsdatei "logomask.conf" legt das Plugin in /var/tuxbox/config ab.
Im Archiv ist die Konfigurationsdatei nur als Beispiel enthalten, da sie fr
jede Box spezifisch angelegt werden mu. Das Plugin kann entweder direkt durch
den Eintrag "/var/plugins/logomask &" in einer der Neutrino-Startdateien gestar-
tet werden (das "&" im Eintrag ist wichtig), ber den ebenfalls im Archiv be-
findlichen Shellstarter (logomask.cfg und logomask.so kommen nach /var/tuxbox/plugins/,
logomask.so mit den Rechten 755, lmask kommt mit den Rechten 755 nach /var/plugins/), 
oder, wenn des FlexMen im Image vorhanden ist, durch Einfgen der ebenfalls im Archiv 
enthaltenen Eintrge in die shellexec.conf. Whrend im Flexmen die jeweils sinn-
vollen Eintrge (Starten oder Beenden) automatisch angeboten werden, kann man
beim Start ber die blaue Taste das Plugin mit einem Aufruf starten und mit einem
erneuten Aufruf beenden.
Das Konfigurationsplugin "logoset" kommt mit den Rechten 755 nach /var/plugins/ und kann 
ebenfalls ber Shellstarter (logoset.cfg und logoset.so nach /var/tuxbox/plugins/, 
logoset.so mit Rechten 755) oder ber das FlexMen gestartet werden.

Bedienung
Bevor das Plugin genutzt werden kann, mu es mit dem Konfigurations-Plugin auf die
Senderlogos der gewnschten Sender eingestellt werden. Wurde ein Sender nicht kon-
figuriert, wird auch keine Maske dargestellt. Nach dem Umschalten auf einen anderen
Sender wartet das Plugin mit dem Lschen der alten und dem Anzeigen der neuen Masken
so lange, bis die InfoBar im unteren Bildbereich ausgeblendet wurde, damit diese
Information nicht gelscht oder berschrieben wird.
Will man auf einem Sender die Masken aktivieren, stellt man diesen Sender ein und
startet das Konfigurations-Plugin. In der Mitte des Bildes wird nun ein blauer 
Rahmen angezeigt. Diesen kann man mit den Richtungstasten der Fernbedienung nun so
auf dem Logo platzieren, da der Rahmen mit seiner linken oberen Ecke schon auf der
richtigen Position steht. Nun kann mit der gelben Taste auf Grenvernderung umge-
schaltet werden (die Rahmenfarbe wechselt zu gelb). Mit den Rechts-/Links-Tasten
kann die Maskengre jetzt horizontal vergrert/verkleinert und mit den Runter-/Hoch-
tasten vertikal vergrert/verkleinert werden. Will man die Position zwischendurch 
noch einmal ndern, kann mit der blauen Taste auch wieder in den Positionierungsmo-
dus geschaltet werden (Rahmenfarbe wechselt wieder zu blau).
Die Schrittweite der Verschiebung erhht sich bei lnger gedrckter Taste, um eine
schnelle Positionierung zu ermglichen. Wird lnger als zwei Sekunden keine oder eine
andere als die bisherige Taste gedrckt, wird die Schrittweite wieder auf den Start-
wert gesetzt, damit eine Feinpositionierung durchgefhrt werden kann. Bei lngerem
Tastendruck wird die Schrittweite jedoch wieder erhht.
Fr das Hinzufgen zustzlicher Masken wird die grne Taste bettigt. Die neue Maske
erscheint wieder in der Bildschirmmitte und kann, wie die vorhergende Maske konfigu-
riert werden. Fr jeden Sender knnen maximal 16 Masken angelegt werden. Dabei wird 
beim Konfigurieren immer die aktuelle Maske mit dem farbigen Rahmen angezeigt. Alle
anderen Masken werden normal schwarz dargestellt. Zwischen den einzelnen Masken kann
mittels der Lautstrke + und - Tasten weitergeschaltet werden.
Soll eine Maske nicht mehr dargestellt werden, so ist diese Maske mit den Volume-Tas-
ten auszuwhlen und die rote Taste zu bettigen. Die selektierte Maske wird nun gelscht
und die erste Maske in der Reihe (wenn vorhanden) wieder aktiv geschaltet.
Sitzen alle Masken richtig, kann die Einstellung mit der OK-Taste in die Konfigurations-
datei bernommen werden. Das Plugin "logomask", welches whren der Einstellung ge-
stoppt wurde, wird nun automatisch neu gestartet.
Diese Einstellungen sind fr die verschiedenen Videomodi der Box getrennt vorzunehmen.
Schaltet die Box auf einen Videomodus, welcher noch nicht konfiguriert wurde, wird die
Maske in der Bildmitte dargestellt und mu mit dem Konfigrations-Plugin einmalig ange-
passt werden.
Sollte ein Sender allerdings einen 16:9-Film im 4:3-Format senden und dabei sein Logo
weiter nach unten schieben, kann das die Box nicht erkennen. In diesem Fall kann man
die Maske aber auch schnell ber die Fernbedienung neu positionieren.
Die Einstellungen werden generell nur mit der "OK"-Taste bernommen. Drckt man die
"Home"-Taste, wird die Konfiguration ohne nderungen der Konfigurationsdatei abgebro-
chen.


Viel Spa mit dem Plugin
Das New-Tuxwetter-Team SnowHead und Worschter