Navi-RunnerMN6 V1.7 -  Wichtige Infomationen  - 22.01.2008 

NaviRunner bentigt Mortscript-Version V4.0 oder hher!

Beachtet auch das "ChangeLog.txt". Hier sind viele wichtige Infos
und Hinweise zu den Funktionen zu finden, die im Laufe der Zeit 
hinzugekommen sind!


Hey, was sind das alles fr Dateien?
------------------------------------
- Navi-Runner_4_MN6.mscr ist das Hauptscript, das gestartet werden muss.
- Dateien, die mit "NR-" anfangen sowie MN6-Colorteach.mscr sind einzeln 
  ausfhrbare Hilfsprogramme fr verschiedene "Problemlsungen" (siehe unten).
- Dateien, die mit "Sub_" anfangen, sind ausgelagerte Unterroutinen von
  NaviRunner, da das Hauptscript sonst zu umfangreich wird. Diese knnen nur
  vom Navirunner-Hauptscript aufgerufen werden.
- Das !liesmich.txt hast Du ja schon gefunden ;-)

SCHNELLSTART:
-------------
Die Installation ist nun sehr einfach und besteht aus wenigen Schritten:
1. MortScript V4.0 oder neuer installieren 
   http://mort.sto-helit.de/index.php?module=download&entry=11&action=list
2. Einmalig die Mortscript.exe im MortScript Verzeichnis starten.
3. Navi-Runner Zip-File auf dem PC entpacken und das komplette Navi-Runner 
   Verzeichnis aus dem Zip-File in ein beliebiges Verzeichnis 
   (z.B. \Programme\ oder \Storage-Card\Programme) auf den PPC kopieren.
4. NR_4_MN6-Installer.mscr Script auf dem PPC starten und die gewnschte 
   Installationsart auswhlen (Weitere Optionen werden im Verlauf der 
   Installation abgefragt). Fertig.
5. Navi-Runner anschlieend ber Navigator-Hardwaretaste, aus dem 
   Startmen oder ber den Heute-Bildschirm aufrufen. 

ACHTUNG, WICHTIG: 
Bei Problemen mit der Helligkeitsumschaltung NR-BacklightCheck.mscr starten.
HINWEIS: Auf PNAs fhrt Navirunner grundstzlich KEINE Vernderung der 
Hintergrundbeleuchtung durch, das dies auf PNAs in der Regel durch MN6 
selber gemacht wird.

Bei Problemen mit der Kartenumschaltung oder TMC-Senderumschaltung
MN6-Colorteach.mscr starten.

Bei Problemen mit der POI-Warner aktivierung (wegklicken der Warner-Fensters)
NR-WarnerColorCheck.mscr starten.

Mehr Infos zu den genannten Scripts gibt es weiter unten unter ZUSATZMODULE!
Ausserdem sind im "ChangeLog.txt" viele wichtige Infos ind Hinweise zu den 
Funktionen zu finden, die im Laufe der Zeit hinzugekommen sind!


Installationshinweise:
----------------------
Der Installer stellt alle notwendigen Verknpfungen her, um das Navi-Runner 
Script aus dem Startmen oder von der Navigator-Hardwaretaste zu starten. 
Auf Wunsch wird automatisch die GPSAPP.exe deaktiviert (Nur relevant fr
MD 96700 und MD96710, fr alle anderen PDAs "Nur Verknpfungen erstellen"
auswhlen. Hinweis: Der Installer liest die Originalbelegung der 
Hardwaretaste 40C3 aus und speichert diese in einer Ininstall.ini. Im
Deinstallationsmodus wird die Originalbelegung wieder hergestellt.

Es gibt drei Installationsvarianten:
a) Erstellen der notwendigen Verknpfungen und deaktivieren der GPSAPP.exe 
   (empfohlen fr MD 96700 / MD 96710)
b) Nur erstellen der notwendigen Verknpfungen, GPSAPP bleibt aktiv
   (empfohlen fr alle anderen PDAs)
c) Deinstallation - Alle vom Installer durchgefhrten nderungen werden 
   rckgngig gemacht. Die zu Navi-Runner gehrigen Dateien werden nicht
   gelscht. Bei Bedarf einfach das komplette NaviRunner-Verzeichnis 
   lschen. Die GPSAPP.Exe wird, falls sie vom Installer deaktivert 
   wurde, wieder im Autotart eingebunden und aktiviert.

