------------------
 /O\ O
 /|\/|\ -o- o
  |  |   /\ | o/\
----Shebi Team----

UberExport 0.2.8 (16.02.2011)
UberExport Shebi Team iconset



UberExport
==========

Aneb takovy nejaky normalni GSAKoidni makro pro Garmin Colorado ci Oregon.


Upozorneni
----------

Jestli vam to sezere GPS, tak jsem vas varoval ... makro je ve vysoce experimentalnim stavu!


Instalace
---------

Je vlastne velice jednoducha. Potrebujes k tomu stahnout aktualni verzi UberExport makra
a alespon jednu sadu ikonek. Momentalne je k mani jenom nase vlastni, tak jak nam zrovna
padla do oka, ale zatim nam vyhovuje. Je pravdepodobne, ze si na ty nase zluto modro cerveno
zelene krabicky nezvyknes a budes chtit mit v mape ikonky vlastni. No a proc ne? ;-)
Staci jenom Windows Paint a trocha trpelivosti...

Samotna instalace se sklada ze tri kroku.

1) Rozbaleni a instalace (nakopirovani) UberExport makra
--------------------------------------------------------

Spravne misto je typicky adresar Macros tam, kde je nainstalovany GSAK.
Muze to byt C:\GSAK, C:\Program Files\GSAK ...

2) Priprava docasneho adresare
------------------------------

Na tohle misto bude UberExport generovat pomerne veliky soubor ve formatu .gpx,
ktery bude pozdeji opracovan POILoaderem. Pomerne dulezita vec je, abys na tomto
miste byly tez nakopirovane ikonky. GPX soubor se na te totiz odkazuje a pokud
by je POILoader nenasel, urcite by se zlobil. Takze na nejakem rozumnem miste
udelej novy adresar a rozbal do nej ikonky z libovolneho iconpacku.

3) Konfigurace samotneho makra
------------------------------

Uvnitr zdrojaku neni treba menit nic. Pri spusteni ale vyskoci pomerne jednoduchy
dialog, ktery potrebuje vedet v zasade dve veci:
- Kde se nachazi adresar, kam bude generovat data
- Kde najde POILoader, ktery po vygenerovani GPX souboru automaticky pusti
  (a kdyz nenajde, nepusti ;-), ale tenhle krok je mozne udelat rucne)

- Zbytek neni potreba menit, typ GPS a podobne se k nicemu momentalne nepouziva.


Ficury
------

0.2.8 - 2011-02-16
- Pokud ma kes waypoint 'finalni souradnice', uz se dal neexportuje jeji parent waypoint.

0.2.7 - 2010-07-07
- Opravena chyba ve filtru jmen kesi s XMLoidnimi znaky

0.2.6 - 2010-06-03
- Drobna chyba - nedefinovane a zaroven disablovane body generovaly chybne .gpx

0.2.5 - 2009-09-11
- Kosmeticka uprava, do generovanych GPX se pridava verze makra, se kterymi bylo generovano

0.2.4 - 2009-09-04
- Do child descriptoru se omylem mohl dostat neplatny text, ktery mohl byt
  interpretovan jako XML tag. Omylem - kdyz si ho tam nekdo napsal ;-)
  Ale proc ne, chyba je na nasi strane.

0.2.3 - 2009-07-16
- Opravena zapomenuta inicializace databaze Archived kesi

0.2.2 - 2009-07-15 - (Pozor, zmeny v iconsetech!)
- Pridelane nove ikonky pro disabled finale locations
- Final child waypointy jsou nyni doplnene o listing a logy. Jde o to, ze clovek
  obcas prijde na vylustene finale a rad by se podival do listingu v pripade,
  ze treba nahodou nemuze najit, nebo je treba jeste nejaky dodatecny ukol.
  Hledani onoho master waypointu mysterky byva obcas zbytecne zdlouhave a tak
  jsem ty zaznamy proste zduplikoval pro snadnejsi nahled.
- Lehce jsem procistil kod toho makra, coz ale nemeni nic na tom, ze bych to
  nejradsi zahodil a napsal znova ;-)

0.2.1 (nepublikovano, drobne upravy)

0.2.0 (Pozor, zmeny v iconsetech!)
- Generator od ted respektuje ruzne Databaze POI, generuje jednotlive waypointy
  do samostatncyh databazi, ktere sice nakonec POIloader zase spoji do jednoho
  velkeho GPI, ale o databazich nadale "vi"... cili... je mozne behem hledani
  waypointu zvolit treba databazi "CITO", "Traditional", "Final Coordinates" a jine.
