SnailMap uživatelská dokumentace
- 1 / 21 -
Verze:
2.2
Autor: Web: Vydáno:
Martin Hykl swsoft.wz.cz 20. 9. 2010
0 1
Obsah Motivace 1.1 1.2 1.3 1.4
2
Co všechno program umí Co všechno program neumí Licence Co se dozvíte v tomto dokumentu
Instalace 2.1
Linux 2.1.1 2.1.2
3
Spuštění programu 3.1 3.2 3.3
Poznejte program Problémy při spuštění Dialogy 3.3.1 3.3.2
3.4
Měření vzdálenosti Převod souřadnic
Práce s mapami 4.1
Struktura mapy 4.1.1 4.1.2 4.1.3 4.1.4
4.2 4.3
IMG Mapa Vrstva Objekty
Seznámení s dialogy 4.2.1 4.2.2
Dialog objektu Dialog IMG
Základní akce 4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 4.3.6 4.3.7 4.3.8 4.3.9 4.3.10 4.3.11
5
Nastavení Vyhledávání
Nástroje 3.4.1 3.4.2
4
Bez instalace Instalace
Přehled načtených map a IMG Načtení mapy / IMG Výběr mapy / IMG Zavření IMG Úprava IMG Uložení IMG Spojení IMG Úprava mapy Úpravy mapových objektů Vytváření nových mapových objektů Mazání mapových objektů
Práce s body, stopami a trasami 5.1
Seznámení s dialogy 5.1.1 5.1.2 5.1.3
5.2
Dialog bodu Dialog stopy Dialog plánování trasy
Základní akce 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6
Otevření souboru Zavření souboru Uložení souboru Vytvoření nového bodu / stopy / trasy Úprava bodu / stopy / trasy Smazání bodu / stopy / trasy
- 2 / 21 -
6
Hlášení chyb a feedback 6.1 6.2 6.3 6.4
Jak hlásit chybu Co by mělo hlášení obsahovat Feedback Co z toho budete mít?
- 3 / 21 -
1
Motivace
Program SnailMap vznikl kvůli nedostatku software pro práci s GPS daty a mapami (Garmin) na UNIXových systémech, nicméně funguje i na systémech Windows. Cílem není nahradit existující programy, například Garmin MapSource, ale spíš doplnit funkce, které postrádají, a zastoupit je tam, kde nefungují.
1.1
Co všechno program umí • • • •
1.2
Co všechno program neumí • •
1.3
načítat, zobrazovat a upravovat mapy ve formátu MP (Polski Formát Map) načítat, zobrazovat a upravovat body, stopy a trasy ve formátech GPX a LOC1 pokročilé vyhledávání v mapách i datových souborech (chytré plánování trasy (chystá se v příští verzi))
odesílat data do GPSr a přijímat je2 načítat a ukládat přímo IMG soubory3
Licence Tento program je pod licencí GPLv3 (GNU General Public Licence verze 3). Více zde: http://www.gnu.org/licenses/gpl3.0.html
1.4
Co se dozvíte v tomto dokumentu
Tento dokument obsahuje pouze pokyny k ovládáni programu. Pokud si chcete program sami upravit, měli byste si nastudovat ještě programátorskou dokumentaci. Struktura příručky je jednoduchá - ke každému tématu jsou popsány všechny související běžné činnosti včetně postupu a popisu chyb a záludností.
1 U formátu LOC pouze body. 2 Můžete použít software GPSBabel nebo SendMap. 3 Do a z MP je můžete převést např. programy MapEdit nebo cGPSmapper.
- 4 / 21 -
2
Instalace
Instalace není nutná, pouze je potřeba zachovat relativní cesty ke grafice a k databázovým souborům.
2.1
Linux
2.1.1 1. 2. 3. 4. 5.
Bez instalace stáhněte si balíček se zdrojovými kódy ke kompilaci budete potřebovat Qt 4.6, WebKit (devel), příslušný qmake a g++ rozbalte balíček se zdrojovými kódy spusťte si konzoli ve složce se z. k. zadejte sekvenci příkazů: qmake; qmake makefile; make 6. spusťte pomocí: ./SnailMap2_2 Nebo: 1. změňte práva skriptu build.sh: chmod u+x build.sh 2. spusťte skript: ./build.sh 2.1.2 Instalace Balíčky pro instalaci (rpm, deb apod.) ještě nejsou k dispozici.
- 5 / 21 -
3
Spuštění programu
3.1
Poznejte program Takto vypadá Hlavní okno programu po načtení mapy okresu Nymburk:
Popisky: 1. Panel Objects - velice důležitý při práci s body, trasami, stopami a soubory 2. Hlavní okno - zde se zobrazují mapy 3. Vyhledávací dialog (výsledky) 4. Nástrojová lišta výběru mapy a IMG 5. Nástrojová lišta Zoom 6. Nástrojová lišta Nástroje 7. Přepínač úpravy IMG 8. Hlavní menu 9. Náhled
- 6 / 21 -
3.2
Problémy při spuštění
3.2.1 Nezobrazují se obrázky Pravděpodobně je chyba v nastavení - ověřte správnost cest k souborům ve Vašem nastavení - případně jste přišli o složku s grafikou - ověřte, že existuje složka “imgs” s podsložkami “prg” a “marks” a že tyto podsložky obsahují grafiku. 3.3
Dialogy
3.3.1 Nastavení
Popis: Dialog nastavení je poměrně složitý, přesto jsem se pokusil ho udělat co nejsrozumitelněji proto je na každé kartě ve spodní části okénko “Advices”, kde jsou zobrazeny tipy a vysvětlivky k prvkům, jejichž funkce není na první pohled zřejmá. Také je většina prvků vybavena “tool-tipy” krátkou informací o účinku prvku, která se zobrazí, když na prvek najedete myší.
- 7 / 21 -
3.3.2 Vyhledávání
Popis: SnailMap umožňuje vyhledávat mapové objekty pouze podle názvu, zato ovšem s mnoha filtry, které Vám pomohou nalézt to, co zrovna hledáte. Některé filtry ovšem mohou vyhledávání výrazně zpomalit, proto prosím věnujte pozornost následujícímu textu. • •
porovnávání je vždy case-insensitive (nezáleží na velikosti písma) pokud zadáte moc obecný regexp (např. “.*”), může vyhledávání trvat velice dlouho
Možná nastavení a filtry: Přesná shoda / regulární výraz (regexp) Přesná shoda je rychlejší, ovšem málokdy víte, jak se na mapě přesně jmenuje to, co hledáte. Regulární výraz je naproti tomu mocný nástroj na vyhledávání pomocí obecných dotazů, ovšem pravděpodobně jej plně nevyužijete. Defaultní nastavení je regexp + zaškrtnuté políčko, které před i za hledaný výraz přidá “.*”, tzn. hledá podřetězec.
- 8 / 21 -
IMG a/nebo soubory POI Můžete si zvolit, jestli bude program vyhledávat v IMG a POI souborech a k POI ještě jestli bude prohledávat i sekci “Description” (funguje jen při regexp-vyhledávání). Defaultně vyhledává všude a jen podle názvů. Konkrétní IMG Tady si můžete vybrat v jakých IMG souborech se ma vyhledávat. Defaultně se hledá ve všech otevřených IMG. Vrstvy Tady si můžete nastavit rozsah vrstev, kde se mají hledané objekty nacházet. Defaultně všechny vrstvy. Typy objektů Tahle část obsahuje 3 podsekce - “Points”, “Linears” a “Polygons”. V každé sekci je nahoře políčko s názvem kategorie (“Points”) - jeho zaškrtnutí určuje, jestli bude program vyhledávat objekty této kategorie. Dále tam je políčko “Additional filters” a pod ním okénko se seznamem typů v dané kategorii. Pokud zaškrtnete políčko “Additional filters”, vyhledané objekty se přefiltrují podle toho, co jste zaškrtali v okénku s typy. Pozor, tahle funkce uz vyhledávání brzdí poměrně významně! Defaultně se vyhledávají jenom body a filtry se nepoužívají.
3.4
Nástroje
3.4.1 Měření vzdálenosti
Popis: Tento panel se otevře automaticky po volbě nástroje “Measure” (ikonka pravítka). Každé kliknutí na mapu pak přidá na konec seznamu bod a přepočítá vzdálenost. Měřená trasa se zobrazuje světle fialovou čerchovanou čárou. Tlačítkem “Clear” smažete všechny body, tlačítkem “-” smažete vybraný bod a tlačítkem “Route” předáte seznam bodů dialogu výpočtu trasy.
- 9 / 21 -
3.4.2 Převod souřadnic
Popis: Tento panel umožňuje převádět souřadnice mezi libovolnými formáty; jednotlivé formáty si navíc můžete libovolně upravit. Platí tu stejná syntaxe jako všude jinde u souřadnic - podrobný přehled formátovacích výrazů najdete v dialogu “Settings” v sekci “Coordinates”.
- 10 / 21 -
4 Práce s mapami 4.1 Struktura mapy Mapy jsou strukturované následujícím způsobem: 1. 2. 3. 4.
Mapa IMG Vrstva Objekty
4.1.1 IMG IMG představuje jeden IMG soubor (mapový soubor Garmin). V něm jsou uložené informace o vrstvách a všech objektech. Obvykle jde o mapu nějakého nevelkého správního celku, například v Garmin TOPOCzech ma každý okres svůj IMG soubor. Program SnailMap (zatím) neumožňuje načítat nebo ukládat přímo IMG soubory, je nutné používat “meziformát” MP (Polski Formát Map). 4.1.2 Mapa Mapa představuje soubor příbuzných IMG souborů a je v programu SnailMap reprezentována soubory formátu SMM4. Tento formát není kompatibilní s jinými programy, a jde o pouhý seznam adres MP-souborů k načtení. 4.1.3 Vrstva Každý IMG má až 10 (u Garmin TOPO map obvykle 3-4) různě podrobných vrstev. Při změně přiblížení se pak zvolí příslušná vrstva (pokud vlastníte GPSr s mapou, asi víte, o čem mluvím). Platí, že čím nižší číslo má vrstva, tím je podrobnější. Vrstvy jako takové nemůžete nastavovat ručně (při neopatrné manipulaci by mohlo dojít k selhání programu pro přílišnou spotřebu paměti nebo přílišné nároky na grafiku), ale můžete přenastavit mapováni vrstev na úrovně přiblížení. 4.1.4 Objekty Objekty jsou třech typů: body, lineární objekty a polygony.
4 SnailMap Map
- 11 / 21 -
4.2
Seznámení s dialogy
4.2.1 Dialog objektu
Popisky: 1. přepínač náhledu (B = prázdná plocha, M = aktuální IMG) 2. specifické vlastnosti objektu 3. náhled 4. zoom náhledu 5. seznam souřadnic objektu + ovládací prvky: nahoře přidání a odebrání bodu, dole posun bodu v seznamu 6. obecné vlastnosti 7. přepínač uložení - pokud je zaškrtnutý, původní objekt nezmizí Tipy: • pozor, při práci s bodem se (nezávisle na jejich množství) použije pouze první bod! • při kliknutí na okno náhledu se vytvoří nový bod a vloží se do seznamu bodů za aktuálně označený • červený křížek označuje aktuálně zvolený bod v seznamu
- 12 / 21 -
4.2.2 Dialog IMG
Popisky: 1. příslušnost IMG k mapě 2. přidáváni sekcí do hlavičky IMG 3. správa sekcí Popis: Sekce [ID] obsahuje základní informace o IMG a je jediná povinná; ostatní sekce je možné libovolně přidávat a zavírat (tím se vymažou z IMG). Sekce Restricts není sekce jako taková, je to seznam sekcí typu [Restrict]; jejich uložení do IMG můžete určit pomocí přepínače na příslušné kartě. Kartu Restricts taktéž nelze zavřít.
4.3
Základní akce
4.3.1 Přehled načtených map a IMG Postup: 1. Podívejte se v panelu “Objects” na poslední kartu. Možné chyby: Nemůžete najít panel “Objects” Panel “Objects” nikde není!
- 13 / 21 -
Řešení / prevence:
•
v hlavním menu zvolte “View” a zaškrtněte “Objects”
4.3.2 Načtení mapy / IMG Postup: 1. v hlavním menu zvolte “Map” - “Load map” (Ctrl+M), resp. - “Load IMG” (Ctrl+I) 2. vyberte soubory, které chcete načíst 3. počkejte, dokud se neobjeví zpráva o načtení požadovaných souborů Možné chyby: Může dojít paměť Ve verzi 2.2 nefunguje swapování (odkládání) dat na disk (a v pozdějších verzích může být kvůli rychlosti vypnuto), v důsledku čehož může při načítání většího množství souborů dojít paměť. S vypnutým swapováním musíte počítat se spotřebou přibližně 10MB / 1MB zdrojového kódu MP souboru. Když dojde paměť, systém je silně vytížený po dobu až několika minut a nakonec obvykle příslušný proces ukončí (čímž se vrátí k normálu). Řešení / prevence:
• •
ukládat si pravidelně rozdělanou práci a sledovat vytíženost systému + u verzí, které to umožňují, používat swapování pokud nepotřebujete celou mapu, používejte načítací filtry (v nastavení)
Načtení mapy / IMG se nepovedlo Program při načítání IMG souboru nahlásil syntaktickou chybu / chyby. Řešení / prevence:
• •
Váš soubor je nejspíš poškozený, zkuste si jej opatřit znovu pokud problémy přetrvají, dejte mi prosím vědět přes e-mail (str.[sec:Hlaseni-chyb]) - je možné, ze parser obsahuje chyby, případně že v něm něco není zahrnuto
4.3.3 Výběr mapy / IMG Postup: 1. V nástrojových lištách je jedna, která obsahuje výběr mapy a následně výběr IMG, takže stačí si vybrat. Možné chyby: Žádný výběr tam není! Nejspíš jste si zvolili, že lišta s výběrem map má být skrytá. Řešení / prevence:
• •
v hlavním menu zvolte “View” a zaškrtněte “Maps toolbar” pokud se tímto problémem nechcete zabývat při každém spuštění, proveďte příslušné změny i v nastavení
4.3.4 Zavření IMG Postup: 1. zobrazte IMG, který chcete zavřít 2. v hlavním menu zvolte “Map” - “Close current IMG”
- 14 / 21 -
Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím. 4.3.5 Úprava IMG Postup: 1. přejděte na poslední kartu panelu objects 2. zvolte IMG, který chcete upravit (POZOR - defaultní prázdný IMG “empty img” upravovat nemůžete) 3. na zvolený IMG dvojklikněte 4. zobrazí se Vám dialog úpravy IMG - proveďte požadované úpravy a uložte / zrušte změny Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím. 4.3.6 Uložení IMG Postup: 1. zobrazte IMG, který chcete uložit 2. v hlavním menu zvolte “Map” - “IMG actions” - “Save current IMG”, resp. “Save current IMG as...” 3. v případě “uložit jako” vyberte kam chcete IMG uložit Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím.. 4.3.7 Spojení IMG Ve verzi 2.2 není implementováno (vyžaduje swap). 4.3.8 Úprava mapy • u mapy můžete nastavit jenom jméno Postup: 1. dvojklikněte na zvolenou mapu v panelu “Objects” na poslední kartě 2. zadejte nové jméno Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím. 4.3.9 Úpravy mapových objektů Postup: 1. ujistěte se, že je v nástrojové liště sepnutý přepínač úpravy IMG 2. klikněte pravým tlačítkem myši na objekt, který chcete upravit 3. v menu vyberte svůj objekt 4. zvolte “Edit” 5. v dialogu, který se Vám následně otevře, upravte co potřebujete a uložte / zrušte; přitom dejte pozor na zaškrnutí políčka “Save as copy” Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím. - 15 / 21 -
4.3.10 Vytváření nových mapových objektů Postup: 1. ujistěte se, že je v nástrojové liště sepnutý přepínač úpravy IMG 2. klikněte pravým tlačítkem myši na místo, kde chcete, aby Váš objekt ležel 3. zvolte “Global” - “New point” (linear / polygon) 4. v dialogu, který se Vám následně otevře, doplňte další detaily a uložte / zrušte Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím. 4.3.11 Mazání mapových objektů Postup: 1. ujistěte se, že je v nástrojové liště sepnutý přepínač úpravy IMG 2. klikněte pravým tlačítkem myši na objekt, který chcete smazat 3. v menu vyberte svůj objekt 4. zvolte “Delete” Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím.
- 16 / 21 -
5
Práce s body, stopami a trasami
5.1
Seznámení s dialogy
5.1.1 Dialog bodu
Popisky: 1. do tohoto políčka můžete vložit / napsat souřadnice v aktuálním vstupním formátu (viz dialog “Settings”) - je určeno pro případy, kdy chcete okopírovat souřadnice vcelku 2. (ostatní je zřejmé)
- 17 / 21 -
5.1.2 Dialog stopy
Popisky: 1. náhled v modu “výškový profil” 2. seznam bodů + nástroje přidání / odebrání a posun bodu 3. filtrace bodu - podle zaškrtnuti políčka delete se buď každý n-tý prvek smaže, nebo naopak nesmaže 4. automatické odstraňování “uzlu” na trase (ve verzi 2.2 není implementováno) 5. přepínač mezi plošným pohledem a výškovým profilem trasy 5.1.3 Dialog plánování trasy Trasy nejsou ve verzi 2.2 implementované.
5.2
Základní akce
Narozdíl od např. MapSource, který může zároveň pracovat pouze s jedním souborem, SnailMap umožňuje otvírat neomezené množství souborů, umožňuje je spojovat, měnit jejich formát atd.
- 18 / 21 -
5.2.1 Otevření souboru Postup: 1. v hlavním menu zvolte “File” - “Open POIs file” (Ctrl+O), zvolte soubory GPX nebo LOC, které chcete otevřít, a počkejte než se načtou (doba závisí na velikosti, obvykle do 1s) Možné chyby: Syntaktická chyba při načítání Během načítání se objevila syntaktická chyba (nebo víc). Parser je dělaný tak, že při selhání načítání jednoho objektu tento objekt vynechá, nahlásí chybu a snaží se o načtení zbytku souboru, takže chyb se může objevit víc. Řešení / prevence:
• •
Váš soubor je nejspíš poškozený, zkuste si jej opatřit znovu pokud problémy přetrvají, nahlaste to prosím (str.[sec:Hlaseni-chyb]) - je možné, že parser obsahuje chyby, případně že v něm něco není zahrnuto
5.2.2 Zavření souboru Postup: 1. v hlavním menu zvolte “File” - “Close” a vyberte z nabídky nejvhodnější příkaz Možné chyby: Nemělo by dojít k chybě. Pokud však přesto na nějakou narazíte, nahlaste (sekce 6 -Hlášení chyb a feedback) mi ji prosím. 5.2.3 Uložení souboru SnailMap umožňuje uložit soubory mnoha způsoby - jen zobrazené, všechny do jednoho apod. Ovšem pozor - ukládání souboru funguje stejně jako například v konzolových textových editorech (vim apod.): stávající podoba se uloží do zvoleného souboru, ale dál pokračujete v úpravě původního souboru. Postup: 1. v hlavním menu zvolte “File” - “Save POIs file” a v následující nabídce si zvolte požadovaný způsob uložení 2. při volbě jedné z prvních dvou možností (“Save” a “Save as”) budete dotázáni na soubor, kterého se činnost týká a bude Vám nabídnut seznam otevřených souborů •
zobrazené soubory si můžete zvolit na panelu “Object” na kartě “POI files”
Možné chyby: Převod GPX <-> LOC Po uložení se objeví varovné hlášení o převodu bodů z formátu do formátu. Řešení / prevence:
Toto není chyba, pouze varování. Program varuje proto, že při změně formátu zahazuje všechny tagy, které nezná, takže může dojít ke ztrátě uživatelských dat (jde o obsah rámečku “Others” v editačním dialogu).
- 19 / 21 -
5.2.4 Vytvoření nového bodu / stopy / trasy Bod: • v hlavním menu zvolte “POI / Path / Route” - “New” - “POI” • na panelu “Objects”, na kartě “POIs” klikněte na “Add new POI” • v nástrojové liště “Tools” zvolte nástroj “Mark” (znak vlaječky), zvolte místo na mapě a klikněte (bod, který zvolíte, leží pod spodním koncem žerdi vlaječky) Stopa: • v hlavním menu zvolte “POI / Path / Route” - “New” - “Path” • na panelu “Objects”, na kartě “Paths” klikněte na “Add new Path” Trasa: • • • •
v hlavním menu zvolte “POI / Path / Route” - “New” - “Route” v hlavním menu zvolte “Find” - “Plan route” (Ctrl+R) na panelu “Objects”, na kartě “Routes” klikněte na “Plan new Route” Pozor! Zatím nefunkční!
5.2.5 Úprava bodu / stopy / trasy Bod: • zvolte nástroj “Select” a dvakrát klikněte na zvolený bod • na panelu “Objects”, na kartě “POIs” dvojklikněte na zvolený bod • klikněte na mapě pravým tlačítkem na zvolený bod, vyberte jej v nabídce a zvolte “Edit” Stopa: • na panelu “Objects”, na kartě “Paths” dvojklikněte na zvolenou stopu • klikněte na mapě pravým tlačítkem na zvolenou stopu, vyberte ji v nabídce a zvolte “Edit” Trasa: Zatím neimplementováno. 5.2.6 Smazání bodu / stopy / trasy Bod: • na panelu “Objects”, na kartě “POIs” vyberte body, které chcete smazat a v hlavní nabídce zvolte “POI / Path / Route” - “Delete selected” (Del) • klikněte na mapě pravým tlačítkem na zvolený bod, vyberte jej v nabídce a zvolte “Delete” Stopa: • na panelu “Objects”, na kartě “Paths” vyberte stopy, které chcete smazat a v hlavní nabídce zvolte “POI / Path / Route” - “Delete selected” (Del) • klikněte na mapě pravým tlačítkem na zvolenou stopu, vyberte ji v nabídce a zvolte “Delete” Trasa: Zatím neimplementováno.
- 20 / 21 -
6
Hlášení chyb a feedback
6.1
Jak hlásit chybu
Objevené chyby hlašte prosím na e-mail
[email protected]. Jako předmět (SUBJECT) použijte “SNAILMAP-BUG”. Co má být obsahovat chybové hlášení najdete v následující části.
6.2
Co by mělo hlášení obsahovat
Hlášení byste měli podávat až poté, co o chybě něco zjistíte, ideálně až přijdete na to, čím se Vám ji podařilo vyvolat (tzn. zkusit ji opakovaně vyvolat). Hlášení by mělo obsahovat: • • • •
6.3
detailní popis chyby detailní popis chování programu při objevení chyby detailní popis Vaší činnosti (pouze v rámci programu ;-) ) než došlo k chybě pokud nejsou moc velké, tak soubory, se kterými jste pracovali, když nastala chyba (pokud máte pocit, že s nimi chyba souvisí)
Feedback
Je něco, co byste k programu doplnili? Něco, co byste upravili? Například často používáte nějakou funkci a ona nemá klávesovou zkratku, takže Vás to zdržuje v práci. Neváhejte a napište na
[email protected]. Jako předmět zadejte “SNAILMAP-FEEDBACK” a popište co nejpodrobněji svůj návrh na zlepšení. Pozor, na rozdíl od opravy chyb, u feedbacku si vyhrazuji právo veta. To znamená, že moc ztřeštěné nápady dodělávat nebudu.
6.4
Co z toho budete mít? Budete z toho mít dobrý pocit, můj vděk a v neposlední řadě funkční software.
- 21 / 21 -
