Plugin pro export obrázků s nápovědou (spoilerů) do GPX pro POILoader pro GPS, které podporují zobrazení obrázků v popisu POI (Oregon, Dakota, …). Zejména v zahraničí je spoilerů hojně využíváno buďto jako doplňku k textové nápovědě (hintu) nebo samostatně (hint není uveden vůbec).

Plugin to export images with help (spoilers) into GPX for POILoader for GPS, which support the display of images in the description of the POI (Oregon, Dakota, …). Especially in foreign countries spoilers widely used either as a complement to text help (hint) or separately (hint not listed at all).

Pokud se Vám doplněk líbí, kliknutím na tlačítko Donate můžete přispět na jeho vývoj.

Nekamarádíte se s PayPalem? Napište mi email a domluvíme se na jiném způsobu, třeba převodu na účet.

• Diskuze o tomto skriptu je k dispozici na Geocaching.cz.

Plugin exportuje obrázky v jednom z následujících režimů/formátů:

• POI - vytvoří adresář s GPX soubory a obrázky. Z tohoto adresáře pak uživatel vygeneruje tzv. POI soubor (*.gpi) do GPS
• IMC - zapisuje obrázky přímo do databáze *.imc, kterou používá Geoget nebo program a:Drake v chytrém telefonu. Aplikace pak mohou zobrazovat obrázky i bez připojení k internetu
• IMG - vytváří ve výstupním adresáři strukturu podadresářů, kde je pro každou kešku sada obrázků. Tento adresář je pak možno zkopírovat do GPS pro použití v režimu Geocaching with Photos, který podporují novější GPS (od Garmin Oregon 450 výš). Aby GPS zobrazovala obrázky, je třeba keše, ke kterým jsou tímto pluginem obrázky připraveny, náhrávat jako GPS, nikoli jako POI . Rovněž by adresář mohl být zkopírován např. do chytrého telefonu pro použití programem Locus
• ATTACH - doplňuje do adresáře DATADIR\attach adresářovou strukturu pro jednotlivé keše tak, že obrázka jsou k dispozici jako přílohy ke keši (např. v offline exportu). Také toho mohou využít programy, které pracují s přílohami. Pro GPS tento režim nemá použití.

Vlastní plugin je možné spouštět dvěma způsoby:

• přímo - pokud je plugin spuštěn sám o sobě, zobrazí formulař, v kterém je možné změnit nastavení a případně jej uložit. Změněné nastavení (i bez uložení do souboru ) je pak použito pro vlastní export
• nepřímo - pokud je plugin spuštěn z jiného pluginu (např. dávky pro Combine), formulář zobrazen není a nastavení je přečteno ze soubor Spoiler.config.pas.

Uložením různých nastavení pluginu je možné zajistit různé chovaní exportu při automatizaci. Jen je nutné si uvědomit, že před spuštěním vlastního exportu je potřeba zkopírovat požadované nastavení do souboru Spoiler.config.pas.

U některých keší je místo textové nápovědy použita fotografie s nápovědou k uložení keše. Pomocí tohoto pluginu můžete, pokud to Vaše GPS podporuje, tyto obrázky uložit do GPS a mít je v případě potřeby k dispozici. Tento plugin zajišťuje následující funkce:

• výběr obrázků podle klíčových slov
• příprava obrázků pro GPS (stažení z webu, optimalizace velikosti a natočení)
• vytvoření adresáře s obrázky a GPX bodů tak, aby byly jejich ikony zobrazeny na mapě poblíž keše a přímo z mapy nebo přes menu POI bylo možné zobrazit jejich popis s příslušným obrázkem

Uživatel pak vytvořený adresář zpracuje pomocí programu POILoader, čímž přenese připravená data do GPS. Nebo programem gpigen vytvoříte z adresáře *.gpi soubor, který zkopírujete do adresáře \Garmi\POI ve vaší GPS. Program gpigen je výrazně rychlejší a není tak citlivý na zdrojová data.

• pomocí filtrů, ručním výběrem a mazáním, … nebo rozmanitou kombinací či dokonce pomocí Combine si zobrazíme seznam keší, které nás zajímají
• spustíme plugin Spoiler, tím se vygeneruje celý adresář (zadaný v konfiguraci pluginu), jehož obsahem bude GPX soubor a řada obrázků
• spustíme POILoader a jako zdrojový adresář mu zadáme adresář vytvořený pluginem
• pokud necháme POILoader uložit vytvořený soubor přímo do GPS, pak tím naše práce končí. Pokud bychom si jej uložili někam na disk počítače, musíme jej ještě překopírovat do GPS do adresáře \Garmin\POI

