Cruisers Forum
 


Join CruisersForum Today

Reply
 
Thread Tools Rate Thread Display Modes
Old 31-03-2011, 10:05   #1
Registered User

Join Date: Feb 2010
Posts: 619
Implementing Layers in 0324 Beta

Attached is a patch (based at 0324, following the 0001-Automatic-Daily-Track) implementing handling layers in Route Manager as signalled initially in Forums - Post 622989">-IRJDSUNE9932123321222xxeww-the-IRJDSUNE9932123321222xxeww-original-IRJDSUNE9932123321222xxeww-thread-IRJDSUNE9932123321222xxeww-.

Routes, tracks and waypoints can be aggregated into layers.
A layer is imported interactively via Import new Layer button or automatically on start of OpenCPN.
Automatic import occurs from /layers subdirectory under /data in the OCPN installation structure.
Any .gpx file in /layers becomes a separate layer.
Any subdirectory under /layers (e.g. /layers/windfarms) results in all of its .gpx contents (all the way down) to form a separate layer.

Objects in layers cannot be modified. They can be deleted only as the whole layer.
Objects in layers are not saved to navobj.xml and cannot be exported.

On the layers tab here are buttons for

- showing or hiding a layer on chart (initially: shown)
- showing or hiding the layer contents in other RM tabs (initially: hidden)
- showing or hiding on chart the layer's (incl. routes and tracks) waypoints names (initially: as specified in .gpx file)

For beginner's usage, it is recommended to use manual Load/Delete of layers sparingly. These are primarily layer development tools, and once you are happy with the GPX files, put them into /layers and just leave there.

During layer import the GUIDs (if present) in the GPX files are ignored. The rationale for this is that layers data is treated as _templates_ of Nav Objects, so they are never identified with any other _concrete_ object. This means that you can import the same layer many times over itself, and still have all these copies present. This has both upsides and downsides. I feel the GUID handling policy in OCPN should be reviewed, but for now you get reasonable behaviour and lots of possibilities.

Attached is a series of screenshots with preloaded layers sequentially hidden by single clicks on the visibility icon.

Enjoy,

Piotr
Attached Thumbnails
Click image for larger version

Name:	1all_layers_S.jpg
Views:	143
Size:	76.7 KB
ID:	25698   Click image for larger version

Name:	2minus_paper_folios_S.jpg
Views:	133
Size:	65.9 KB
ID:	25699  

Click image for larger version

Name:	3minus_TSS_zones_S.jpg
Views:	129
Size:	64.8 KB
ID:	25700   Click image for larger version

Name:	4minus_lighthouses_S.jpg
Views:	117
Size:	51.9 KB
ID:	25701  

Click image for larger version

Name:	5minus_ODAS_S.jpg
Views:	117
Size:	51.0 KB
ID:	25702   Click image for larger version

Name:	6minus_routes_S.jpg
Views:	111
Size:	44.8 KB
ID:	25703  

Click image for larger version

Name:	7minus_platforms_windfarms_S.jpg
Views:	115
Size:	41.8 KB
ID:	25704  
Attached Files
File Type: doc 0002-Implement-layers-in-0324.patch.doc (79.4 KB, 47 views)
__________________

__________________
PjotrC is offline   Reply With Quote
Old 31-03-2011, 15:58   #2
Senior Cruiser
 
sinbad7's Avatar

Cruisers Forum Supporter

Join Date: Sep 2003
Location: Ubatuba,SP,Brazil (Ex Norway)
Boat: (Ex) Alu. 60' yacht-"Eight Bells"
Posts: 2,717
Images: 57
Send a message via Skype™ to sinbad7
Re: Implementing Layers in 0324 Beta

PjotrC..

Is this layers facility also available for us Windows Vista users?
If so,how do you use the patch file?

Tore
__________________

__________________
"And all I ask is a tall ship and a star to steer her by."
sinbad7 is offline   Reply With Quote
Old 01-04-2011, 02:18   #3
Registered User