Hinweis: Sollte das InstallerScript bei Doppelklick nicht starten, ist 
MortScript noch nicht korrekt im System registriert. Hierzu einmalig die 
Datei MortScript.exe im MortScript Installationsverzeichnis starten. 
Normalerweise wird das aber schon bei der MortScript Installation erledigt



Anpassung des Scripts an die eigenen Bedrfnisse:
-------------------------------------------------
Alle Einstellungen werden ber Presets in der Datei DefaultPrefs.txt
im Verzeichnis \Config gemacht.
Hierzu die Datei mittels eines Text Editors (Nicht Word!) auf dem 
PDA oder auf dem PC ffen und die Werte der Presets ndern. 
Alle Presets haben eine kurze Funktionsbeschreibung mit Angabe der 
mglichen Einstellungen. Hinweis: Farbwerte aus externen Inis 
haben hhere Prioritt als die Standardwerte in NaviRunner. Wenn
externe Farbinis erstellt wurden, mssen die Farbwerte hier gendert 
werden, ansonsten die Inis lschen und die Werte direkt in Navirunner 
eintragen (spart minimal Startzeit).

NEU AB V1.5: nderungen knnen nun auch in die Datei UserPrefs.txt
eingetragen werden! Hierzu einmalig die Datei !UsrPrf.txt in
UserPrefs.txt umbenennen (macht normalerweise schon der Installer) 
und dann die zu ndernden Presets aus DefaultPrefs.txt und / oder 
NR-Start_N_Quit per Kopieren-Einfgen in die Datei UserPrefs.txt bernehmen. 
Bei eventuellen Updates von NaviRunner wird diese Datei nicht berschrieben 
und die nderungen bleiben somit auch fr zuknftige Versionen erhalten.



Untersttzung von alternativen Skins:
-------------------------------------
In Script selber ist der originale Navigon MN6-Skin einprogrammiert.
Wer diesen benutzt, muss nichts weiter machen.
Fr alle andern Skins muss das Script MN6-Colorteach.mscr ins MN6-Verzeichnis 
kopiert und dort gestartet werden. Die vom Script ermittelten Farbwerte 
werden automatisch in Ini-Dateien im MN6 Verzeichnis gespeichert. Diese Dateien
(NR_P_colors.ini und/oder NR_L_colors.ini) mssen auch dort verbleiben, 
damit NaviRunner sie findet und verarbeiten kann.
ACHTUNG: NaviRunner & Colorteach kunktionieren nur mit nicht-transparenten 
Skins! Bitte genau den Anweisungen auf dem Bildschirm Folge leisten, damit
das Auslesen aller Farbwerte funktioniert. Sehr wichtig ist, dass ein 
TMC-Empfnger angeschlossen, aber noch nicht mit der Antenne verbunden ist.
Es darf zu Beginn noch kein Sender gefunden werden! Dann bei Aufforderung 
die Antenne einstecken. Der Rest geht vollautomatisch.

Wichtig ab V1.7: TMC-Senderumschaltung bei bevorstehendem Abbiegen blockieren.
Diese neue Funktion wird mit dem Preset "NoTMCChangeBeforeTurn = 1"
aktiviert. Das Preset wird automatisch gesetzt, wenn Colorteach ausgefhrt und
die entsprechenden Fragen positiv beantwortet werden. 
ACHTUNG! Falls ein alternativer Skin verwendet wird, bei dem die Position des 
Abbiegepfeil verndert wurde, MSSEN die neuen Koordinaten des untersten 
Quadrats des Balkens neben den Abbiegepfeilen emittelt und in die Variablen am 
Anfang des MN6-Colorteach.mscr Scripts eingetragen werden! Die Werte fr
den TrueNavigon II XL Skin von Zero511 habe ich bereits ermittelt, sie stehem im
Kommentar ber den Variablen und mssen nur noch eingetragen werden.  
Zur Emittlung der neuen Koordinaten muss ein Screenshot, z.B. mit PowerSnap, 
erstellt werden, auf dem der Abbiegepfeil mit dem seitlichen Balken zu sehen ist.
Dann ldt man das Bild auf dem PC, z.B. in Paint ein und whlt ein Werkzeug aus
das die aktuellen Koordinaten des Cursors anzeigt (Ich nehme immer das Werkzeug 
fr Rechtecke). Nun den cursor mittig auf das UNTERSTE Quadrat des Balkens bringen
und die aktuellen Koordinaten (Y, Y) notieren. Jetzt das MN6-Colorteach.mscr mit
einem Texeditor ffen und die Koordinaten an folgender Stelle eintragen:
ArrowChkPos_P_X = ???
ArrowChkPos_P_Y = ???
ArrowChkPos_L_X = ???
ArrowChkPos_L_Y = ???
Die Werte des Originalen MN6-Skins mssen mit den neuen berschrieben werden. 
Es mssen nur die Werte fr die gewnschte Ausrichtung (P - Hochkant oder 
L- Querformat) gendert werden. Nach der nderung speichern nicht vergessen!
Anschlieend MN6-Colorteach starten und durchlaufen lassen. 
Hinweis: Wenn dies nicht korrekt durchgefhrt wird, kann die TMC-Senderumschltung
nicht funktionieren! Im Zweifel lieber im Colorteach angeben, dass
die Senderumschaltung vor Abbiegevorgngen nicht geblockt werden soll, so wie 
es vor NaviRunner V1.7 der Fall war (NoTMCChangeBeforeTurn = 0).


Das Script ist generell in der Lage, den Darstellungsmodus des PDA, 
Portrait (Hochformat) oder Landscape (Breitformat) zu erkennen und die 
simulierten Mausklicks fr die Kartenumschaltung dementsprechend anzupassen. 
Der Skin muss dies untersttzen, also ber ein Portait- und ein Landscape-
Layout verfgen. Der Darstellungsmodus wird whrend der gesamten Navigator-
laufzeit abgefragt, das heisst, auch wenn der Navigator z.B. im Portrait-Modus 
gestartet und erst hinterher auf Landscape umgeschaltet wird, funktioniert 
die Kartenumschaltung. Man sollte allerdings drauf achten, nicht genau dann 
den Darstellungsmodus zu wechseln, whrend das Script gerade die 
Kartenumschaltung durchfhrt.


ZUSATZMODULE:
-------------
NR_4_MN6-Installer.mscr
Installationsscript zum Erzeugen eines Icons unter Startmen/Programme und 
zum optionalen belegen einer beliebigen Hardwaretaste (Navigator-Taste) 
mit NaviRunner. Weiterhin kann das MN6-Icon im Heute-Bildschirm optional
mit NaviRunner belegt werden. Ab V1.6 werden auch die wichtigsten 
Grundeinstellungen im Installer durchgefhrt.
Der Menpunkt "Deinstallation" macht alle nderungen wieder rckgngig.

MN6-Colorteach.mscr
Untersttzung aller nicht-transparenten(!) Skins durch automatisches 
auslesen aller bentigten Farbwerte aus MN6. Hierzu wird das Script 
MN6-ColorTeach mitgeliefert, welches alle bentigten Werte aus MN6 ausliest 
und in Ini-Dateien speichert. Diese Inis werden automatisch von NaviRunnerMN6 
eingelesen und verwendet. MN6 ColorTeach sollte mit allen Skins funktionieren, 
solange das Layout von MN6 nicht verndert wird. Die vom Script ermittelten 
Farbwerte werden automatisch in Ini-Dateien im \Config Verzeichnis gespeichert. 
Diese Dateien (NR_P_colors.ini und/oder NR_L_colors.ini) mssen auch dort 
verbleiben, damit NaviRunner sie findet und verarbeiten kann.

NR-WarnerColorCheck.mscr
Script zur Ermittlung der korrekten Farbwerte aus dem POIWarner zur Eingabe 
in NaviRunner_4_MN6. Notwendig wenn auf Grund der PDA-Hardware Farbwerte 
anders ausgelesen werden, als im Script abgespeichert. Ermittelte Daten 
knnen dann in die NaviRunner-Presets eingetragen werden bzw. werden von
Navirunner ab Version 1.3 automatisch eingelesen.

