Introcuctie.
============

'plop' is een kaartselector voor de Kabouterbond-kaarten.
Hiervoor is een kaart van Nederland nodig; plop kan deze maken m.b.v. de 
Kabouterbond-deelkaarten.

Daarna kan plop de overzichtskaart zichtbaar maken. Door op een plek te klikken
kan de bijbehorende kaart in een apart venster worden getoond.

Verder kunnen routes, afkomstig van een Garmin GPS (text-formaat) ingelezen en
getoond worden.

Installatie (Windows)
=====================

Behalve plop.exe en natuurlijk de KB-kaarten zijn nog een aantal DLL's nodig:
gtk_dll.zip: http://www.alblas.demon.nl/wsat/software/files/gtk_dll.zip
decompr.zip: http://www.alblas.demon.nl/wsat/software/files/decompr.zip

Na ontzippen geeft gtk_dll.zip 8 dll's; decompr.zip geeft 2 dll's waarvan alleen
jpeg812.dll nodig is. Deze dll's moeten geplaatst worden in (bv.) windows\system.

Van de Kabouterbond zijn nodig:
. alle jpeg files, te plaatsen in C:\jpeg
. ozikaarten.txt, te plaatsen in C:\Ozi\Mathlab\ozikaarten.txt

De laatste file is te vinden op CD1, op overeenkomstige hierarchische plaats.

E.e.a. mag op andere locaties gezet worden, maar dan moeten er opties 
meegegeven worden aan plop, bv.:

plop -j C:\jpeg -k C:\Ozi\Mathlab\ozikaarten.txt

(dit komt dus overeen met het niet geven van de -j en -k optie.)

De losse kaarten kunnen met een ingebakken kijker bekeken worden. Deze is nog 
niet erg optimaal (vrij traag). Als alternatief is het ook mogelijk om een 
externe kijker te gebruiken:

. Voor Linux: Gimp (zit (bijna) altijd bij de Linux distributie)
. Voor Windows: Irfanview (i_view32.exe); gratis neer te laten van:
    www.irfanview.com.

Dit programma moet op een locatie neergezet worden waarnaar een zoekpad staat, 
dus bv. voor Windows in c:\windows. 
Dit is na installatie van Irfanview NIET het geval, dus even i_view32.exe naar 
een geschikte locatie kopieren! Test in een DOS of XP commando-schil dat na 
het intypen van: 
  i_view32 
het programma inderdaad opstart.


Installatie (Linux, voor de echte kabouter-kerels...)
=====================================================
Benodigd: 
plop (in plop.tgz)
decompr.tar.gz: http://www.alblas.demon.nl/wsat/software/files/decompr.tar.gz
Van decompr.tar.gz is alleen libjpeg812.so benodigd.
De gtk-libs worden met de meeste (alle?) Linux-distributies meegeleverd;
hetzelfde geldt voor Gimp.
------------------------------------------------------------------------------

Gebruik.
========

1. Voorbereiding.
-----------------

Eerst moet een kaart van Nederland worden gemaakt.
Open een commandovenster (win95/98: msdos venster, XP: dinges??).
Geef nu het commando:

plop -g

Na enige tijd (orde-grootte 15 min, afh. van snelheid PC) wordt er een
nederpic.jpg gegenereerd. 
De afmetingen van deze kaart zijn 700x700; met de -b en -h opties kan een 
andere resolutie gekozen worden. Bv.:

plop -g -b 4000 -h 4000

Dit maakt echter e.e.a. wel wat trager.

Met de -f optie kan een andere naam van de te generren file worden gekozen.

2. Het echte werk.
------------------

Geef commando:

plop

(gebruik -f optie als de kaart niet nederpic.jpg heet).

Nu verschijnt de eerder gemaakte kaart van Nederland.
. Klik met de linker muistoets op een bepaald gebied. Het geselecteerde gebied 
  wordt nu rood omkaderd. (Je kan ook de muistoets ingedrukt houden en 
  tegelijkertjd door de kaart heen fietsen, dan zie je direct wat er wordt
  geselecteerd.)
. Klik nu op de knop 'Interne kijker' (of tab-toets) om de geselecteerde
  deelkaart met de interne kijker te bekijken.
. Klik op 'Externe kijker' (of spatie-toets) om GIMP of Irfanview op te starten.

