Spoiler

U některých keší je místo textové nápovědy použita fotografie s nápovědou k uložení keše (spoiler). 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. Z turistických navigací tuto funkci podporují příklad Oregon a Dakota.

Od verze 1.2.1.7 pracuje plugin ve dvou režimech (viz konfigurační parametr STYLE).

Plugin přípraví GPX a další potřebné soubory pro program POILoader, pomocí něhož jsou pak spoilery uloženy do GPS. Zpracovány budou jen obrázky uložené na serveru geocaching.com, obrázky z jiných serverů jsou ignorovány.

Druhou možností, která pracuje jen s novými turistickými GPS filrmy Garmin s novým firmwarem, je funkce Geocaching with Photos. Funkce vytváří adresářovou strukturu s připravenými obrázky tak, aby bylo možné celou strukturu zkopírovat přímo do GPS nebo na paměťovou kartu a pak jsou dostupné při zobrazení listingu příslušné keše.

Plugin pracuje nad seznamem keší zobrazených v hlavním okně Geogetu. Pro každou keš v tomto seznamu provádí následující činnosti:

1. kotroluje zdroj posledního importu, pokud import neobsahuje informace o obrázcích připojených k listingu, importuje listing znovu. K importu je používán plugin Geojarry, proto musí být Geojarry správně nainstalován
2. automaticky importuje také listingy keší, které jsou starší než X dnů (volitelné)
3. pro každý obrázek v listingu, který odkazuje na soubor uložený na geocaching.com, kontroluje jeho jméno, zda obsahuje jeden z předepsaných vzorů, případně zda vyhovuje některému regulárnímu výrazu a pokud ano, považuje obrázek za spoiler
4. zkontroluje, zda spoiler již existuje v cache, pokud ano, rovnou jej zkopíruje do adresáře pro POILoader
5. pokud ne, zkontroluje, zda spoiler již existuje v offline adresáři (dříve stažený obrázek) nebo v offline adresáři GeoGetu (obrázek stažený při zobrazení listingu keše v GeoGetu) a pokud nikde není, stáhne jej ze serveru
6. zkontroluje, zda stažený obrázek má svou kopii v adresáři s transformovanými obrázky - při kontorle se bere v úvahu i nastavení stransformace (cílová velikost obrázku, zachování poměru stran a automatické natáčení obrázku). Pokud stažený obrázek kopii nemá, plugin jej zmenší a otočí tak (podle nastavení)
7. transformovaný obrázek uloží do adresáře pro POILoader nebo do adresáře pro funkci Geocaching with Photos
8. pro každý spoiler vytvoří POI bod umístěný v blízkosti keše nebo vypočtené finálové souřadnice (pokud je spoilerů více, jsou na mapě rozloženy okolo keše nebo vypočteného finálového bodu)
9. pro POILoader vytvoří GPX soubor, který obsahuje všechny vytvořené body

Po nahrání POI bodů do GPS je možné se ke spoilerům dostat dvěma způsoby:

1. na mapě je u ikony keše nebo finálové souřednice zobrazena ikona (ikony) spoileru, přes kterou je možné spoiler zobrazit
2. mezi vlastními POI přibude kategorie Spoiler, v které je možné vyhledávat, najít a zobrazit požadovaný spoiler stejně jako kterýkoli jiný POI bod

Pokud je využívána funkce Geocaching with Photos, je třeba keše exportovat do GPS jako GPX (nikoli jako POI) a pluginem vytvořenou strukturu zkopírovat tak jak je do kořenového adresáře GPS nebo paměťové kerty.

---

Instalaci obstará automatická instalace na stránce pluginu. Při ruční instalaci je třeba obsah zazipovaného souboru rozbalit do datového adresáře geogetu (tzv. DATADIR) podadresáře script. Pak už zbývá jen projít a nastavit potřebné hodnoty v konfiguračních souborech. Vhodné je využít k tomu menu Pluginy - Správce pluginů - Konfigurace pluginů v souborech groundspeek a Spoiler.

Pomocí konstant v souboru Spoiler.config.pas je možné bohatě konfigurovat činnost pluginu. Důrazně doporučuji si nastavení projít ještě před prvním spustěním. Následující tabulka uvádí vysvětlení k jednotlivým konstantám v souboru Spoiler.config.pas.

Hodnoty v souboru - obecně

• všechny hodnoty za = jsou uzavřeny v uvozovkách
• všechny cesty mohou být zadány absolutně nebo relativně. Relativní cesty jsou vůči datovému adresáři GoeGetu (tzv. DATADIR)
• vodnoty pro vypnutí nebo zapnutí funkce jsou '0' resp. '1'

