####################################################################################
####                 New-Tuxwetter Version 3.40
####            Aktuelle Wetterinfos und Wettervorhersage
####                                        
####################################################################################

ACHTUNG: Bei allen Versionen die lter als die Version 3.40 sind, funktionieren auf-
grund einer Formatumstellung des Wetterservers die Vorschauen nicht mehr!!

Vorraussetzung:
---------------

Die Vorraussetzung fr die korrekte Funktion des New-Tuxwetter-Plugins, ist eine
funktionierende Internetverbindung. Diese kann entweder ber einen Router oder ber 
einen PC mit ICS (Internet Connection Sharing = Internetverbindungsfreigabe) erfolgen. 
Laufen schon andere Plugins mit Internetanbindung (z.B. Tuxmail, Newsticker etc.),
sollte das Wetterplugin normalerweise ebenfalls funktionieren.
Nutzer eine Proxservers knnen diesen dem Plugin mit folgenden Eintrgen in der Datei
tuxwetter.conf bekanntmachen

 ProxyAdressPort=ProxyAdresse:ProxyPort
 ProxyUserPwd=Username:Passwort

 Beispiel:
 ProxyAdressPort=192.168.0.128:8080
 ProxyUserPwd=username1:passwort1


Installation fr jffs-only-Images:
----------------------------------

Die Verzeichnis-Struktur gibt den Ort der Dateien im Image eigentlich schon vor,
also tuxwetter.cfg und tuxwetter.so (Rechte auf 755) nach /lib/tuxbox/plugins/.
Den Ordner "tuxwet" (einschlielich des Ordners selbst) nach /var/plugins/ kopieren.
tuxwetter braucht die Rechte 755.
Bei Images mit cramfs ist der Ordner /lib/tuxbox/plugins/ nicht per FTP beschreibbar.
In diesem Fall mu die root-Partition (cramfs) ber die Expertenfunktion der Box aus-
gelesen, auf dem PC mit den NewTuxBoxFlashTools die beiden Dateien eingefgt werden
(Rechte 755 fr tuxwetter.so nicht vergessen) und dann wieder mittels der Experten-
funktion geflasht werden.

Alternativ kann bei einigen cramfs- und squashfs-Images auch versucht werden, die .so 
und .cfg Datei in den Ordner /var/tuxbox/plugins zu kopieren. Manche Images suchen auch 
dort nach Plugins.

Installation fr Jack-the-Grabber-Teamimages oder Yadi-Images:
--------------------------------------------------------------

Im Verzeichnis /var/ den Ordner /plugins/ erstellen. Dann nach /var/plugins/ wechseln,
und dorthin den Ordner "tuxwet" mit allen enthaltenen Dateien (einschlielich des
Ordners selbst) kopieren.
Die Datei tuxwetter braucht die Rechte 755.
Danach in den Ordner /var/tuxbox/plugins wechseln, dorthin mssen die Dateien
tuxwetter.cfg und tuxwetter.so (tuxwetter.so braucht die Rechte 755)

Die einzigen Einstellungen mssen in der "tuxwetter.conf" vorgenommen werden.

Mit dem Parameter 

 SplashScreen=1

legt man fest, da der Startbildschirm angezeigt werden soll. Mit dem Parameter 0 ent-
fllt der Startbildschirm. Geschlossen wird der Startbildschirm mit der OK-Taste.
Defaulteinstellung ist 1


Mit dem Parameter

 ShowIcons=1

kann ausgewhlt werden, ob in den Textanzeigen der Wetterdaten zustzlich die aktuellen
Wettersymbole eingeblendet werden sollen. Da diese Symbole wegen ihrer Gre vom Server
heruntergeladen werden, empfiehlt es sich, bei langsamen Internetverbindungen diese Funk-
tion mit dem Wert 0 zu deaktivieren
Defaulteinstellung ist 0

Ob die Einheiten metrisch oder nichtmetrisch angezeigt werden, legt der Parameter
  
 Metric=1
  
fest. Mit der Defaulteinstellung "1" werden Einheiten, Zeiten und Datum metrisch 
dargestellt.


Der Parameter

 InetConnection=ISDN