Afhankelijk van waar wordt geklikt kan het zijn dat er meerdere gebieden worden
geselecteerd. Als de plaats waarop geklikt wordt ongeveer overeenkomt met het 
centrale gebied van een kaart dan zal alleen die kaart worden geselecteerd 
(1 rood omkaderd gebied). Als in de buurt van een rand van een kaart wordt 
geklikt dan zal ook de direct aangrenzende kaart worden geselecteerd. Als op een 
hoekpunt wordt geselecteerd dan zullen er (meestal) 4 kaarten worden geselecteerd.
'plop' zal van alle geselecteerde kaarten 1 gedetailleerde kaart samenstellen,
deze bestaat dus uit minimaal 1 en maximaal 4 deelkaarten.

Dit betekent dat ook het aantal punten per plaat een factor 4 hoger kan liggen.
De meeste platen zijn ca. 4000x5200; bij 4 platen is dit 8000x10400 (ruim 
80 Mpunten of 240 Mbyte). Met een PC met 512M aan RAM gaat dit nog goed.
Om de hoeveelheid benodigde geheugen te beperken kan het volgende worden gedaan:
. Selecteer 'Halve resolutie'. De resolutie wordt nu een factor 2x2 kleiner.
. Selecteer 'Afsnijden'. De afmeting van de samengestelde kaart wordt nu gelijk 
  gemaakt aan 1 kaart, door de afmetingen per deelkaart te halveren.
  De volledige resolutie wordt behouden.

(N.b. Dit alles wordt alleen ondersteund door de interne kijker. De externe 
      kijker wordt in de modes 'Halve resolutie' en 'afsnijden' gedeactiveerd.
      In de mode 'Volle resolutie zal de externe kijker altijd slechts 1 kaart
      laten zien.)

Met de rechter muistoets kunenn delen bijgeselecteerd worden. Zo kunnen bv. 4 of meer delen op een rij worden geselecteerd. (Max. afmetingen zodanig dat aantal punten onder 2^31 = 2G ligt!)
 
Er mogen meerdere kijkers tegelijkertijd openstaan, maar dat vreet wel 
geheugenruimte!

Manipuleren interne kijker:
i ......... inzoemen
o ......... uitzoemen
f ......... vol met behoud van 'vierkante' punten
F ......... vol, maar vervormd (vol NZ en WO richting)
r ......... plaatje verversen
t ......... start route
e ......... einde route
v ......... verwijderen laatste route
s ......... wegschrijven route(s) in pcx5-formaat

pijltjes .. verschuiven plaat

Voor hoofd-raam geldt bovendien:
n ......... selectie noord van huidige selectie
e ......... selectie oost van huidige selectie
z ......... selectie zuid van huidige selectie
w ......... selectie west van huidige selectie
Dit kan ook met de pijltjestoetsen op het numerieke toetsenbord.

3. Routes inlezen.
--------------------
Zorg dat de gewenste route ge-exporteerd is:
via Gamin-software: Export, kies: text formaat.

Kies via menu in hoofdvenster:
  File->route
Er wordt nu een venster geopend waarmee een routekaart (file) kan worden 
gekozen. Selecteer en druk op OK.
Nu verschijnt een lijst met alle beschikbare routes. Selecteer een of meerdere
regels en klik op 'Plot'.
Nu worden alle routes met weg-punten op de hoofdkaart ingetekend.
Door nu op de gebruikelijke wijze een deel-kaart te kiezen (interne kijker)
wordt de route op de deelkaart(en) zichtbaar gemaakt.

N.b. Als bij geopende deelkaart een andere route wordt gekozen dan wordt die
meteen zichtbaar in de overzichtskaart maar niet in de deelkaart. Druk even op
'r' om de nieuw geselecteerde route zichtbaar te maken.

4. Routes maken.
----------------
. Klik op 't' of toets 't'.
. Klik met linker muistoets de route aan.
. Met rechter toets kan laastet segment worden verwijderd.
. Klik 'e' of toets Escape om af te sluiten.
. Ga evt. door met volgende route.
. Schrijf weg in PCX5-formaat : 's'. 
  (Dit formaat kan door Garmin-GPS gelezen worden.)

5. Navigatie.
-------------


Help.
-----

Commando:
plop -H 
geeft een overzicht van alle opties.

plop -R <file>    start plop en lees direct gps-file in.
Tip: Als dezelfde opties steeds nodig zijn zet dan het commando-met-opties in 
     een .bat  file, bv. plop1.bat. (Of hernoem plop.exe plop1.exe en maak een
     plop.bat.)