- Protoze je POILoader vybirava mrcha a ikonky k databazim prirazuje podle jmena
  .gpx archivu, prejmenoval jsem vsechny ikonky podle jmen databazi.
  Pokud delas upgrade, tak s klidnym srdcem stahni novy iconset, smahni puvodni
  bitmapky a vsechno nainstaluj nanovo. Jmena souboru se proste lisi....
- Pokud vlastnis Colorado, soucasna zmena se projevi vicemene jenom ve chvili,
  kdy v hlavnim menu zvolis polozku "Where to"..  "Hledat?" "Kam vest?" Dzis,
  ja vubec nevim, jak je to cesky prelozeny ;-) Dal ve slozce "Extras"...
  Kazdopadne v tomhle okamziku je mozny cvaknout na levy horni tlacitko 'options'
  a vybrat si ze seznamu databazi POI - to plati pro firmware 2.90. Trochu me stve,
  ze Colorado osekava jmena databazi POI - Takze misto "Traditional (disabled)" uvidis
  neco zkracenyho. Oregon to ukazuje presne jak se ma...
- Pokud jsi stastnym vlastnikem Oregonu, je to o malinko jednodussi,
  pri volbe "Where to?" a kategorii Extras se automaticky nabidne, jestli
  budes lovit napric vsemi databazemi, nebo v nejake konkretni, treba "Event",
  "Whereigo", "Parking waypoints"... etc.
- Diky separaci databazi a absenci odkazu kazdeho jednotliveho waypointu na
  individualni ikonku (zatimco ten odkaz je nadale u kazde databaze) se moje
  POI databaze zmensila ze 64MB na 60MB, pocitove je generovani nahledu
  mapy s POIkama v Garminu rychlejsi.. ale.. nemereno ;-)
 

0.1.10
- Final Location waypointy ten maji normalni kesoidni hlavicku, s typem containeru,
  teren, difficulty, info o poslednich nalezech, atd... + viditelne souradnice
- Malinko jsem vycistil obrabeni child waypointu, dela se mene stejnych nebo zbytecnych regexpu,
  kod se generuje v nativnim html, protoze se potom stejne znormalizuje tak, aby proste POIloaderem

0.1.9
- Pokud ma v GSAKu keska zapsany nejaky usernote, najdete ho od tehle verze
  v popisu kese hned za hintem, ktery je hned za zahlavim kese, namisto
  puvodniho prvniho 'logu'. To proto, ze se clovek v terenu obcas pokousi
  rychle nahlednout nejakou indicii, kterou si doma do GSAKu natlacil
  a scrollovat kvuli tomu pres celej listing je nekdy fakt na hlavu ;-)

0.1.8
- Bezpodminecne je presunut v popisu kese hint hnedle za uvodni zahlavi,
  hledani hintu u kesi s velmi dlouhym listingem snad uz ted nebude takove peklo.
  Uvodni dialog pri exportu na tuto funkci nema nejmensi vliv.

0.1.7
- Masivni zrychleni, kompatibilita s novym GSAKem (cela CR mi trva 6 minut)
- Nalezene kese uz nadale negeneruji child waypointy, takze se tolik neplni mapa
  nepodstatnyma vecma.
- Pokud je u kese zadane Final Location, found ikonka se placne misto nej a ne tam,
  kde byla kes puvodne placed. To aby bylo mozny kdykoliv rychle nahlidnout
  souradnice nalezene kese.

0.1.5
- Kese se exportujou vcetne svych child waypointu, kazdy ma prirazenou vlastni ikonku
- Kesoidni waypointy maji v rozsirenem popisu listing, vcetne hintu a nekolika poslednich logu.
- Jiz nalezene kese maji univerzalni 'smajlik' a neobsahuji listing kese (pouze obecnou hlavicku, hint a logy)
- Kazdy child waypoint ma u sebe v popisu navic svuj typ, souradnice a pokud byl autor listingu sikovny,
  tak i popis toho, co je u kazdeho waypointu treba delat nebo zjistit (description).
- Disabled kese maji pres svou ikonku cerveny krizek
- Casti listingu jsou barevne odlisene pro snadnejsi orientaci
- Final Coordinates child waypoint automaticky obsahuje hint v popisu, pro snadnejsi praci v terenu.
- ... a uz ani nevim :-)