teilt dem Plugin mit, da der Internetzugang per ISDN erfolgt. Statt ISDN kann auch ANALOG
eingetragen werden. Fr DSL ist kein Eintrag notwendig (default). Anhand dieses Parameters
werden beim Download von Dateien die Timeouts fr Verbindungsaufnahme und Gesamtdownload-
Zeit sowie die Dateigre berechnet, ab welcher der Fortschrittsbalken im LCD angezeigt wird.

Wer viele Web-Cams auf Home-PC's einbindet, kann mit dem Parameter

  ConnectTimeout=nn
  
die Timeoutzeit fr eine Verbindungsaufnahme zustzlich noch einmal spezifizieren, um bei
abgeschalteten PC's nicht zu lange auf eine Fehlermeldung warten zu mssen. nn gibt die
Anzahl in Sekunden an, welche maximal bis zum Etablieren der Verbindung gewartet werden
soll. Da New-Tuxwetter bei nicht erfolgter Verbindung einen zweiten Verbindungsversuch un-
ternimmt, ist die Wartezeit bis zur Fehlermeldung also nn*2 Sekunden.


Wer einen eigenen Account bei weather.com hat, kann seine eigenen Zugangsdaten verwenden,
falls der public-Zugang wegen zu hufigem Aufruf mal deaktiviert werden sollte:

ParterID=dddddddddd
LicenseKey=hhhhhhhhhhhhhhhh

Registrieren kann man sich hier: http://registration.weather.com/ursa/profile/new?
Danach folgende Seite aufrufen: http://www.weather.com/services/xmloap.html , um den 
"Weather XML Data Feed" zu abonieren. Hat man diesen aboniert, erhlt man eine Mail, 
in der die persnlichen Zugangsdaten enthalten sind.

Die bis hier beschriebenen Parameter knnen auch separat in einer Datei "tuxwetter.mcfg" ge-
halten werden, um eine schnelle Konfiguration durch das Flexible Men-Plugin "Shellexec" zu
ermglichen. Existiert eine Datei "/var/plugins/tuxwet/tuxwetter.mcfg", haben die Eintrge
in dieser Datei Vorrang vor den Eintrgen in der tuxwetter.conf.


Nun sind die Stdte einzutragen, fr welche man die Wetterabfrage auswhlen knnen mchte. 
Die Stadtnamen und deren Codes sind in der beiliegenden Datei "Ortscodes.txt" gelistet.

Der Eintrag fr die Stdte erfolgt in der Form: 
    Stadt=Stadtname_fr_TV_Anzeige,Stadtcode
z.B.:
    Stadt=Mnchengladbach,GMXX0086

Wer seine gewnschte Stadt nicht in der Datei findet, kann man im Browser eingeben: 
http://xoap.weather.com/search/search?where=StadtName

Bsp:
http://xoap.weather.com/search/search?where=dresden

Antwort:
 <?xml version="1.0" encoding="ISO-8859-1" ?> 
- <!-- This document is intended only for use by authorized licensees of The Weather Channel...
  --> 
- <search ver="2.0">
  <loc id="GMXX0025" type="1">Dresden, Germany</loc> 
  <loc id="USKS0157" type="1">Dresden, KS</loc> 
  <loc id="USME0110" type="1">Dresden, ME</loc> 
  <loc id="USNY0396" type="1">Dresden, NY</loc> 
  <loc id="USOH0268" type="1">Dresden, OH</loc> 
  <loc id="USTN0146" type="1">Dresden, TN</loc> 
  </search>

Der Stadtcode fr Dresden wre demnach GMXX0025. Wird keine Stadt zurckgegeben, sind fr die
angefragte Stadt keine Wetterdaten verfgbar. Dann mu man auf eine Stadt in der Umgebung aus-
weichen.

Eine weitere Mglichkeit Stdtecodes zu finden ist, auf der Seite

http://de.weather.com/search/search?where=deutschland&what=WeatherCity

