user:skript:poigarminstatusicon
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
user:skript:poigarminstatusicon [2012/12/07 16:12] – [Základní nastavení] gord | user:skript:poigarminstatusicon [2019/06/13 20:18] (current) – mikrom | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | Plugin vytváří překryvné stavové ikony pro doplnění ikon keší v nových GPS firmy Garmin. V GPS je pak zobrazena ikona keše doplněná o zobrazení dalších informací podle přání uživatele. Dosavadní způsob, kterým uživatel generuje keše do GPS se nemění, ale tímto pluginem se doplňje o další export, který rozšíří informace | + | Plugin vytváří překryvné stavové ikony pro doplnění ikon keší v nových GPS firmy Garmin. V GPS je pak zobrazena ikona keše doplněná o zobrazení dalších informací podle přání uživatele. Dosavadní způsob, kterým uživatel generuje keše do GPS se nemění, ale tímto pluginem se doplňuje o další export, který rozšíří informace |
- | + | ||
- | :!: Prozatím je stránka jen pracovní, abych si nemusel mnoho věcí pamatovat nebo psát někde bokem. | + | |
+ | /* | ||
{{: | {{: | ||
+ | */ | ||
===== Autor ===== | ===== Autor ===== | ||
Line 11: | Line 10: | ||
* Thomas - inspirace, motivace, požádal mě o funkci podobnou té, kterou má GSAK | * Thomas - inspirace, motivace, požádal mě o funkci podobnou té, kterou má GSAK | ||
- | * Medwyn_cz - konzultace, nápady | + | * Medwyn_cz - konzultace, nápady, dokončení překladu do EN |
Pokud se Vám doplněk líbí, kliknutím na tlačítko **Donate** můžete přispět na jeho vývoj. | Pokud se Vám doplněk líbí, kliknutím na tlačítko **Donate** můžete přispět na jeho vývoj. | ||
Line 20: | Line 19: | ||
~~GEOGET_INSTALL~~ | ~~GEOGET_INSTALL~~ | ||
+ | /* | ||
===== Diskuze ===== | ===== Diskuze ===== | ||
- | /* V případě potřeby je možno tuto sekci vymazat a neuvádět ji. */ | + | Diskuze o tomto skriptu se nachází na stránkách [[http:// |
- | /* * Diskuze o tomto skriptu se nachází na stránkách [[http:// | + | */ |
+ | /* | ||
===== Popis ===== | ===== Popis ===== | ||
+ | */ | ||
==== Motivace ==== | ==== Motivace ==== | ||
Line 32: | Line 33: | ||
Jeden z uživatelů obou aplikací kontaktoval Medwyna a ten zase mě s tím, zda a jak by se dalo podobné funkce dosáhnout v **GeoGetu**. Výsledkem mnoha úvah a pak nějakého toho kódování je tento plugin. | Jeden z uživatelů obou aplikací kontaktoval Medwyna a ten zase mě s tím, zda a jak by se dalo podobné funkce dosáhnout v **GeoGetu**. Výsledkem mnoha úvah a pak nějakého toho kódování je tento plugin. | ||
- | ==== Ukázky | + | ==== Ukázky |
- | + | Po volbě **Kam vést** a **Moje POI** (přesné pojmenování položek menu záleží na překladu | |
- | Po volbě **Kam vést** a **Moje POI** (přesné pojmenování položek menu záleží na překladu) je v menu položka | + | |
{{: | {{: | ||
Line 43: | Line 43: | ||
==== Pojmy ==== | ==== Pojmy ==== | ||
- | {{: | + | Abychom se nějak domluvili a nedocházelo ke zmatkům, musíme se dohodnout na používání některých pojmů. |
^Pojem^Vysvětlení^ | ^Pojem^Vysvětlení^ | ||
- | ^Stavová ikona|jedná se o překryvnou ikonu, překreslovanou přes ikonu keše. Stavová ikona je složená z několika dílčích stavových ikon. Na obrázku je stavová ikona vše okolo ikony znázorňující mysterku.| | + | ^Stavová ikona|jedná se o překryvnou ikonu, překreslovanou přes ikonu keše. Stavová ikona je složená z několika dílčích stavových ikon. Vše okolo ikony keše se nazývá stavová ikona.| |
^Dílčí stavová ikona|je malý obrázek, který indikuje, že keš splňuje nějaké kritérium v určitém prvku. Na obrázku je 5 dílčích stavových ikon: samostatně každá ikonka po obvodu + zelené čáry po obvodu| | ^Dílčí stavová ikona|je malý obrázek, který indikuje, že keš splňuje nějaké kritérium v určitém prvku. Na obrázku je 5 dílčích stavových ikon: samostatně každá ikonka po obvodu + zelené čáry po obvodu| | ||
^Prvek|Prvek je nositelem informace o keši. Může se jednat o běžnou informaci jako je velikost, stav, terén, ale také o komplikovanější informaci jako např. hodnota tagu. Prvek je obvykle zobrazován na jednom místě stavové ikony a představuje jej jedna dílčí ikonka.| | ^Prvek|Prvek je nositelem informace o keši. Může se jednat o běžnou informaci jako je velikost, stav, terén, ale také o komplikovanější informaci jako např. hodnota tagu. Prvek je obvykle zobrazován na jednom místě stavové ikony a představuje jej jedna dílčí ikonka.| | ||
- | ^Kritérium|kritériem budeme rozumět nějakou formuli, kterou jde vyhodnotit do stavu // | + | ^Kritérium|kritériem budeme rozumět nějakou formuli, kterou jde vyhodnotit do stavu // |
^Hodnota|hodnota je součástí kritéria a upřesňuje vyhodnocení jeho platnosti. Hodnotou je číslovka, text nebo výběr jedné či více hodnot z nabízených možností (opět číselných nebo textových)| | ^Hodnota|hodnota je součástí kritéria a upřesňuje vyhodnocení jeho platnosti. Hodnotou je číslovka, text nebo výběr jedné či více hodnot z nabízených možností (opět číselných nebo textových)| | ||
+ | |||
+ | <WRAP round help> | ||
+ | **__Praktický příklad__**: | ||
+ | </ | ||
==== Obsah instalace ==== | ==== Obsah instalace ==== | ||
- | Součástí instalačního balíčku jsou kromě vlastních scriptů také | + | Součástí instalačního balíčku jsou kromě vlastních scriptů také: |
- | * ukázkové | + | * ukázková |
- | * ukázkové | + | * ukázková |
- | * sada ikon keší pro GPS (16 x 16 bodů) - použito pro ukázku při konfiguraci, | + | * sada ikon keší pro GPS (16x16 bodů) - použito pro ukázku při konfiguraci, |
- | * základní sada dílčích stavových ikonek, kterou si může | + | * základní sada dílčích stavových ikonek, kterou si může |
==== Funkce pluginu ==== | ==== Funkce pluginu ==== | ||
- | - V principu plní plugin pouze jedinou | + | - V principu plní plugin pouze jedinou |
- Ovšem aby bylo možné generovat výstup, je třeba pluginu nějak říct co, jak, kam. O tento úkol se stará nastavení pluginu. | - Ovšem aby bylo možné generovat výstup, je třeba pluginu nějak říct co, jak, kam. O tento úkol se stará nastavení pluginu. | ||
- | Protože plugin | + | Protože plugin |
- | V **GeoGetu** je více možností, jak dostat do GPS keše a jejich ikony. Pro použití výhod tohoto pluginu nemusí uživatel | + | V **GeoGetu** je více možností, jak dostat do GPS keše a jejich ikony. Pro použití výhod tohoto pluginu nemusí uživatel měnit své zvyky a postupy. Ikony keší vygeneruje tak, jak je zvyklý, a pak jen navíc spustí další export, kterým vygeneruje další sadu ikon s doplňujícími informacemi. Tento postup má zásadní výhody: |
* stávající postup zpracování exportu keší se nemění | * stávající postup zpracování exportu keší se nemění | ||
* nezáleží na tom, v jakém formátu a jakým způsobem uživatel generuje ikony keší (PQ, GPX nebo POI) | * nezáleží na tom, v jakém formátu a jakým způsobem uživatel generuje ikony keší (PQ, GPX nebo POI) | ||
* stavové ikony mohou být generovány nad jiným výběrem keší | * stavové ikony mohou být generovány nad jiným výběrem keší | ||
- | * je možné použít několik různých nastavení pro generování stavových ikon, kdaždé nastavení pro jinou množinu keší | + | * je možné použít několik různých nastavení pro generování stavových ikon, každé nastavení pro jinou množinu keší |
- | * v GPS je pod novou položkou v POI (Status Icons) možné vyhledávat mezi kešemi podle kritérií, podle nichž jsou generovány stavové ikony. Je tak možné vyhledat seznam keší s nastaveným TAGem //Výlet// nebo s terénem //5//, poznamenaným | + | * v GPS je pod novou položkou v POI (Status Icons) možné vyhledávat mezi kešemi podle kritérií, podle nichž jsou generovány stavové ikony. Je tak možné vyhledat seznam keší s nastaveným TAGem //Výlet// nebo s terénem //5//, poznamenaným |
==== Nastavení pluginu ==== | ==== Nastavení pluginu ==== | ||
- | K nastavení | + | Nastavení |
* INI soubor s definicí pravidel pro export | * INI soubor s definicí pravidel pro export | ||
* zapnutí expertního režimu formuláře pro definici pravidel exportu stavových keší | * zapnutí expertního režimu formuláře pro definici pravidel exportu stavových keší | ||
- | |||
- | /* * příznak, zda stavová ikona má být generována včetně ikony keše (implicitně je bez ní, předpokládá se, že ikona keše je v GPS zobrazena z exportu keší) */ | ||
==== Nastavení exportu ==== | ==== Nastavení exportu ==== | ||
Export stavových ikon je to hlavní, oč tu běží. Protože jsem zastáncem toho, že každý uživatel má jiné potřeby, v kterých bych jej neměl omezovat, nebudu mu předepisovat konkrétní hodnoty, při kterých ponese stavová ikona nějakou informaci, a výběr nechám na něm. | Export stavových ikon je to hlavní, oč tu běží. Protože jsem zastáncem toho, že každý uživatel má jiné potřeby, v kterých bych jej neměl omezovat, nebudu mu předepisovat konkrétní hodnoty, při kterých ponese stavová ikona nějakou informaci, a výběr nechám na něm. | ||
- | Pochopitelně, | + | Pochopitelně, |
- | Všechno nastavení exportu je uloženo ve textovém INI souboru a plugin, kterým se nastavení provádí, při svém spustění nechá uživatele vybrat, s kterým souborem se má pracovat. Jakmile si uživatel vybere soubor, plugin zobrazí v něm zapsané nastavení. | + | **Všechno nastavení exportu je uloženo ve textovém INI souboru a plugin, kterým se nastavení provádí, při svém spuštění nechá uživatele vybrat, s kterým souborem se má pracovat. Jakmile si uživatel vybere soubor, plugin zobrazí v něm zapsané nastavení.** |
- | :!: Plugin pro nastavení pracuje se seznamem keší, které byly označeny před spuštěním pluginu. Na těchto keších je možné zkoušet, jak bude vypadat výsledná stavová ikona. Keš je možné kdykoli změnit výběrem z načteného seznamu nebo je také možné zapsat přímo GC kód požadované keše (v tom případě není nutné, aby byla před spuštěním pluginu označena). | + | <WRAP round info> |
+ | Plugin pro nastavení pracuje se seznamem keší, které byly označeny před spuštěním pluginu. Na těchto keších je možné zkoušet, jak bude vypadat výsledná stavová ikona. Keš je možné kdykoli změnit výběrem z načteného seznamu nebo je také možné zapsat přímo GC kód požadované keše (v tom případě není nutné, aby byla před spuštěním pluginu označena). | ||
+ | </ | ||
Nastavení pro generování stavových ikon má dvě úrovně: | Nastavení pro generování stavových ikon má dvě úrovně: | ||
Line 96: | Line 100: | ||
==== Základní nastavení ==== | ==== Základní nastavení ==== | ||
- | |||
{{: | {{: | ||
* Adresář s ikonami stavu slouží jako zdroj dílčích stavových ikon pro vytvoření celkové stavové ikony | * Adresář s ikonami stavu slouží jako zdroj dílčích stavových ikon pro vytvoření celkové stavové ikony | ||
* **Velikost** ikony je nutné dodržet v maximální velikosti 24 x 24 bodů, jinak nebude v GPS zobrazena. | * **Velikost** ikony je nutné dodržet v maximální velikosti 24 x 24 bodů, jinak nebude v GPS zobrazena. | ||
- | * **Posun** určuje polohu, na kterou se bude vykreslovat stavová ikona. (Podrobnější informace uvádí nápověda dostupná přes ikonku otazníku | + | * **Posun** určuje polohu, na kterou se bude vykreslovat stavová ikona. (Podrobnější informace uvádí nápověda dostupná přes ikonku otazníku |
- | * **Seznam prvků** - seznam všech prvků pro zapnutí nebo vypnutí každého prvku jako celku. Při vypnutí prvku jsou všechna jeho kritéria vždy ve stavu **nesplněno** a dílčí stavová ikonka nebude použita. Prvek se povoluje kliknutím na // | + | * **Seznam prvků** - seznam všech prvků pro zapnutí nebo vypnutí každého prvku jako celku. Při vypnutí prvku jsou všechna jeho kritéria vždy ve stavu **nesplněno** a dílčí stavová ikonka nebude použita. Prvek se povoluje kliknutím na // |
- | * Adresář s ikonami keší slouží jen ke zobrazení náhledu. Do GPS se exportuje stavová ikona bez ikony keše. | + | * Adresář s ikonami keší slouží jen k zobrazení náhledu. |
* Seznam keší, které byly označeny před spuštěním pluginu. Náhled stavové ikony je kombinován s právě vybranou keší z této skupiny. | * Seznam keší, které byly označeny před spuštěním pluginu. Náhled stavové ikony je kombinován s právě vybranou keší z této skupiny. | ||
Line 109: | Line 112: | ||
Ve stavové ikoně je možné použít následující prvky: | Ve stavové ikoně je možné použít následující prvky: | ||
- | * **Koordinované souřadnice** - v případě, že u keše jsou vypočtené finálové souřadnice, | + | * **Koordinované souřadnice** - v případě, že u keše jsou vypočtené finálové souřadnice |
* **Stav keše** - dílčí ikona bude vygenerována v případě, že keš je v jednom z vybraných stav\\ // | * **Stav keše** - dílčí ikona bude vygenerována v případě, že keš je v jednom z vybraných stav\\ // | ||
- | * **Velikost keše** - dílčí ikona informuje o velikosti keše (jednom | + | * **Velikost keše** - dílčí ikona informuje o velikosti keše (jedné |
- | * **Obtížnost keše** - dílčí ikona informuje o obtížnosti keše (jednom | + | * **Obtížnost keše** - dílčí ikona informuje o obtížnosti keše (jedné |
- | * **Terén keše** - dílčí ikona informuje o terénu keše (jednom či více vybraných)\\ // | + | * **Terén keše** - dílčí ikona informuje o terénu keše (jednom či více vybranými)\\ // |
- | * **Významné logy mezi posledními** - dílčí ikona informuje o tom, že u keše je mezi X podledními | + | * **Významné logy mezi posledními** - dílčí ikona informuje o tom, že u keše je mezi X posledními |
* **Významné logy vybraných uživatelů** - dílčí ikona informuje o tom, že zadaný uživatel má u keše některý z vybraných logů. // | * **Významné logy vybraných uživatelů** - dílčí ikona informuje o tom, že zadaný uživatel má u keše některý z vybraných logů. // | ||
- | * **Moje DNF** - tento prvek je zúženou variantou předchozího s tím, že uživatelem je vždy uživatel GeoGetu, musí se jednat o DNF log a keš dosud není uživatlem | + | * **Moje DNF** - tento prvek je zúženou variantou předchozího s tím, že uživatelem je vždy uživatel GeoGetu, musí se jednat o DNF log a keš dosud není uživatelem |
- | * **Keš má některý z atributů** - seznam atributů, z kterých si uživatel vybírá je načten z aktuální databáze, proto není možné vybrat atribut, který v databázi není\\ // | + | * **Keš má některý z atributů** - seznam atributů, z kterých si uživatel vybírá, je načten z aktuální databáze, proto není možné vybrat atribut, který v databázi není\\ // |
- | * **Keš obsahuje TAG zadané kategorie (případně i hodnoty)** - uživatel | + | * **Keš obsahuje TAG zadané kategorie (případně i hodnoty)** - uživatel |
- | * **Favoritní body** - jsou speciálním případem předchozího prvku, kterou je vybraná kategorie // | + | * **Favoritní body** - jsou speciálním případem předchozího prvku, kterou je vybraná kategorie // |
- | * **Listing obsahuje regulární výraz** - plugin testuje, zda zadaný výraz | + | * **Listing obsahuje regulární výraz** - plugin testuje, zda je zadaný výraz obsažen v listingu keše (viz nápověda pro zadání hodnoty dostupná přes ikonu v pluginu)\\ // |
- | * **Komentář obsahuje regulární výraz** - plugin testuje, zda zadaný výraz | + | * **Komentář obsahuje regulární výraz** - plugin testuje, zda je zadaný výraz obsažen v uživatelském komentáři keše (viz nápověda pro zadání hodnoty dostupná přes ikonu v pluginu)\\ // |
- | * **Upozornění na přiblížení ke keši** - tento prvek negeneruje žádnou | + | * **Upozornění na přiblížení ke keši** - tento prvek negeneruje žádnou |
- | ==== Připravené stavové ikonky ==== | ||
- | Součástí instalace jsou předpřipravené ikonky, které mohou být využity pro indikaci stavu některého z prvků. Všechny soubory s ikonami mají jednotný tvar jména, aby bylo snadnější se v nich orientovat a vybrat tu vhodnou ikonu. Jméno souboru s ikonkou má tvar: | ||
- | |||
- | ''< | ||
- | |||
- | * **obrazec** popisuje vlastní ikonku, její tvar | ||
- | * **barva** je písmeno barvy, kterou ke obrazec vykreslen | ||
- | * **barva pozadí** je písmeno barvy pozadí. Pokud není písmeno uvedeno, je pozadí průhledné (nebo má barvu #FF00FF, která je jako průhledná interpretovaná) | ||
- | * **rozměr** uvádí velikost ikonky, aby byla nějaká představa o tom, kolik místa zabere a jak a kam je možné ji umístnit | ||
==== Podrobné nastavení ==== | ==== Podrobné nastavení ==== | ||
- | |||
{{: | {{: | ||
- | Podrobné nastavení připadá v úvahu při povoleném prvku a definuje jednotlivá kritéria, která říkají za jakých podmínek a kam bude zobrazena dílčí stavová ikona. Podrobné nastavení se mění v samostatné části formuláře, | + | Podrobné nastavení připadá v úvahu při povoleném prvku a definuje jednotlivá kritéria, která říkají, za jakých podmínek a kam bude zobrazena dílčí stavová ikona. Podrobné nastavení se mění v samostatné části formuláře, |
=== Kritéria === | === Kritéria === | ||
- | **Kritéria** se u vyhodnocují sestupně od prvního uvedeného po poslední. U některých prvků se vyhodnocují všechna | + | **Kritéria** se vyhodnocují sestupně od prvního uvedeného po poslední. U některých prvků se vyhodnocují všechna |
- | Zatímco seznam prvků je taxativně daný a nelze jej bez zásahu do pluginu měnit, seznam kritérií je prakticky neomezený a uživatel si může | + | Zatímco seznam prvků je taxativně |
Každé kritérium definuje: | Každé kritérium definuje: | ||
Line 150: | Line 143: | ||
* **jméno kategorie**; | * **jméno kategorie**; | ||
* jméno souboru s dílčí stavovou **ikonkou** | * jméno souboru s dílčí stavovou **ikonkou** | ||
+ | |||
+ | ==== Připravené stavové ikonky ==== | ||
+ | Součástí instalace jsou předpřipravené ikonky, které mohou být využity pro indikaci stavu některého z prvků. Všechny soubory s ikonami mají jednotný tvar jména, aby bylo snadnější se v nich orientovat a vybrat vhodnou ikonu. Jméno souboru s ikonkou má tvar: | ||
+ | |||
+ | ''< | ||
+ | |||
+ | * **obrazec** popisuje vlastní ikonku, její tvar | ||
+ | * **barva** je písmeno barvy, kterou je obrazec vykreslen | ||
+ | * **barva pozadí** je písmeno barvy pozadí. Pokud není písmeno uvedeno, je pozadí průhledné (nebo má barvu #FF00FF, která je jako průhledná interpretovaná) | ||
+ | * **rozměr** uvádí velikost ikonky, aby byla nějaká představa o tom, kolik místa zabere a jak a kam je možné ji umístit | ||
===== Instalace ===== | ===== Instalace ===== | ||
- | Za normálních podmínek by uživatel vůbec neměl mít potřebu instalovat tento plugin jinak než automatickou instalací | + | Za normálních podmínek by uživatel vůbec neměl mít potřebu instalovat tento plugin jinak než automatickou instalací |
===== Poznámky, známé problémy ===== | ===== Poznámky, známé problémy ===== | ||
- | |||
* velikost stavové ikony je omezena na 24 x 24 bodů, s většími ikonami nedokáže GPS pracovat | * velikost stavové ikony je omezena na 24 x 24 bodů, s většími ikonami nedokáže GPS pracovat | ||
- | * :!: pokud do levého spodního rohu vyjde ve stavové ikoně nějaká | + | * <WRAP round info> |
+ | pokud do levého spodního rohu vyjde ve stavové ikoně nějaká | ||
+ | </ | ||
=== GPS - upozornění na rychlost a vzdálenost === | === GPS - upozornění na rychlost a vzdálenost === | ||
- | POILoader v automatickém režimu vezme první číslovku | + | POILoader v automatickém režimu vezme první číslo ze jména zpracovávaného souboru |
+ | * přepnout POILoader do manuálního nastavení vlastností každého importovaného souboru | ||
+ | * nepoužívat ve jménech číslice, což zase může trochu znepříjemnit orientaci v kategoriích POI v GPS | ||
+ | |||
+ | Toto je důvod, proč v ukázkových INI souborech jsou číselné hodnoty v kategoriích obtížnosti a terénu nahrazeny písmeny (**1=A, 1.5=AA, 2=B, 2.5=BB, ...**). | ||
+ | |||
+ | /* | ||
===== Zbývá doplnit ===== | ===== Zbývá doplnit ===== | ||
+ | */ | ||
+ | |||
===== Stažení ===== | ===== Stažení ===== | ||
- | /* Povinná sekce */ | + | <WRAP round download> |
- | <box round 95% #DEE7EC> | + | Stáhnout aktuální verzi: ~~DOWNLOAD poigarminstatusicon-*.gip highest~~ |
- | :!: Stáhnout aktuální verzi: ~~DOWNLOAD poigarminstatusicon-*.gip highest~~ | + | </WRAP> |
- | </box> | + | |
==== Seznam dostupných verzí ==== | ==== Seznam dostupných verzí ==== | ||
- | /* Povinná sekce */ | ||
{{filelist> | {{filelist> | ||
===== Seznam změn ===== | ===== Seznam změn ===== | ||
- | === 0.0.3beta () === | + | ** 1.0.2 (6.1.2014) **=== |
+ | * úprava pro nový GeoGet | ||
- | /* Pokud je seznam změn již moc dlouhý */ | ||
<hidden onHidden=": | <hidden onHidden=": | ||
+ | ** 1.0.1 (28.2.2013, staženo 127x) ** | ||
+ | * oprava: mazání výstupního adresáře až po vytvoření podadresáře Status Icons, maže se jen ten vytvořený | ||
+ | * oprava: ukládání konfigurace pro některá kritéria | ||
+ | * oprava: při směru umístění ikony stavu na sever od ikony keše se ignorovala vzdálenost | ||
+ | * změna: ikony zaškrtávátka (výběr prvku) | ||
+ | * změna: Busy při zpracování kritérií obsahuje i pořadí/ | ||
+ | |||
+ | ** 1.0.0 (18.1.2013, staženo 114x) ** | ||
+ | * první veřejná verze | ||
</ | </ | ||
- | /* Seznam tagů. Tagy můžete stránce přidělit buď ručně na následující řádce, nebo pomocí zatržítek v zápatí editačního okna */ | ||
{{tag> | {{tag> |
user/skript/poigarminstatusicon.1354893151.txt.gz · Last modified: 2012/12/07 00:00 (external edit)