Roadmap
-------
- Novy startup dialog, moznost volby ktere POI databaze vlastne maji/nemaji vzniknout.
- Tlacit a konvertit data do Colorada/Oregonu pres mnohem rychlejsi GPSBabel (nez pres POIloader)

- SciFi: vsechno prepsat do Perlu
- SciFi: odstranit problemy s diakritikou (rekodovat problematicke znakove sady do jine nekonfliktni)
- SciFi: dolatit kod tak, aby presne pokryval Garmini limity (co se delky ruznych retezcu tyce)
- SciFi: volitelne generovat ruzne kategorie POI
- SciFi: volitelne generovat parent waypointy jako plnohodnotne 'Caches' v gpx, aby je Colorado/Oregon
         mohly nativne nacitat, zpracovavat, logovat...
- SciFi: Misto konverze dat do .gpx a nasledne do .gpi rovnou generovat binarni .gpi a ten overhead usetrit.

Pouzivani
---------

Makro exportuje to, co mas prave v GSAKu pred ocima. Cili, co si vyfiltrujes, to tam mas ;-)
Pokud ti aktualni filtr vyhovuje, staci uz jenom to makro pusit. Pote, co se bude nejakou
tu chvilku generovat GPXko by se mel sam od sebe jeste pustit POILoader. Pokud se tak nestane,
je mozne ho pustit i rucne a navest ho na adresar s onim vygenerovanym souborem a hromadou ikonek.
FIXME: Po spusteni makra se objevi dialog, ktery vlastne slouzi jenom pro zadani cesty k
POILoaderu, vsechny ostatni volby jsou ignorovany (jako volba Colorado/Oregon) nebo umisteni
hintu v popisu kese.


Pro cache ownery
----------------

Makro samo o sobe svet nespasi, ale pokud vlastnis nejakou kes, muzes jit co do pouzitelnosti
jeho uzivatelum malinko naproti. Neni treba delat nic specialniho vylozene jenom pro tohle
makro, spis vyuzit naplno moznosti, ktere se nabizeji napriklad u child waypointu v listingu.
Vzhledem k tomu, ze data z pole 'Description' se zde k waypointum automaticky pridavaji,
je tim padem velice mile a pohodlne (pokud vlastnis napriklad Multi-Cache), kdyz napriklad
u kazde stage v Description uvedes, co se na ni ma resit, zjistovat, udelat. Kdyz si potom
clovek na tu stage v mape klikne, je hned jasny, co se ma delat. Hrabani se v listingu,
zvlast kdyz je patricne obsahly, neni uplne 2x prijemny ;-)


Limity
------

Jsou spis casoveho razu, generovani GPXka pomoci GSAKoidniho jazyka je pomerne
na dlouhe lokte. Presto ale na nasem 3GHz procesoru opracuju celou CR vcetne uploadu
do Colorada za cca 10 minut (6 minut export, zbytek POILoader). V soucasnosti je to
v mem podani neco kolem 20.000 waypointu. Vysledkem je ~70MB .GPI soubor pro Garmina.

Vsechy momentalne generovane informace jsou ciste POIky. Tudiz - nejde pouzit ficuru 'Found it'
ve vasem oblibenem pristroji.

Pokud jsou listingy extra dlouhe, nedopadne to dobre, respektive - budou zkraceny. Neda se svitit,
slo by je sikovne splitnout, ale nejak chybi lidi, kteri by se s tim GSAKoidnim makrojazykem
chteli patlat. A vzhledem k tomu, ze se s dlouhejma listingama stejne pracuje dost neprijemne
(dlouhe skrolovani, pomale reakce Garmina, atd..) Stejne je lepsi mit tyhle mega-listingy
nekde vytiskle, nebo v telefonu nebo v PDA. Ale jestli bude velkej zajem, treba se s tim
da neco udelat ;-)


Chyby
-----

Velka spousta - tenhle kod je neskutecnej bastl. Navic je makrojazyk GSAKu slusnej eklhaft,
takze se v tom nimram docela nerad. Pokud by nekdo mel naladu cokoliv vylepsit a bude mit
naladu se o zmeny podelit, necht to zkusi ;-)

(L) Petr.von.Shebi / Shebi Team

--
Tento script je Beerware.

Pokud ti prinasi uzitek a rikas si, "jo, to je celkem dobry makro!", bude mi cti,
pokud si spolu na nejakem eventu dame pivko. Neni to ale podminka k pouzivani ;-)
Pouzivat samozrejme smi i ti, kterym tohle makro pije krev...