Join Date: Feb 2010
Posts: 619
Re: Implementing Layers in 0324 Beta

Tore,

It should work on all the platforms, including Vista.
If you are not building from source, you need to wait, until it will be included in the current (beta) release.

Piotr
__________________
PjotrC is offline   Reply With Quote
Old 13-04-2011, 06:54   #4
Registered User

Join Date: Feb 2010
Posts: 619
testing in 0412

With the feature now available for testing in 0412, just some comments to the user manual ...

In this simple model, layer objects are templates:

- unmodifiable
- undeletable individually
- not identified with any other, layer or regular, similar as they may be

Some of the consequences:

- you cannot extend a layer route nor track
- you cannot split a layer route nor track
- you cannot reverse a layer route

but

- you can activate and use a layer route unmodified
- you can extend a regular route into a layer route
- you can create an editable "copy" of a route (or other object), importing it twice - once as a layer, then as regular GPX
- to add a regular object to a given layer (e.g. "myLayer", for next restart), just export it into the /layers/myLayer directory

What I still can't figure out (implementation, not a user problem):

- how to avoid writing deleted layer objects into navobj.changes.xml? Should not be needed at all, since layers are always reconstructed fresh from source, not saved as current state...
__________________
PjotrC is offline   Reply With Quote
Old 30-06-2011, 02:53   #5
Registered User
 
HamishB's Avatar

Join Date: Jan 2010
Location: New Zealand
Posts: 286
Re: Implementing Layers in 0324 Beta

Hi,

any chance of getting this documented in the help html?

any chance of it looking in ~/.opencpn/layers/ as well as /usr/local/share/opencpn/layers/ on UNIXs? the program may be installed to /usr/share/opencpn/ and the user not have write access to anything other than their own home directory. (same is true for a work-issued locked down MS Windows laptop)

same goes for looking for UserIcons in ~/.opencpn/icons/


thanks,
Hamish

ps- wrt UserIcons, if any of these symbols look useful let me know & I'll generate some 24x24 bitmaps of them: (GPLv2, vectorized source)
IconSymbols - GRASS-Wiki
__________________
HamishB is offline   Reply With Quote
Old 30-06-2011, 03:15   #6
Registered User

Join Date: Dec 2005
Location: WNA
Boat: Dufour 35
Posts: 3,247
Re: Implementing Layers in 0324 Beta

Quote:
Originally Posted by HamishB View Post
Hi,

any chance of getting this documented in the help html?

any chance of it looking in ~/.opencpn/layers/ as well as /usr/local/share/opencpn/layers/ on UNIXs? the program may be installed to /usr/share/opencpn/ and the user not have write access to anything other than their own home directory. (same is true for a work-issued locked down MS Windows laptop)

same goes for looking for UserIcons in ~/.opencpn/icons/


thanks,
Hamish

ps- wrt UserIcons, if any of these symbols look useful let me know & I'll generate some 24x24 bitmaps of them: (GPLv2, vectorized source)
IconSymbols - GRASS-Wiki
Hamish

In the last beta both "UserIcons" and "layers" have been moved to ~/.opencpn. Layers are documented in the wiki, which will become the 2.5 documentation. Reviews and suggestions regarding the wiki are always welcome. The documentation that comes with the betas are still the old 2.3.1 documentation, while he wiki tries to keep up to date with the beta releases.

Thomas
__________________
cagney is offline   Reply With Quote
Old 30-06-2011, 03:22   #7
Registered User
 
HamishB's Avatar

Join Date: Jan 2010
Location: New Zealand
Posts: 286
Re: Implementing Layers in 0324 Beta

Quote:
Originally Posted by cagney View Post
In the last beta both "UserIcons" and "layers" have been moved to ~/.opencpn.
great. y'all are one step ahead of me, as usual.

Quote:
Layers are documented in the wiki,
ok