NR-BacklightCheck.mscr
Die Helligkeitsanpassung der Hintergrundbeleuchtung funktioniert auf fast 
jedem PDA-Typ anders, mit anderen Programmen und unterschiedlichen Parametern. 
NR-BacklightCheck ist ein Script zur Ermittlung der korrekten Parameter fr 
die Ansteuerung der PDA-Hintergrundbeleuchtung sowie zur Auswahl des passenen 
Backlight-Steuerprogrammes. 
Ermittelte Werte werden in der Datei "Backlight-Settings.txt" im Script-
verzeichnis abgespeichert. Die Werte werden dann automatisch in NaviRunner 
eingelesen. Das Script lst sicherlich nicht alle Probleme im Bezug auf die 
Steuerung der Hintergrundbeleuchtung, sollte aber meist eine funktionierende 
Einstellung ermitteln knnen. Achtung: Bei Upgrade auf NaviRunner V1.3 muss 
BacklightCheck erneut ausgefhrt werden!

NR-Start_N_Quit
Dieses Zusatzscript ermglicht es, das Navigationssystem ber die Hardwaretaste 
zu starten und durch einen weiteren Tastendruck wieder herunter zu fahren. Dies 
funktioniert aus dem Hauptmen, der Kartenansicht und aus der Navigation. 
Sicherheitshinweise und Infomeldungen selbsteverstndlich sind per Preset 
abschaltbar. Praktisch, wenn man kurz vor erreichen des Ziels das System schon 
herunterfahren will. Ein Druck auf die Hardwaretaste gengt. NR-Start_N_Quit 
wird auf Wunsch automatisch ber den Installer eingebunden. Seit V1.5 holt das 
Script MN6 bei einem Druck auf die Hardwaretaste wieder in den Vordergrund, 
falls MN6 minimiert oder ien andes Program in Vordergrund ist.


Kurzbeschreibung:
----------------- 
Das NaviRunner-Script prft, ob NAVIGON Mobile Navigator 6.xx
installiert ist und startet den Navigator, falls er noch nicht gestartet ist.
Bei Anwahl von Betriebsart AKKU: Hintergrundbeleuchtung beim Start des 
Navigators von "standard" auf "dunkel" schalten & regelmssig den
Idle-Timer zurcksetzen, um ausschalten der PDAs bei laufender Navigation 
zu verhindern. ACHTUNG: Navigator IMMER vor dem Ausschalten des PDAs beenden,
um Akkuentleerung bei versehentlichem / timergesteuertem Einschalten zu 
vermeiden!
Bei Anwahl von Betriebsart NETZ wird die Hintergrundbeleuchtung je nach
Tageszeit (Tag, Dmmerung, Nacht) automatisch auf "hell", "mittel" oder 
"dunkel" verndert. Hierzu berechnet das Script (grob) den Sonnenauf- und 
Untergang des aktuellen Tages und schaltet zur berechneten Uhrzeit bei
laufendem Navigator die Hintergrundbeleuchtung entsprechend um.
Sommer- und Winterzeitwechsel bis 2010 sind programmmiert.

Wenn das Preset "MapSwitchFlag" auf 1 gesetzt ist, wird die Navigator-Karte 
bei Sonnenuntergang auf "Nachtansicht" und bei Sonnenaufgang auf "Tagansicht" 
geschaltet. Die Kartenumschaltung funktioniert ohne nderungen nur mit den 
im LIESMICH.TEXT aufgelisteten Skins!

ACHTUNG: Damit die TMC-Wechselfunktion funktioniert MUSS der Kompass im MN6
eingeschaltet sein!


Weitere Features:
-----------------
* Bequemes starten und beenden von MN6 ber EINE Hardwaretaste, auf Wunsch 
  ohne jede Sicherheitsabfrage. "Nach vorne holen" von MN6 ber die gleiche Taste.
* Optionaler Start von GoFast oder PockeInfomat ber konfigurierbares Startmen.
* Automatische Helligkeitssteuerung der PDA Hintergrundbeleuchtung je nach 
  Tageszeit (berechnet nach den aktuellen Sonnenauf- und Untergang) und dem Status 
  der Stromversorgung (NETZ/AKKU).