V GPS pak v menu s vlastními POI (závisí na použitém překladu) najdete menu odpovídající vytvořenému souboru. Zobrazením podrobností o bodu se dostanete k obrázku. Velikost zobrazeného obrázku nejde nijak ovlivnit, je to věc GPS.

Pochopitelně jsou také místa, pro které je vytvořen POI s obrázkem, vidět na mapě. V tom případě ale závisí na měřítku, při kterém máte povoleno zobrazování ikonek v těchto místech na mapě. Implicitní měřítko je 80 metrů a podrobnější. Zapíchnutím špendlíku do ikonky a zobrazením podrobností se opět dostanete k obrázku.

Součástí instalace je vizualizační skript, který v hlavním okně Geogetu ikonkou indikuje existenci spoileru. Skript musí být nastaven v konfiguraci sloupců na sloupec typu Vlastní a může zobrazovat 3 stavy (viz. 6. sloupec v ukazkovém obrázku):

Aby skript při kontroluje jména obrázků poznal, který z nich lze považovat za spoiler, je mu potřeba říct, jaká slova nebo části slov spoiler indikují. To lze udělat pomocí standardního nástroje pro nastavení skriptu SpoilerGgv. Proměnná SPOILER_PATTREN obsahuje seznam slov oddělená čárkami. Při testování se nebere ohled na velikost písmen ani na diakritiku.

Nastavení této proměnné nesouvisí se stejně pojmenovanou proměnnou exportního skriptu Spoiler, ale je vhodné, aby byly obě proměnné v souladu. V opačném případě může vzniknout nejasnost v tom, proč je nebo není některý obrázek exportován v rozporu s tím, co hlásí vizualizační skript.

Do publikace verze s vizualizačním skriptem, nabízím vizualizační sktipt samostatně v zip souboru.

Oregon 300 - obrázek je vždy zmenšený, aby se celý vešel na stránku se jménem bodu, to je vlastnost (chybná?) navigací řady Oregon:

Dakota 20 - obrázek je ve správné velikosti a lze jim posouvat:

Zumo 550 - nejen turistické navigace umějí zobrazit fotospoiler:

Použití funkce Geocaching with Photos:

Popis nastavení a konfigurace je uveden v HTML dokumentaci, která je součástí instalace.

• na GPS Garmin řady Oregon jsou spoilery zobrazovány vždy tak, aby se celý obrázek zobrazil na první straně “listingu” - bez ohledu na nastavenou velikost po transformaci tedy dojde při jeho zobrazení k dalšímu zmenšení, které není možné žádným způsobem ovlivnit (GPS si dělá co chce). Zajímavé je, že řada Dakota zobrazí spoiler v nastavené velikosti tak, že obrázkem jde posouvat a nedochází k jeho dalšímu zmenšení. Uvedené chování je demonstrováno v ukázkách výše
• občas někdo hlásí (většinou majitelé GPS Dakota), že v popisu POI v GPS nemá obrázek spoileru zobrazený. Příčina zatím není odhalena, ale zdá se, že je někde problém ve spolupráci s POILoaderem. Často pomůže, když gpx soubor je ve vnořeném adresáři a POILoader zpracovává nadřízený adresář. Občas někomu pomůže přepnutí POILOaderu do manuálního režimu, … V každém případě je obrázek součástí vytvořeného *.poi souboru, ale někdy GPS obrázek prostě nezobrazuje. Diskuse na podobné téma je v tomto vlákně.
• při stahování dat přes GCLive (API), je nutné stahovat plný listing, protože seznam obrázků v přehledu není
• vizualizační skript zpomaluje zobrazování seznamu keší. Při krátkém seznamu je to celkem nepatrný rozdíl, ale pokud si pravidelně zobrazujete třeba při startu Geogetu seznam s několika tisíci body, může zpomalení být třeba 10 sekund nebo i více

1.3.13 (18.9.2015)

• oprava mnoha chyb, které se vloudily do předchozí verze

1.3.12 (10.9.2015, staženo 161x)

• doplněn vizualizační skript pro indikaci spoileru v seznamu keší
• doplněn konfigurační formulář, při samostatném spuštění je možné změnit a uložit nastevení
• možnost ukládat obrázky do *.imc databáze
• změněn parametr PATTERN na PATTERN_REXREC a PATTERN_SUBSTR
• (změna uložení info o obrázku z pole do struktury)