eine der aufgefhrten Stdte zu whlen (nicht ber die Suche!!!)
Die Adressleiste des aufgerufenen Fensters enthlt den Stadtcode der bentigt wird.
Es werden nur Stdte mit dem Code GMXX0001 bis GMXX0280 untersttzt.
Ist die gewnschte Stadt nicht in dem Bereich, so steht auf der Seite direkt unter
dem Ort die Stadt Wetterstation von der die Daten kommen (z.B. wie Stuttgart).
Dann sucht euch dafr den Stadtcode, denn die Daten sind identisch.

Der Aufbau der Mens erfolgt ber die Eintrge "MENU=" als Anfangskennung und "ENDMENU" als
Endekennung. Diese knnen beliebig tief verschachtelt und auch mit normalen Eintrgen gemischt
werden. Im einfachsten Fall knnte "MENU=New Tuxwetter" am Anfang und "ENDMENU" am Ende der
Liste stehen. Mindestens eine Menebene ist zwingend notwendig. Innerhalb einer aktuellen Me-
nseite aufrufbaren Untermens sind in der Anzeige durch ein vorangestelltes ">" gekennzeichnet.
Zur optischen Trennung der Eintrge kann vor den "Anzeigetext im Men" ein "*" gesetzt werden.
Unterhalb eines solchen Eintrages wird ein Trennstrich im Men gezogen.
Um die Darstellung der Namen der Meneintrge ansprechender gestalten zu knnen, werden Farb-
steuerzeichen im bergebenen Text untersttzt. Allen Steuerzeichen gemeinsam ist der Beginn 
mit dem Zeichen "~". Dieses kommt im normalen Text nicht vor und leitet daher immer einen Farb-
befehl ein. Folgende Farben werden untersttzt:

  ~R    nachfolgenden Text rot darstellen, gilt bis zum Textende oder einem neuen Farbbefehl
  ~G    nachfolgenden Text grn darstellen, gilt bis zum Textende oder einem neuen Farbbefehl
  ~B    nachfolgenden Text blau darstellen, gilt bis zum Textende oder einem neuen Farbbefehl
  ~Y    nachfolgenden Text gelb darstellen, gilt bis zum Textende oder einem neuen Farbbefehl
  ~S    nachfolgenden Text in Standardfarbe darstellen

Das Men kann um die Anzeige zustzlicher, selbst auswhlbarer JPG-, PNG- und GIF-Bilder aus 
dem Internet erweitert werden. Dazu mu die vollstndige URL des anzuzeigenden Bildes bekannt 
sein. Um dieses Bild mit in das Funktionsmen aufzunehmen, ist folgendes in die tuxwetter.conf ein-
zutragen (vor und hinter dem Komma darf kein Leerzeichenstehen!):

 PICTURE=Anzeigetext im Men,vollstndige URL

Der Text zwischen "=" und "," wird im Funktionsmen zur Auswahl angezeigt, die URL mu nicht er-
lutert werden. Beispiel:

 PICTURE=Temperaturen aktuell,http://image.de.weather.com/web/maps/de_DE/temperature/current/germany_temp_curr_720_de.jpg

Ist aus der Bildadresse kein Bildtyp erkennbar, mu dieser zustzlich mit angegeben werden. Das er-
folgt durch Voranstellen von |JPG|, |GIF| oder |PNG| vor die Bildadresse. Beispiel:

 PICTURE=Stauwarnung Hessen,|GIF|http://www.swr3.de/info/verkehr/verkehr_images.php?img=M05
 
Da man auch Webcams anzeigen kann, welche ihr Bild in bestimmten Abstnden aufrischen, kann
man New-Tuxwetter auch anweisen, das angezeigte Bild in einem vorgebbaren Intervall selbst-
stndig neu zu laden, ohne da eine Taste gedrckt werden mu. Dazu ist eine Erweiterung des
oben beschriebenen Bildtyps um die Zahlenangabe des Updateintervalls in Sekunden erforderlich.
Der Bildtyp mu in diesem Fall also zwingend angegeben werden. Das folgende Beispiel frischt
das angezeigte Bild aller 30 Sekunden auf:

 PICTURE=Empuria-Brava,|JPG30|http://www.empuriabrava.tv/tresor/strapro.jpg