* Automatische Tag/Nacht Umschaltung der Navigator-Kartenansicht zum Zeitpunkt 
  des berechneten Sonnenauf-und Untergangs.
* Automatische Besttigung des StVO-Sicherheitshinweises (muss per Preset
  im Script aktiviert werden (AutoConfirm auf 1 setzen). Hinweis lesen!).
* Intelligente, abschaltbare Auto-Map Funktion. (Automatische Umschaltung auf 
  Kartenansicht nach Navigatorstart bei erfolgtem Sat-Fix und nach frei whlbarer 
  Mindestwartezeit, wenn von User whrend der Wartezeit keine Eingabe erfolgt.)
* Konfigurier- und abschaltbares automatisches drehen der Bildschirmansicht auf 
  Landscape (90  rechts oder 90 links) bei Scriptstart und und wieder auf 
  Portrait bei Scriptende. (Scriptablauf flssiger als beim drehen ber MN6).
* Auto-Abfrage der PDA-Betriebsart Portrait (Hoch) und Landscape (Breit).
* Auto-Prfung des Status der Stromversorgung (NETZ/AKKU).
* Automatische Erstellung von Sicherungskopien wichtiger Navigator-INIs.
* Vollstndige Untersttzung des POI-WARNERs (starten, aktivieren, beenden) im 
  Portrait- und Landscape-Modus (Voraussetzung: Preset "Set Warner_Start" auf 1,
  POI-Warner installiert, in den Presets korrekter Pfad zum POI-Warner Icon angegeben).
* Untersttzung der alten (2.x) und der neuen (3.x) POI-Warner Version.
* Optionales Nachladen des POI-Warners bei Erkennung des Kartenfensters oder erst 
  nach Start einer Navigation.
* Zeitoptimierter, automatischer TMC-Senderwechsel (konfigurier- & abschaltbar) 
  Wechselgeschwindigkeit skaliert mit der PDA-Geschwindigkeit - keine festen Pausen.
* Akku-berwachung und Abschaltung des PDAs bei Unterschreitung einer Mindestladung 
  (Danke an @Dflesch!)
* Sleep / Reaktivierungsroutine legt NaviRunner auf Wunsch schlafen und schaltet 
  Nachts die Hintergrundbeleuchtung heller, wenn MN6 nicht im Vordergrund ist. 
  (Danke an @Dflesch!)
* Soundausgabe fr verschiedene Ereignisse (Begrssung, Ende, TMC-Wechsel, TMC Status,
  GPS Satus).
* Spielerei: "Kirchturmsimulation" Uhrzeitabhngiger Glockenschlag alle 15 min & zur 
  vollen Stunde. Anzahl der Glockenschlge entspricht der aktuellen Uhrzeit.
* Regelmssige Rcksetztung des Idle Timers (verhindert Gerteabschaltunng im Akkubetrieb)
* Setzen des Hakens bei "Gert abschalten nach X Minuten in den PDA -
  Energieeinstellungen, falls MN6 mal wieder "vergisst" den Haken zu setzen...
* Optionales setzen von festen Timeout-Werten fr Gerteabschaltung und 
  Beleuchtungsabschaltung im Netz und Akkubetrieb.
* Optionales beenden aller laufenden Programme bei Scriptende (nur getestet auf MD967xx).
* Optionales Auto-Ausschalten des PDAs nach Beendigung des Navigators, auf Wunsch mit 
  konfigurierbarem Softreset nach jedem X-ten Start (Reset-Off)


Danksagungen:
-------------
Vielen Dank an folgende Forenmitglieder, durch deren Hilfe Navirunner auf
weitere Systeme angepasst werden konnte:
@dflesch fr die Informationen ber ASUS-PDAs, seine Betatests & klasse Ideen.
@Oldtimer frs Beta-Testen der ASUS-Roitinen und die ausfhlichen Rckmeldungen.
@PeterFranz fr seine klasse HP iPAQ hx2xxx Backlight-Routinen.
@adruschs und @binfredusa fr die Infos und die Beta-Tests fr den Yakumo Delty 300.
sowie all diejenigen, die mitgeholfen haben, NaviRunner durch ihre Anregungen und 
Rckmeldungen zu dem zu machen, was es heute ist.