Quote:
which will become the 2.5 documentation. Reviews and suggestions regarding the wiki are always welcome. The documentation that comes with the betas are still the old 2.3.1 documentation, while he wiki tries to keep up to date with the beta releases.
erm, how exactly would one access the help when at sea with no internet connection? will the 'final product' be fed back into the 2.5.x distributibles?

should a cron job mirror all wiki pages as html into a zip file, which could be installed on the local system?


thanks,
Hamish
__________________
HamishB is offline   Reply With Quote
Old 30-06-2011, 03:37   #8
Registered User

Join Date: Dec 2005
Location: WNA
Boat: Dufour 35
Posts: 3,247
Re: Implementing Layers in 0324 Beta

Hamish
Quote:
erm, how exactly would one access the help when at sea with no internet connection? will the 'final product' be fed back into the 2.5.x distributibles?
More or less - yes.
I suppose all this could be automated, as a snapshot of the wiki is always available at OpenCPN User Manual This link is available on the download page called "Live Snapshot". This "snapshot" can be used to update the documentation in the beta packages.
For an experienced user, using a beta release for actual navigation, I would recommend exactly this, or at least having the latest snapshot available on board.

When Dave is ready for a 2.5 release he will take a "snapshot", trim down the size of the picture directory (I thinK you did that last time?), ++, and include it in the release.

Thomas
__________________
cagney is offline   Reply With Quote
Old 30-06-2011, 07:45   #9
Marine Service Provider
 
bdbcat's Avatar

Join Date: Mar 2008
Posts: 4,883
Re: Implementing Layers in 0324 Beta

Thomas....

Oh I will, will I?...

I had forgotten about how we do the last minute doc update.
Thanks for reminding me.....

Dave
__________________
bdbcat is offline   Reply With Quote
Old 30-06-2011, 08:00   #10
Registered User

Join Date: Dec 2005
Location: WNA
Boat: Dufour 35
Posts: 3,247
Re: Implementing Layers in 0324 Beta

Quote:
Originally Posted by bdbcat View Post
Thomas....

Oh I will, will I?...

I had forgotten about how we do the last minute doc update.
Thanks for reminding me.....

Dave
Dave

The documentation is more or less ready to go. I would appreciate some critical eyes, checking mainly for accuracy, but other things as well, ...it's a wiki!
I can take the snapshot and trim the picture sizes, and make it available for you. Anything else....?

Thomas
__________________
cagney is offline   Reply With Quote
Old 30-06-2011, 09:07   #11
Marine Service Provider
 
bdbcat's Avatar

Join Date: Mar 2008
Posts: 4,883
Re: Implementing Layers in 0324 Beta

Thomas....

Thanks. I guess I could be ready for the doc files whenever you think the editing is complete, or at least good enough.

email to me directly, please, and I'll get them pushed.

Thanks again
Dave
__________________

__________________
bdbcat is offline   Reply With Quote
Reply

Thread Tools
Display Modes Rate This Thread
Rate This Thread:

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are Off
Pingbacks are Off
Refbacks are Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
Westerbeke or Beta Marine S&S Engines and Propulsion Systems 25 01-05-2013 04:52
Organizing Nav Objects into Layers PjotrC OpenCPN 68 31-03-2011 07:53
Yanmar or Beta barboak Construction, Maintenance & Refit 26 09-11-2010 16:01
Beta or Yanmar ? Aldgate Engines and Propulsion Systems 9 12-08-2010 19:37
Are Ten Layers of Fiberglass Strong? goldbeard Construction, Maintenance & Refit 18 14-04-2010 09:05



Copyright 2002- Social Knowledge, LLC All Rights Reserved.

All times are GMT -7. The time now is 03:07.


Google+
Powered by vBulletin® Version 3.8.8 Beta 1
Copyright ©2000 - 2017, vBulletin Solutions, Inc.
Social Knowledge Networks
Powered by vBulletin® Version 3.8.8 Beta 1
Copyright ©2000 - 2017, vBulletin Solutions, Inc.

ShowCase vBulletin Plugins by Drive Thru Online, Inc.