Manche Images haben in ihrer URL eine eindeutige Zeitangabe. Um diese Bilder auch ansehen zu 
knnen bietet Tuxwetter die Mglichkeit Platzhalter einzusetzen die zum Zeitpunkt des Aufrufs 
durch aktuelle Zeit und Datum ersetzt werden. Weiter besteht die Mglichkeit, mittels Operato-
ren die Zeit zu beeinflussen, um zum Beispiel gewisse Update-Zyklen exakt treffen zu knnen. 
Ausserdem besteht die Auswahl zwischen MESZ/MEZ und UTC.

Das generelle Format eines Platzhalters besteht aus dem Startzeichen "|", optionalen Operatoren,
einem optionalen Offset und den Formatzeichen: |[LNR][[-]1..99999]Format

Formatzeichen

D : Tag
M : Monat
Y : Jahr
h : Stunde
m : Minute
s : Sekunde

Die Anzahl der Formatzeichen bestimmt die Anzahl der Stellen mit der die Formatzeichen ersetzt 
werden. Beispiel:

"D"   liefert bei Tag 1-9 eine einstellige Ausgabe "1" ... "9" wird die Zahl zweistellig wird 
      auch die Ausgabe zweistellig.

"DD"  liefert bei Tag 1-9 die Ausgabe "01" ... "09" ab dann normal weiter.
"DDD" liefert eben generell eine dreistellige Ausgabe "001" ... "031"
usw.

Eine Ausnahme bildet hier das Jahr. Es wird ausser bei vierstelliger Eingabe immer die Zahl ohne 
das Jahrtausend liefern (Beispiel 2004)

"Y"     = "4"
"YY"    = "04"
"YYY"   = "004"
"YYYY"  = "2004" ! Nur hier wird das Jahrtausend mit ausgegeben!
"YYYYY" = "00004"

Operatoren:

"L" : Local Time (bewirkt, da die lokale Zeit (also MEZ oder MESZ) als Zeitbasis verwendet wird.
      Ohne diesen Operator wird UTC verwendet. Dieser Operator mu nur einmal vorkommen und wirkt
      dann auf alle Zeitangaben
"R" : gefolgt von einer Zahl rundet den zugehrigen Platzhalter auf die Zahl oder deren Vielfaches.
"N" : gefolgt von einer Zahl bewirkt den Abzug der Zahl von dem zugehrigen Platzhalter ohne da 
      diese ausgegeben wird. Ist zum Beispiel notwendig, wenn anschlieend noch gerundet werden soll.
"15": gemeint ist eine beliebige Zahl die dann vom zugehrigen Platzhalter abgezogen wird. Alle abzu-
      ziehenden Werte in der gesamten Adresse werden zunchst gemeinsam von der aktuellen Zeit abgezo-
      gen und erst dann wird mit der Ersetzung begonnen. So kann zum Beispiel der Abzug von zwei Mi-
      nuten, wenn es eine Minute nach der vollen Stunde ist, auch die Stunde verringern. Das gilt fr
      alle Zeitwerte. WIrd hier eine negative Zahl (Bsp. -15) angegeben, wird diese Zeit zur aktuellen
      Zeit addiert, um Bilder mit einem Zeitstempel, welcher der aktuellen Zeit vorauselt, anzeigen zu
      knnen.
      
Da das ganze doch etwas trocken ist, mal ein paar Beispiele:

Wir nehmen an, es ist der 02.01.2005 um 03:16:25 MESZ

|YYYY|MM|DD|hh|mm|ss                                20050102011625  // Stunde = 01 (UTC)
|LYYYY|MM|DD|hh|mm|ss                               20050102031625  // Stunde = 03 (MESZ)
|YYYY|MM|2DD|2hh                                    2004123023      // 2 Tage und 2 Stunden abgezogen
|1hh|R15mm                                          0015            // 1 h abgezogen, Runden auf 15 min
|1hh|N15m|R15mm                                     0000            // 1h 15 min "  , " (sichere Lsung)
|L1hh|N15m|R15mm                                    0200            //  " aber MESZ


Praxis: (ein viertelstndlich aktualisiertes Bild, Datum: 13.10.2004 21:16:00 MESZ)

http://www.wetteronline.de/daten/radar/dwdd/|YYYY/|MM/|DD|hh|R15mm.gif  ergibt
http://www.wetteronline.de/daten/radar/dwdd/2004/10/131915.gif

Das knnte knapp werden, da um 21:16 das Bild von 21:15 bestimmt noch nicht geuppt wurde, und wrde der
Aufruf um 21:15 erfolgen, htte der Server gar keinen Vorlauf mehr. Sicherer ist es daher, noch eine
viertel Stunde abzuziehen und dann erst zu runden:

http://www.wetteronline.de/daten/radar/dwdd/|YYYY/|MM/|DD|hh|N15m|R15mm.gif  ergibt
http://www.wetteronline.de/daten/radar/dwdd/2004/10/131900.gif

Dieses Beispiel knnt Ihr direkt verwenden.

Fr Bildadressen, die sich nicht ber Zeitfunktionen berechnen lassen, gibt es die Mglichkeit, diese
Adresse aus dem Quelltext der HTML-Seite extrahieren zu lassen. Dazu ist im Quelltext nach dem Bild-
namen zu suchen. Die Textstcke, die den Namen des Bildes vorn (Grenze_vorn) und hinten (Grenze_hinten)
einschlieen, sollten nun bekannt sein. Um die Bildadresse ermitteln zu lassen, ist ein Eintrag in der
Form:

 PICHTML=Anzeigetext im Men,URL_der_HTML_Seite|Grenze_vorn|Grenze_hinten

Beispiel:
HTML-Quelltext:
 ....
 </map>

 <img src="http://212.224.23.107/images/index0000046169.png"width="550" height="500" name="Karte" usemap="#Karte" border="0"/>
 </div>
     </td>
    </tr>
 ....

Eintrag in der tuxwetter.conf:

 PICHTML=Unwetter-Warnungen,http://www.unwetterzentrale.de/uwz/index.html|<img src="|" width="550" height="500" name="Karte" usemap="#Karte" border="0"/>


Achtung!! Es koennen nur JPG- und bestimmte Typen von PNG- und GIF-Bildern dargestellt werden. Da-
bei sind jedoch auch animierte GIFs mglich, deren Einzelbilder automatisch nacheinender angezeigt 
werden.

Werden auf Internetseiten interessante Texte angezeigt, kann man sich die in begrenztem Umfang auch auf dem
Bildschirm darstellen lassen. Dazu gibt es den Typ TXTHTML. In der Syntax gleich aufgebaut wie PICHTML stellt
diese Typ den zwischen den Begrenzern gefundenen Text auf dem Bildschirm dar. Dazu werden alle HTML-Tags ent-
fernt und, wenn ntig Zeilenumbrche fr die Formatierung eingefgt.


 TXTHTML=Anzeigetext im Men,URL_der_HTML_Seite|Grenze_vorn|Grenze_hinten

Beispiel-Eintrag in der tuxwetter.conf:

 TXTHTML=Waldbrandwarnung,http://www.zamg.ac.at/dyn/warnungen/waldb.htm|<!-- Waldbrandindex gif -->|  Uhr</font> 
 
Werden in den zu analysierenden HTML-Seiten die Links auf Bilder oder andere Seiten relativ dargestellt (also
ohne Angabe einer Serveradresse), wird davon ausgegangen, da die Links auf das Root-Verzeichnis des Servers
verweisen. Liegen die Links nicht im Root sondern im selben Verzeichnis wie die HTML-Seite, ist der Eintrag
fr diese Seite mit der Adresse "httpabs://.." einzutragen.
Beispiel:
Adresse:

  http://www.mtit.at/verkehrsbilder/scripts/getlastpicture.asp?cam=61

liefert als Quelltext:

  ...
  <tr>
  <td><img src="mmobjholen.asp?id=129125&time=23.01.2005 17:00:03" width="320" height="240" border="0"></td>
  </tr>
  ...

Dabei wrde das Script "mmobjholen" in "http//www.mtit.at/" erwartet werden. Es liegt jedoch in 
"http://www.mtit.at/verkehrsbilder/scripts/". Daher mu der Eintrag in der Config-Datei lauten:

  PICHTML=Auhof,|JPG|httpabs://www.mtit.at/verkehrsbilder/scripts/getlastpicture.asp?cam=61|<td><img src="|" width="320" height="240" border="0"></td>

Internetseiten oder auch Dateien auf Netzwerkfreigaben im reinen Textformat lassen sich mit dem Plugin eben-
falls darstellen. Dazu gibt es den Typ TXTPLAIN. Mit diesem Eintrag wird eine reine Textseite heruntergeladen
und angezeigt.

 TXTPLAIN=Anzeigetext im Men,URL_der_Text_Seite


Die Wetterwarnungen des deutschen Wetterdienstes knnen auf separaten Textseiten dargestellt werden.
Um an die aktuellen gewnschten Adressen (URL's) fr die Wetterwarnungsdaten zu kommenen, folgenderma-
en vorgehen: 
http:///www.wettergefahren.de/de/WundK/Warnungen/index.htm
aufrufen. 
Dort auf das gewnschte Bundesland klicken, z.B. Baden-Wrttemberg. 
Dann regionaler Warnlagebericht anklicken, dann im folgenden Fenster auf Datei->Eigenschaften klicken. 
Im Fenster Eigenschaften die Url herauskopieren. Diese Url dann mit einem Unix fhigen Editor z.B. 
Ultraedit in die tuxwetter.conf einfgen. In der gleichen Zeile davor hinschreiben 
TEXTPAGE=Warnlage Baden-Wrttemberg, 
Das gewnschte Ergebnis sollte so aussehen. 

 TEXTPAGE=Warnlage Baden-Wrttemberg,http:///www.wettergefahren.de/de/WundK/Warnungen/zeige.php?WL=SU00  

Um an die Wetterwarnungen fr den Landkreis zu kommen, den Landkreis auf der Wetterwarnungskarte 
des Bundeslandes anklicken. Ich mchte dies hier am Beispiel Reutlingen erklren. Ihr klickt in der 
Wetterwarnungskarte von Baden-Wrttemberg auf den Landkreis Reutlingen. Dann im folgenden Fenster auf 
Datei->Eigenschaften klicken. Im Fenster Eigenschaften die Url herauskopieren. Diese Url dann mit einem 
Unix fhigen Editor z.B. Ultraedit in die tuxwetter.conf einfgen. In der gleichen Zeile davor hinschreiben 
TEXTPAGE=Warnstatus Reutlingen, 
Das gewnschte Ergebnis sollte so aussehen. 

 TEXTPAGE=Warnstatus Reutlingen,http:///www.wettergefahren.de/de/WundK/Warnungen/zeige.php?ID=RT#O  


Sollen bestimmte Programme oder Scripte aufgerufen werden, kann der Eintrag "EXECUTE=" verwendet
werden. Er fhrt den eingetragenen Text auf der Kommandozeile aus. Die Syntx ist:

 EXECUTE=Anzeigename im Men,auszufhrendes Kommando
 
Beispiel:

 EXECUTE=Box neu starten,reboot

Zu den Tasten:

Bei Anzeige eines Bildes kann mittels der Hoch-/Runter-Tasten zum nchsten oder vorhergehenden Bild 
gewechselt werden, ohne erst ber das Men zu gehen. Um trotzdem darber zu informieren, welches
Bild gerade angezeigt wird, wird der Menname des Bildes zustzlich noch auf dem LCD-Display der Box
angezeigt. Geschlossen wird die Grafik-Anzeige mit der OK-Taste.
Ein animiertes GIF kann nach seinem Ablauf mi der Rechts-Taste erneut gestartet werden, ohne da es 
erst noch mal aus dem Internet geladen wird. Die Links-Taste fhrt zum erneuten Download des letzten
Bildes. Das ist vor allem fr das Betrachten von WebCam-Bildern vorgesehen.
Whrend des Ladens und Konvertierens von Bildern wird in der linken oberen Bildschirmecke das vom 
Pictureviewer her bekannte "Busy-Symbol", ein kleines rotes Rechteck eingeblendet, um darauf hinzu-
weisen, da die Box beschftigt ist.
Bei lngeren Warnmeldungen (erkennbar am Zeichen ">>" in der linken unteren Ecke") kann mit der Rechts-
Taste um 5 Zeilen vor- und mit der Links-Taste um 5 Zeilen zurckgescrollt werden.

Bei Bildern grer 100 kB, wird in der 1.Zeile des LCD-Displays der Dbox ein Ladefortschrittsbalken
angezeigt. Darunter wird der Name des Bilds eingeblendet. Es konnte aber kein korrekter Zeilenumbruch
implementiert werden, da das Wetterplugin sonst zu gro geworden wre. (Die Box ist ja kein Duden :-).)

Nach Anpassung der tuxwetter.conf und Neustart der Box steht das Plugin unter dem Men der blauen 
Taste als "Wettervorhersage" zur Verfgung.

Wem die auf dem LCD-Display angezeigten Wettersymbole zu spartanisch sind, kann die Datei
bmps.tar.Z aus dem Ordner "alternative LCD-Symbole" ins Verzeichnis /var/plugins/tuxwet
kopieren (die alte Datei berschreiben). das ist, wie so Vieles, immer eine Geschmacksfrage.

Zur Bedienung: Die Mens werden ber die Home-Taste, die Wetter- und Grafik-Anzeigen sowohl ber die
HOME- als auch ber die OK-Taste geschlossen. Auch innerhalb der Datenanzeigen kann mittels der Hoch-
/Runter-Tasten zum jeweils vorhergehenden oder folgenden Eintrag gewechselt werden.
Zum vorhergenden Men gelangt man mit der HOME-Taste. Die Standby-Taste beendet das Programm aus
allen Menebenen heraus.

Eine Hilfebildschirm, welcher alle Tasten und deren Funktionen beschreibt, kann mit der Taste "?" 
aufgerufen werden. Auch die aktuelle Programmversion wird in der Titelzeile angezeigt. Dieser 
Hilfebildschirm wird auch mit der OK-Taste wieder geschlossen.

Da bei einigen Images das Problem auftrat, da bei lngerer Nutzung des Plugins die Uhrzeit nachging,
da der Prozessor aufgrund der Auslastung nicht mehr in der Lage war, die Berechnung der Uhrzeit wei-
terzufhren, liegt im Ordner "optionale Zeitkorrektur" ein Programm namens "swisstime". Diese Programm
holt sich von einem Schweizer Atomzeit-Server die aktuelle Zeit und setzt damit die Uhr der DBox.
Dieses Programm ist bei Bedarf in den Ordner /var/plugins/tuxwet/ zu kopieren, und mit den Rechten 755
zu versehen. Das Plugin erkennt, ob dieses Programm vorhanden ist, und ruft es dann beim Beenden des
Plugins auf. Somit wird die Uhrzeit wieder korrigiert. Wer keine Probleme mit einer nachgehenden Uhr
hat (das ist vom Image abhngig), bentigt dieses Programm nicht.

Die Datei convert.list dient der bersetzung der englischen Texte vom Wetterserver in deutsche Texte.
Sollten da mal irgendwelche komischen Anzeigen bei der Wettervorsage stehen, postet bitte ins
Keywelt-Forum in die Rubrik New-Tuxwetter-Plugin, damit die fehlerhaften Anzeigen korrigiert werden
knnen.
Fehlende bersetzungen werden in einer Liste gesammelt, welche aus dem Hauptmen mit der DBox-Taste
angezeigt werden kann. Das erleichtert die Meldung solcher bersetzungen im Board. Soll die Fehler-
liste (nach Korrektut der convert.list) gelscht werden, kann das mit der roten Taste erfolgen, whrend
die Fehlerliste angezeigt wird.
Ab der Version 3.00 dient die Datei convert.list gleichzeitig der Lokalisierung aller angezeigten
Texte. Im unteren Teil befinden sich dafr die originalen deutschen Meldungen, gefolgt von dem Zeichen
"|". Unmittelbar danach kann man eintragen, was statt dieses Textes angezeigt werden soll. Das kann
sowohl eine Fremdsprache sein als auch eine deutsche Meldung, welche Euch besser als die originale
gefllt. Dabei aber bitte beachten, da der neue Text bei den Meldungen fr die Datenanzeige nicht lnger 
als der in der Anzeige zur Verfgung stehende Platz werden sollte, da sonst die Formatierung der An-
zeige darunter leiden wrde. Steht kein neuer Text hinter dem "|", wird der Originaltext verwendet.

Wer sich eine so groe tuxwetter.conf zusammengestellt hat, da Schwierigkeiten mit dem Platz auf der
Box auftauchen, kann die tuxwetter.conf auch auf den PC auslagern und mit dem Plugin ber ein vorher
gemountetes Verzeichnis darauf zugreifen. Dazu kann tuxwetter sowohl aus der tuxwetter.so als auch von 
der Kommandozeile aus mit einem Parameter fr die zu verwendende Konfigurationsdatei aufgerufen werden. 
Der abweichende Pfad zur Config-Datei kann in der tuxwetter.so mit einem Hex-Editor ab Adresse 1E35H 
eingetragen werden. Ist zum Beispiel das Verzeichnis /mnt/configs/ gemountet, und auf diesem befindet
sich eine tuxwetter.conf auf dem PC, wird in der tuxwetter.so ab Adresse 1E35H die Zeichenfolge 

  /mnt/configs/tuxwetter.conf
  
eingetragen, oder das Plugin so ber die Kommandozeile (z.B. aus dem FlexMen) aufgerufen:

  /var/plugins/tuxwet/tuxwetter /mnt/configs/tuxwetter.conf
  
Wird kein Kommandozeilenparameter angegeben oder wurde die als Kommandozeilenparameter angegebene Config
nicht gefunden (Verzeichnis nicht gemountet), verwendet das Plugin die Datei 

  /var/plugins/tuxwet/tuxwetter.conf.
  
Wird New-Tuxwetter zustzlich mit einem Aktionseintrag als Kommandozeilenparameter aufgerufen, so fhrt
es die entsprechende Aktion sofort aus, und beendet sich wieder, wenn die Aktion abgeschlossen wurde.
Somit kann New-Tuxwetter nun auch als aus Scripten heraus aufrufbarer Bildbetrachter oder Textviewer
verwendet werden.
Beispiel:

  /var/plugins/tuxwet/tuxwetter 'PICTURE=Teletarif Bild,http://www.teltarif.de/db/blitz.gif?preis=1&ziel=Ortsgespr~ach,Fern,Mobilfunk&ve=1&blank=1&019x=0&width=249&height=200'

zeigt sofort die aktuellen Telefontarife auf dem Bildschirm an, und beendet sich nach Schlieen des Bildes.
Folgende Aktionen knnen als Kommandozeilenparameter verwendet werden: PICTURE, PICHTML, TXTHTML,TEXTPAGE,
TXTPLAIN und EXECUTE. Der Kommandozeilenparameter ist unbedingt in einfache Hochkommasn einzuschlieen,
um die Kommandozeile komplett einschlielich Leerzeichen in den ersten Parameter bergeben zu knnen. Da
die Kommandozeile keine Umlaute und Sonderzeichen bergeben kann, sind, wie im Beispiel, die Sonderzeichen
durch eine vorangestellte Tilde zu kennzeichnen. Folgende Sonderzeichen werden untersttzt:

  ~a    
  ~o    
  ~u    
  ~A    
  ~O    
  ~U    
  ~z    
  ~d     (degree)

Zur Konfiguration des Plugins ber das Flexible Men-Plugin (FlexMen) befindet sich ein Unterordner mit
dem in die shellexec.conf einzufgenden Abschnitt, ein zugehriges Script (twops, bentigt die Rechte 755)
und die zustzlich erforderliche Config-Datei tuxwetter.mcf im Verzeichnis "Konfiguration ber FlexMen".
Thx to MailMan fr die Erstellung der FlexMen-Konfiguration.


Also, viel Spa und viel Erfolg

Das New-Tuxwetter-Team
SnowHead, Worschter, Seddi und Sanguiniker