Onderwerp: Legend4OpenCPN – een legenda OpenCPN

Ik ben bezig met de ontwikkeling van Legend4OpenCPN, een plugin waarmee je legenda's en aanvullende informatie rechtstreeks in het kaartvenster van OpenCPN kunt weergeven.
Waar papieren kaarten een nette legenda hebben, heb ik nooit uit de voeten gekund met de digitale variant ervan: klikken op een icon, waarna een object query getoond wordt. En eerlijk gezegd vind ik de dan getoonde informatie regelmatig erg cryptisch. Ik heb liever snel een overzicht in plaats van dat ik van alles en nog wat moet aanklikken.

Wat ik nu aan het bouwen ben is een dynamische legenda voor OpenCPN. Dat betekent dat je in een hoekje van het scherm een legenda ziet van alle tekens die op dat moment op het scherm staan. Bij in- en uitzoomen of verschuiven van de kaart wijzigt die legenda zich dynamisch.
Een paar screenshots heb ik bijgevoegd. Je kunt het verschil zien met een scherm met één teken en een scherm met vijf tekens.

Nu ik toch bezig ben heb ik ook maar gelijk een optie gemaakt om losse teksten en afbeeldingen te tonen. Denk aan een routeplanning of een weerverwachting bijvoorbeeld. Er komt ook een klein tekstverwerkertje in, zodat je ook aantekeningen kunt maken. Ik moet nog uitzoeken hoe, maar daar zijn zat reeds bestaande oplossingen voor.

De functionaliteit voor dynamische legenda's van kaartlayers (de GPX-bestanden) staat inmiddels.
Een dynamische legenda van de kaartsymbolen van OpenCPN zelf vormt nog een uidaging. Ik hoop dat ik dat kan oplossen.
De verklarende teksten wil ik goeddeels matchen met Kaart 1 van de Dienst der Hydrografie. Online kan ik die niet vinden, maar de Vlaamse variant is dezelfde en vond ik hier. Als iemand betere oplossingen weet hou ik me aanbevolen.
Voor de goede orde: op de bijgevoegde screenshots staan nog geen verklarende teksten.

De plugin werkt inmiddels op macOS, maar is nog in ontwikkeling. Android vormt momenteel een beste uitdaging, vanwege beperkte bestandsrechten. In de volgende versie van OpenCPN voor Android komt daar een oplossing voor.

Het spulletje is in C++ geschreven. Zodra enigszins verantwoord gooi ik de GitHUb repository open en kan er getest worden.

Ik ben vooral benieuwd of anderen hier iets aan zouden hebben en welke mogelijkheden jullie nog missen.

Kom maar op met ideeën, suggesties en kritiek!



5 tekens


1 teken


Meerdere tekens


Voorbeeld van een vaarplan


Groter legendavenster. Verklarende teksten ontbreken nog.

Vanwege rugklachten heb ik verdikkeme al 7 weken niet kunnen zeilen. Herstel vordert, maar zeer traag. Kortom, de afgelopen weken had ik zeeën van tijd zat om verder te bouwen aan mijn plugin. Heel langzaam vordert het herstel, dus het wordt nu ook tijd dat ik de plugin afrond en weer eens ga zeilen.

Kort gesteld plaatst de plugin een venster op je kaart met een soort van dynamische legenda erin. Ik zoek een paar mensen die hem willen uitproberen op Windows, Linux en macOS.

Wat doet hij?

Kaartlegenda van wat er nu in beeld is. Elke soort boei, baken, topteken en meerpaal op je scherm krijgt één regel met de betekenis volgens Kaart 1 en het aantal. Verschuif of zoom je de kaart, dan past de lijst zich aan. Klik je op een regel, dan wijst de plugin het symbool aan op de kaart. Als je door te ver uitzoomen geen tekens meer op de kaart ziet tonen ze in grijs.
Werkt met o-charts, de ENC-kaarten van Rijkswaterstaat en waypoint-lagen zoals Nautin.


De legenda naast de kaart: alleen wat er nu in beeld is.

Lichten in gewone woorden. Iso.G.8s wordt groen isofase licht: 4 seconden licht en 4 seconden donker, met een tekening van het ritme. Je kunt een licht op de kaart laten branden, of met het nachtvoorbeeld zien hoe een aankomst in het donker eruitziet.

Licht herkennen. Zie je een licht en weet je niet welk het is? Tik het ritme mee, en de plugin noemt de lichten in beeld die het best passen.

Uitkijk. Onderweg zie je wat er op je koers ligt, op volgorde van aankomst: over 8 min · bakboord · 1,0 NM. De afstand waarop je vooruit kunt kijken is instelbaar, even als de kleur en de breedte van de "uitkijkbundel.
Tekens die niet meer op de kaart staan vanwege te ver uitzoomen worden in grijs getoond in de legenda. Op die manier zie je niets over het hoofd, ongeacht het zoomniveau.




Marifoon. Met rechtsklikken zie je het kanaal van het gebied waar je vaart, met een melding en pieptonen als je een nieuw gebied binnenvaart. Hiervoor gebruik je de laag van VHF2OpenCPN. Op de kaart licht het gebed op.

Een marifoongebied licht op, met kanaal en wat je moet doen.

Notities. Eigen notities in Markdown, ook vastgepind op een plek op de kaart, met een melding als je in de buurt komt.




Nachtvoorbeeld: de kaart donker, alleen de lichten branden in hun ritme.

Wie wil testen?
Ik ontwikkel op een Mac (Apple Silicon) met OpenCPN 5.14, dus daar werkt hij. Op andere systemen heb ik hem nog niet of onvoldoende zien draaien. Android is in dit verband een verhaal op zich. Daarop is het hele bestandssysteem dichtgetimmerd. Op normale manier een plugin importeren is er niet bij. Inmiddels is het me gelukt een een workaround te maken. Vanaf mijn Mac bouw ik dan met MacDroid een Android Debug Bridge (ADB) naar mijn tablet. Als iemand dat aandurft wil ik uiteraard graag helpen met het instellen van die workaround.

Ik zoek vanaf medio komende week een handjevol testers, liefst op zoveel mogelijk systemen.

Je hebt OpenCPN 5.14 nodig. Handig zijn kaarten van o-charts of Rijkswaterstaat. Je hoeft er niet mee te varen: met de plugin ShipDriver kun je thuis een boot laten varen.

Het gaat me vooral om:

• Laat de plugin zich installeren en starten?
• Verschijnt de legenda, en kloppen de iconen en teksten?
• Wat valt je op, wat is onduidelijk of werkt niet?
• Volstaat de meegeleverde handleiding?

Een paar regels en een schermafbeelding is al genoeg. Stuur me een PB met je systeem (bijvoorbeeld Windows 11 of Ubuntu 24.04). Dan stuur ik je de juiste downloadlink en een korte handleiding.

Let op: het is een alphaversie, dus er zitten nog fouten in. Met name de teksten die bij alle tekens horen moet ik nog helemaal nalopen. Het zwaartepunt lag tot nu toe op het bouwen.

Alvast bedankt!

Werkt goed onder linux, Debian.
Een nuttige plugin voor als je niet weet wat dit is:

Of als je het verschil niet weet tussen: