####################################################################################
####                       Clock Version 0.13  
####                 Uhrzeit im Fernsehbild anzeigen
####              Das New-Tuxwetter-Team: SnowHead und Worschter
####################################################################################

Dieses Plugin blendet die Uhrzeit in das laufende Fernsehbild ein. Das ist zunchst erst
einmal eine Testversion. Durch Verzicht auf farbige Darstellung beeinflusst das Plugin
bereits angezeigte Mens nicht in deren Farbdarstellung.

Funktion und Installation:
--------------------------
Das eigentlich aktive Plugin ist die Datei "clock". Sie kommt mit den Rechten 755 nach
/var/bin/. Um die Uhrzeit anzuzeigen, wird clock ber die Kommandozeile (optional mit 
Parametern) gestartet. Zum Beenden von clock mu in /tmp/ die Datei .clock_kill erzeugt 
werden. Vor dem Beenden lscht clock noch den verwendeten Anzeigebereich. Das Starten 
und Beenden von clock kann entweder ber das Men der blauen Taste oder ber das Flex-
Men erfolgen. Fr beide Varianten sind die entsprechenden Unterverzeichnisse mit allen 
bentigten Dateien im Archiv vorhanden.
Wer die Art der Anzeige noch konfigurieren mchte, kann zustzlich die Datei clock.conf
nach /var/tuxbox/config/ kopieren. Deren Eintrge haben folgende Bedeutung:

  X= legt die horizontale Position der linken unteren Ecke des Anzeigefeldes fest. Die
     Werte knnen im Bereich von 0 bis 540 liegen. (0 ist ganz links)
     
  Y= legt die vertikale Position der Oberkante des Anzeigefeldes fest. Die Werte knnen
     im Bereich von 0 bis 500 liegen. (0 ist ganz oben)
     
  DATE= Steht hier eine 1, wird unterhalb der Uhrzeit noch das Datum mit angezeigt. Bei
        0 wird nur die Uhrzeit angezeigt
        
  BIG= Wer die Anzeige gern grer haben mchte, trgt hier eine 1 ein. Aber bitte dann
       auch die Anzeigepositionen anpassen, damit die Anzeige noch auf den Bildschirm passt.
       
  SEC= Legt fest, ob die Sekunden in der Uhrzeit angezeigt werden sollen. Bei 1 werden die
       Sekunden angezeigt, bei 0 nicht. Werden die Sekunden nicht angezeigt, blinkt statt
       dessen der Doppelpunkt zwischen Stunden und Minuten
       
  FCOL= Legt die Ziffernfarbe fest, 0=Transparent, 1=Schwarz, 2=Weiss
       
  BCOL= Legt die Hintergrundfarbe fest, 0=Transparent, 1=Schwarz, 2=Weiss
  
  MAIL= legt fest, ob die von Tuxmail erzeugte Benachrichtigung ber neue Mails ausgewertet
        und angezeigt werden soll, in diesem Fall blinkt in der Anzeige das Mailsymbol im
        Wechsel mit der Anzahl der neuen Mails

Fr den Start ber Kommandozeile knnen diese Parameter in der gleichen Syntax auch als
Kommandozeilenparameter bergeben werden. Eventuell vorher aus der clock.conf ausgelesene
Werte werden dabei von den Kommandozeilenparametern berstimmt. Zum Beispiel:

  /var/bin/clock X=540 Y=0 DATE=1 BIG=1 SEC=0
  
Es mssen nicht alle Parameter ber Kommandozeile eingegeben werden. Nicht in der Kommando-
zeile bergebene oder fehlerhafte Kommandozeilen-Parameter werden zunchst aus der clock.conf 
bernommen oder, wenn diese nicht existiert, mit Defaultwerten vorbelegt. Diese Defaultwerte
sind: X=540, Y=0, DATE=0, BIG=0, SEC=1, FCOL=2, BCOL=1

Steuerung ber FlexMen:
------------------------
Die Datei clock mit den Rechten 755 nach /var/bin/ kopieren und den Text aus der Datei
"einfuegen in shellexec.conf" in die Datei /var/tuxbox/pluhins/shellexec.conf einfgen.
Dabei eine Unix-konformen Editor verwenden. Fertig.

Steuerung ber blaue Taste
--------------------------
Die Datei clock mit den Rechten 755 nach /var/bin/ kopieren, clock.cfg und clock.so nach
/var/tuxbox/plugins/. clock.so mit den Rechten 755. Das Script sclock kommt mit den Rech-
ten 755 nach /var/plugins/. Anschlieend Box neu starten.
Der erste Aufruf des Meneintrages "Uhrzeit" startet bei Bedarf clock und zeigt die Uhr
an. Jeder weitere Aufruf schaltet zwischen Anzeigen und Verbergen der Uhrzeit hin und her.

Konfiguration ber FlexMen
---------------------------
Wer die Einstellungen fr die Uhrzeit-Anzeige ber das FlexMen machen mchte, findet die
dafr bentigten Dateien in diesem Unterverzeichnis. Die notwendigen Ergnzungen fr die
shellexec.conf mssen bernommen und das Script "cops" mit den Rechten 755 nach /var/plugins/
kopiert werden. Wer den Editor "input" noch nicht in seinem Image hat, findet auch diesen im
Archiv. Er kommt mit den Rechten 755 nach /var/bin.

Screensaver
-----------
Auf der Basis des Clock-Plugins liegt noch ein kleines Spielzeug mit bei, der Screensaver
"ssaver". Wird er gestartet (was brigens mit den gleichen Kommandozeilenoptionen wie bei
"clock" geschehen kann), bewegt sich die Uhrzeitanzeige regellos auf dem Bildschirm. Dabei
wird der gesamte Bildschirm in der Hintergrundfarbe gefllt und nicht nur der Bereich unter
den Zahlen. Start- und Konfigurationsmglichkeiten sind gleich denen des Clock-Plugins. Alle
bentigten Dateien liegen dem Archiv bei. Die Eingabe von X- oder Y-Position macht beim Screen-
saver keinen Sinn und wird daher sowohl auf der Kommandozeile als auch in der ssaver.conf ig-
noriert. Der zustzliche Parameter "SLOW=" steuert die Geschwindigkeit. Zulssig sind Werte
von 0..10. Je hher die Zahl, desto langsamer bewegt sich die Anzeige ber den Schirm.
Beendet wird der Screensaver entweder durch Anlegen der Datei "/tmp/.ssaver_kill" oder durch
Drcken einer beliebigen Taste auf der Fernbedienung.

Also, viel Spa und viel Erfolg

Das New-Tuxwetter-Team
SnowHead und Worschter