SILENT	vypíná nebo zapíná tichý režim. V tichém režimu jsou potlačena všechna hlášení včetně chybových a je užitečný zejména pro spolupráci s pluginem Combine
STYLE	řídí způsob přípravy dat s obrázky. Možnosti jsou POI (příprava dat pro program POILoader) IMG (příprava dat pro funkci Geocaching with Photos) ATTACH (obrázky budou uloženy jako přílohy ke keši v adresáři DATADIR\attach\<poslední pismeno ID keše>\<ID keše>\Spoilers
DOWNLOAD	definuje způsob, kterým bude plugin stahovat potřebná data ze serveru GC.com. //GCLive// má pro BM uživatele nevýhodu v restrikcích, //Geojarry// je výrazně pomalejší
DIR_IMG	počáteční adresář pro přípravu obrázků pro funkci Geocaching with Photos.
CLEAR_OFFLINE_BEFORE	přikazuje pluginu vymazat "svůj" offline adresář před zahájením činnosti
CLEAR_OFFLINE_AFTER	přikazuje pluginu vymazat "svůj" offline adresář po ukončení činnosti
CLEAR_TRANSFORM_BEFORE	přikazuje pluginu vymazat adresář pro transformované obázky před zahájením činnosti
CLEAR_TRANSFORM_AFTER	přikazuje pluginu vymazat adresář pro transformované obázky po ukončení činnosti
Výsledky pro POILoader
DIR_SPOILER	počáteční adresář zadávaný v POILoaderu. V tomto adresáři bude vytvořena struktura souborů a adresářů potřebných pro úspěšný import spoilerů do GPS ve formátu POI. Upozorňuji, že implicitní nastavení směřuje do datového adresáře GeoGetu.
FILE_EXPORT	jméno GPX souboru (včetně přípony), který bude obsahovat jednotlivé spoilery. Jméno souboru je současně jménem, kterým je označena položka v podmenu POI v GPS. Soubor je vytvářen v DIR_SPOILER
FILE_ICON	cesta a jméno souboru s ikonou, která bude zobrazena na mapě poblíž keše. Kliknutím na tuto ikonu je možné se přímo z mapy dostat pohodlně ke spoileru.
Aktualizace listingu keší a obrázků
LISTING_IMPORT	hodnota určuje způsob kontroly aktuálnosti listingu keše v databázi: NoTag pokud v databázi není žádný TAG s informacemi o obrázku , bude listing importován znovu. Tedy neimportuje keše, které již mají nastaven TAG s informacemi o obrázku. Yes listing bude importován vždy znovu bez ohledu na zdrojový formát importovaného listingu No zdrojový formát importovaného listingu nebude vůbec kontrolován a toto nebude příčina nového importu listingu
LISTING_OLDER	přikazuje pluginu aktualizovat (znovu importovat) listingy keší, které byly aktualizovány před více než X dny. Hodnota 0 tuto kontrolu potlačuje.
USE_GG_OFFLINE	Hodnota 1 znamená, že plugin bude hledat dříve uložené spoilery i mezi obrázky v offline adresáři GeoGetu (z prohlížení listingu příslušné keše) - pozor na změnu kvality při prohlížení. Pokud tam bude spoiler nalezen, nebude se stahovat z webu. Hodnota 0 tuto kontrolu potlačuje a znaméná, že obrázky budou vždy stáhnuty z webu.
IMG_RELOAD	přikazuje načíst vždy obrázky z webu znovu
Rozeznávání spoilerů podle jména
REGEXP	zapíná (hodnota 1) nebo vypíná (hodnota 0) použití regulárních výrazů. Při zapnutém použití regulárních výrazů se předpokládá, že SPOILER_PATTERN obsahuje regulární výrazy, v opačném případě obsahuje texty pro hledání jako podřetěz. Vzory jsou vždy aplikovány na jméno obrázku a pokud je ve jméně příslušným algoritmem vzor nalezen, bude obrázek považován za spoiler.
SPOILER_PATTERN	Hodnota obsahuje seznam vzorů nebo regulárních výrazů použitých pro hledání spoilerů mezi jmény obrázků v listingu. Jednotlivé vzory jsou odděleny od sebe čárkou. Vyhodnocování probíhá bez ohledu na velikost písmen a diakritiku. Pozor, pokud jsou vzory chápány jako regulární výrazy, musejí tak také být zapsány. Používá se perlový formát zápisu regulárních výrazů. Hodnota * znamená všechny obrázky, které jsou k dispozici.
Vlastnosti GPX a obrázků pro GPS
IMG_WIDTH	sířka obrázku pro GPS
IMG_HEIGHT	výška obrázku pro GPS
IMG_AUROTOTATE	zapíná automatické otáčení obrázku tak, aby jeho vetší rozměr byl na větší straně disleje>
IMG_USE_RATIO	při transformaci obrázku pro displej zachová stejný poměr šířky a výšky jako má originální obrázk
POI_DISTANCE	udává vzdálenost nově vytvořeného POI bodu od uvodních souřadnic [m]
POI_AZIMUT	krok azimutu pro vytvoření POI bodu
POSITION_CORRECTED	zapíná použití korigovaných souřednic, ke kterým bude vytvořený bod umístěn. Korigované souřadnice jsou souřadnice vypočteného finalového bodu keše.
INCLUDE_HINT	k obrázku bude doplněn text s hintem
INCLUDE_IDTAG	k obrázku bude doplněna sdružená zjednodušená informace o vlastnostech keše (TM22)