Ocpn_Draw 1.6

Ocpn_Draw_pi (OD) provides a graphics companion to Watchdog_pi (WD) Alarms. OD is used as a graphics tool to create Boundary Graphics and Boundary Point Graphics. WD will then create “Boundary Alarms” using the Boundary Graphics created by OD. The alarms that WD can create are (GPS proximity, GPS course & time, Anchor, AIS) depending on the alarm type WD may require a particular Boundary GUID or the alarm may apply to all boundaries that are displayed. The WD alarm types are separate and distinct from the OD graphics types (inclusive, exclusive, neither). OD knows nothing about the WD plugin, it just responds with information about specific Lat/Lon combinations. WD can use the graphic type that OD has to help filter which boundaries to look for. So if you have a large number of boundaries of mixed 'types' it would probably help if you selected the type of boundary to look for rather than use the default 'Any'.

See the Development manual - Plugin Messaging - for messaging between ODraw , Watchdog and Weather_routing. A simple way to visualise the interactions between ODraw Boundaries and WatchDog boundaries alarms is laid out in this chart.

The chart shows which OD Boundary objects will cause a WD alarm to ring. If the WD alarm is set to Exclusion, the alarm will ring, go off, if an Exclusion boundary is found within the alarm area, i.e. time or distance. However, no other type of boundary will cause the alarm to go off. So when you setup the alarms you need to check the above matrix to ensure you will get the alarm when you want it.

You can set up multiple Dynamic Guard Zones and set the alarms for one, some or all of these zones.

(Dynamic) Guard Zone Alarms are in some ways similar to the “AIS Collision Alarm” you can set in OpenCPN (Options-Ships-AIS Targets-CPA Calculation). But they are more versatile.

Red hatched Boundary created with Ocpn_Draw and used in Weather Routing Configuration > Options > Basic Tab > Check “Detect Boundary”

An extended API has been provisioned to allow other plugins to interact with the objects that OD supports. A new version of the Squiddio plugin is available which can make use of OD Text Points for the display of information. This removes the Squiddio waypoints from OCPN and replaces them with OD Text Points. This has the effect of decluttering the OCPN Routes and Waypoints Manager dialog. There is a new, extended, preferences dialog for Squiddio that allows the user to set various paramters for use with OD.

As can be seen it is easy to change between OCPN and OD for the display of Squiddio information. The extra information below the selection of which component to use is a subset of the settings available for Text Points. To find out more about Text Points please read further down on the manual.

There are currently two different format files that allow importing of Draw objects, these are: gpx and csv. Examples of both formats can be found here: https://github.com/jongough/ocpn_draw_pi/tree/master/examples. Both of these formats allow you to generate Draw objects from other data sources and then import them rather than having to create each object then modify them to get the correct attributes.

The gpx format is an XML format file and is exactly the same as used by Draw for storing its objects over a restart. If you look in the 'ocpn_draw_pi/data' directory you will see one or more xml files these show all the attributes needed for creating a gpx file. Or if you want to generate your own gpx file then do an export of a single Draw object of the type you would like to import so that you have the complete structure which you can then modify and import. The following is an example (test export paths1.gpx):

The CSV format file is to allow you to use a spreadsheet program to easily generate objects. Here is an example (test-boundary-import.csv):

The first label describes the type of line that follows, i.e. 'c' is a comment, 'B' is a Boundary, etc.

Using this format in a spreadsheet will allow you to easily create multiple Draw objects and then import them when you have finished.

This version of the plugin requires at least version of OpenCPN 5.xx.yy. It is not compatible with any version before this. The reason is that the user interface changed with OCPN 5 and a new graphics library was used.
Download the plugin from the Plugin Downloads section of opencpn.org

The plugin has an interesting interface with two icons as shown above for Draw Manager and Draw Create . The bottom icon on the OCPN Toolbar, Draw Create, is dynamic and will show a different icon depending on which drawing object type has been selected. Click on the bottom icon on the OCPN Toolbar and a floating Draw Toolbar appears containing Draw Tools , with the last one used selected by default (appears depressed). Select the Drawing Tool needed. The above Draw Tools are for Boundary, then Boundary Points, Text points, EBL, DR, Guard Zone, and Parallel Index Line in that order. The Drawing Objects that are available are as follows:

Try drawing several of each type to learn how they work and what they create. You can select the next tool in sequence by right clicking the mouse prior to starting to draw. Once a left mouse click has been done the right click will terminate the 'create' drawing. You can also stop the 'create' mode by hitting 'Esc', left mouse clicking the selected tool in the main toolbar or by left mouse clicking on the close icon in the 'Draw Toolbar'. It sounds complicated, but you will find one of the methods should meet your normal usage requirements.

Each tool has a cursor icon:

The DR tool does not draw based on the current cursor position, it brings up a dialog box that allows you to enter the DR information.

When you left mouse click 'OK' the DR line will be drawn based on the information you have entered. The information that is first displayed is the default information entered into the properties panel or the current information available to OpenCPN, i.e. SOG and COG.

The top Icon is for the Draw Manager which gives the user control over each of the Drawing objects that have been created from the Draw Toolbar. Left click on the Drawing Manager menu and the Path & OD Point Manager dialog will be displayed. The Path & Point Manager has tabs for Paths, OD Points and Layers from which selected Drawing Objects can be Shown, Hidden, Deactivated, Centered, Deleted, Exported, Delete All, and Export All. Additionally a drawing object’s Properties can be accessed and changed. First select one or more Drawing Objects under a given Tab . Then select the desired Action on the right. For example: Select all Drawing Objects under Paths Tab , then select Delete . This will remove all of the Drawing Objects under Path Tab . Of course the quick alternative is to select Delete All . Properties, Deactivate and Center View are greyed out when more than one object is selected.

Drawing Objects imported into Layers are static and non editable. Use Layers in the same way as the OCPN Route and Waypoint manager does, i.e. Temporary Layers. It will bring in boundaries and points and show or hide them as required. You can load more than one layer file into the same layer, just select more than one file in the file manager popup and they will load into the same layer. To use Layers and move Drawing Objects into a temporary user created Layer, select them, Export Selected and then import then from the Layers tab Import.

First, if you are in the 'create' mode you must terminate this by, Right Click of mouse, button, Left Click on the tool you are using or hit 'Esc' on the keyboard. Then in the drawing hover over the object you wish to modify until a square yellow descriptor appears, then right click. The popup menu’s first line will identify the type of drawing object you have selected. Then there will be a action pick list, dependent on the object, such as Properties, Move.., Insert.. Deactivate.. Delete. Some drawing objects are made of several parts, (Boundary, Boundary Points, EBL & VRM, GZ and PIL) so it makes a difference where you hover and the condition of the object.
1. To select a Boundary, hover over the edges. To select a boundary point hover over it.
2. To select an EBL hover over the ends or the shaft, depending on whether the EBL is centered on a boat or lat/long the right click actions will be different. The popup menu list selections should be self explanatory.

When you have right clicked and selected an action, for example to move a boundary, text point or boundary point, the point will be highlighted with a yellow dot. Complete the move by dragging and releasing. For editing any characteristics such as color, line thickness, font, etc, use 'Properties', but if you just want to move a point select 'Move'. To move a point you will need to right click and select move. Having selected move you will then need to put the cursor over the selected object, push and hold the left mouse button and drag the object to where you want it. When you let go of the left mouse button the cursor (what ever it was showing before) should revert to the standard pointer and the 'move' process is terminated. If you want to move the object again, you will have to right click again to get the popup and repeat the process.

There are multiple ways to access an object’s Properties .

It is also possible to drill down into an object if it is multi-part, i.e. get a Boundary properties dialog displayed then right click or double click any line showing a Boundary point and the properties for that point will be displayed.

When moving an object you can move it in any direction just by holding the left hand mouse button down and dragging. If you want to constrain the movement to horizontal or vertical you need to use the Ctrl key to only allow vertical movement or the Shift key to only allow horizontal movement. If you release the key whilst dragging the constraint is removed. You can press and hold one of the two keys at any time during the movement, the constraint only applies when the key is held down. Additionally, when used with EBL pressing Ctrl + Shift at the same time, will constrain the angle value and allow movement along the angle. This will also work when perpendicular line is checked.

A boundary can be moved as a single object or a single line of the boundary can be moved. The default action is to move the whole boundary, but you can select 'Move Boundary Segment' from the right mouse button popup menu.

If you have two or more boundaries you can select these and merge the boundaries together. This is accomplished by hold the Ctrl key down then left mouse clicking on the boundaries you want to merge. Each boundary selected will flicker showing it has been selected. If you then right click on a boundary you will be presented with a merge popup. This will allow you to merge and keep the current boundaries, this draws a bounding boundary around the selected boundaries. If you select merge and delete you will draw a bounding box around the boundaries then the original boundaries will be deleted. There is no undo, so care needs to be taken.

This allows drawing of a closed path joining all points that of the path. The smallest Boundary has two points, but normal Boundaries will have three (triangle) or more points. There is no limit to the number of points, or the size of the Boundary. When drawing points that have already been placed will be connected togther with the path line. A rubber band line will be drawn that follows the cursor. The boundary fill may appear incomplete or strange at this point. However, when the final point is place and the create process is finished it will correct itself and display the boundary fill correctly.

If a point is placed in the wrong location carry on laying the other points. When you have finished the create process you can then edit the boundary and 'Move', 'Delete' or 'Add' more points to the boundary. If the whole boundary is in the wrong location it can be moved as a whole from the right mouse click menu.

The types of boundary you can draw, which can be easily changed after creation if it is wrong, are:

Please Note that these Types (exclusion, inclusion, neither) are Graphical only, and WatchDog does not use them in setting its internal alarms. We recommend that these graphic types be used appropriately to conform with the type of alarm that will be set from within WatchDog, however they will have NO EFFECT on the WD alarm type.

The type of boundary may change what other plugins do with the information, or how it is displayed. If using the Watchdog plugin and you set the boundary anchor watch the alarm will go off if you move outside of the boundary. If you are motoring/sailing and you have a proximity boundary watch set then the alarm will go off if you get closer than the specified distance. The first type of boundary should be an 'Inclusion' boundary and the second should be an 'Exclusion' boundary.

Note: A Boundary is a line joining two or more Boundary Points together. As such, each Boundary Point can have the same capabilities as individual Boundary Points.

This allows the placing of individual points on the chart. They are very similar to 'Marks' that can be dropped by OpenCPN. However, they have the capability of being 'Exclusion', 'Inclusion' and 'Neither' boundary points. This is demonstrated when Range Rings are Displayed.

Please Note that these Types (exclusion, inclusion, neither) are Graphical only, and WatchDog does not use them in setting its internal alarms. We recommend that these graphic types be used appropriately to conform with the type of alarm that will be set from within WatchDog, however they will have NO EFFECT on the WD alarm type.

Boundary Points continue to be placed on the chart until the drawing create mode is terminated. This allows the placing of as many points with single mouse left clicks as the user wishes.

This allows the placing of individual Text Points on the chart. They appear very similar to Boundary Points, but they allow the displaying of multi-line text in the desired font. They can have range rings, but these cannot be filled.

The text top left corner of the text is the reference point. There are 7 provided locations:

The amount the box edge is offset is controlled by 8 settings in the opencpn ini/conf file. You will find them called:

These are not in any dialog box as they are very unlikely to be modified.

Changing the font in the properties box does not apply the font until the OK button is pressed on the properties box. The word 'Example' should change to show you the font selected. Changing the font in the properties box does not apply the font until the OK button is pressed on the properties box. The word 'Example' should change to show you the font selected.

When a Text Point is created the 'natural' scale at which it is created is stored. This is then used to determine what to show when scaling to larger scales. Currently at twice the natural scale the text gets hidden and at 8x the natural scale the text box gets hidden. This is currently hard coded.

To display text for the Text Point you will need to open the properties for the Text Point and fill in the 'Display Text' tab. This is simple text and does not allow individual formatting of different parts of the text. You can pick the font and the font metrics to use for all the text associated with one text point.

The EBL always starts attached to the boat with the far end of the line being placed by left clicking the chart. The default action for the end point is set in the main properties dialog. The end point can either be fixed to a Latitude and Longitude or move along with the boat. This allows the EBL to show the boat moving against a fixed point, i.e. passing a reef, or to show other objects moving relative to the boat, i.e. when the boat can tack to get around a bouy.

The EBL can be detached from the boat to allow placing of the start point where the user left clicks. The EBL can also then have the start point centerd on the boat but not move or re-attached to the boat.

Variable Range Markers (VRM’s) can be displayed as part of the EBL, by checking a box on the EBL properties (or set the default on the OD properties) and a range ring will be drawn based on the start point. If the end point of the EBL is moved the range ring will move with that point. This allows easily setting up of safety rings around a boat. The plugin provides additional information when moving the end point of an EBL/VRM

End Points A & B of an EBL can be in several states:
1. Associated with Boat position (boat lat long) - Moving with the boat.
2. Associated with a fixed position (lat long) - Not Moving with the boat.
3. When offset Point B is associated with Boat position (lat long) it moves relative to the boat position and stays at the same angle.

Right click selections for EBL are
1. When the EBL start point is attached to the boat… Pick a new start point.
2. When the EBL start point is not on the boat.. Center on moving boat or Center on Lat/Lon (not fixed to the boat)

This flexibilty is useful for Dead Reckoning to have “Fixed” EBL markers.

The default color is the same as for a 'Boundary Point' and it will draw 1 range ring. If you want to change that then you will need to get to the start point properties (double click the EBL and double click the first point), or if the first point is clearly visible, just go to its properties (right click the point and select properties) and you can change the number of rings, the colors. The rings cannot be filled.

The VRM colour, by default is set to the same as the default for a Boundary Point, but once you change the VRM color to be different from the Boundary Point default then it will stay this way, unless you select the match option in the right click menu.

There are two ways of changing the VRM color:

It may seem strange at first to use an EBL to give you the VRM, but it makes selecting the VRM easier so that it can be dragged to the size required as there is a well defined point that can be selected. This is particularly true if you have many VRM’s at one time.

It is not necessary to loop through the preferences to enable the VRM for one EBL–the settings pop-up double clicking the EBL has all the necessary entries.

The popup for EBL’s contains both the forward and back bearing.

The main properties dialog in the general tab sets whether to use magnetic bearings or true. If magnetic is used then if you have the World Magnetic Model installed the variation will be used from that plugin. If not you will, currently, need to set 'UserMagVariation=0.00' in the ocpn_draw_pi section of the config file as there is no setting in the properties dialog for this.

This draws a Dead Reckoning line with multiple points along it starting at the boats current location. As mentioned above, this tool does not use the mouse click to draw on the chart, rather it uses it to display a dialog box where the DR information can be entered. When the 'OK' button is clicked the DR will be created and drawn on the chart. At this point the line can be modified by changing the points that make it up. However, this may make the DR line not reflect what you expect as neither the time/distance between points is maintained, nor is the COG/SOG. So the DR line at that point becomes more of a line with possibly little meaning in the context of DR.

This draws a segment of a torus or doughnut. The centre is the boat and the angle and size is determined from the two points that are used to describe the GZ. When the GZ tool is selected the cursor will change to a pencil and a line will join it to the centre of the boat. When the left mouse button is clicked the first point of the GZ is dropped. Now when the mouse pointer is moved an angular segment of a torus is drawn, the size of which is determined based on where the mouse cursor is. The second point is dropped when the left mouse button is clicked. This completes the drawing of the GZ which will now be the default colour and filled in with a hatch of the default colour.

The GZ can rotate with the boat and be maintained with the heading or the coarse over ground. Or it can maintain its position relative to the boat irrespective of which direction the boat is moving. This is set in the default propertiesd but can also be changed for each individual GZ.

Annex to IMO res.A893(21)-Guidelines For Voyage Planning. Section 4- Appraisal

Annex to IMO res.A893(21)-Guidelines For Voyage Planning. Section 6- Monitoring, point (j)

This allows drawing a line which offset from a centre line by a specified amount. This offset line will move with the boat and can either rotate with the boat or stay at a specified angle. Drawing a PIL is the same as drawing an EBL. The index line only shows up when the centre line has been drawn.

Each PIL centre line can have multiple offset lines. To create more than the first line right click the centre PIL line and select 'Add Index Line'. A new index line will be drawn based on the default settings.

End Points A & B of an PIL can be in several states:
1. Associated with Boat position (boat lat long) - Moving with the boat.
2. Associated with a fixed position (lat long) - Not Moving with the boat.
3. When offset Point B is associated with Boat position (lat long) it moves relative to the boat position and stays at the same angle.

Right click selections for PILL are
1. When the EBL start point is attached to the boat… Pick a new start point.
2. When the EBL start point is not on the boat.. Center on moving boat or Center on Lat/Lon (not fixed to the boat)

The offset line has its own properties box which can be accessed by either right clicking the offset line or by double left clicking the offset line.

Each offset line can be moved using either left drag (if enabled) or right clicking the line and selecting move.

How to use PIL Good Parallel Index Line video link

How to plot for Collision Avoidance Collision Avoidance Plotting Part1 of 3

You can display the point properties by either double left mouse clicking on the particular line you want in the Points list or by right mouse clicking on the line, once it has been selected, and selecting 'Boundary Point Properties' from the popup menu. If you want to remove a particular point then left click the line to select it. Then right mouse click on the point and select 'Remove Selected' from the popup menu.

These are the properties for the selected Boundary Point. Any changes here will be made to the selected Boundary Point and, if the 'OK' button is clicked, will be preserved over a restart.

This allows you to stop displaying the Boundary Point on the screen and change the GUID if you want. You will need to click 'OK' to save the changes.

This tab controls the text that is displayed for the Text Point. Any changes here will be made to the selected Text Point and, if the 'OK' button is clicked, will be preserved over a restart.

This tab is used to create and modify the text that will be displayed with the Text Point. It also allows the setting of values for an individual Text Point where as in the Preferences you settup the system wide settings.

This is the same as for a Boundary Point

These are the properties for the selected EBL Point. Any changes here will be made to the selected EBL Point and, if the 'OK' button is clicked, will be preserved over a restart.

This is the same as for a Boundary Point.

These are the properties for the selected DR Point. Any changes here will be made to the selected DR Point and, if the 'OK' button is clicked, will be preserved over a restart.

This is the same as for a Boundary Point

Copy and paste Lat/lon point

In any of the 'Point' property dialogs you can right click in either the Lat or Lon and get a drop down menu where you can select:

These will either copy/past in the selected box or will copy/paste both the Latitude and Longitude at the same time.

This setting determines whether a dialog box will be shown asking for conformation about deleting any objects. With it checked you will be asked to confirm all deletes, with it unchecked you will be able to delete any object without being asked for confirmation. If you do delete an object by mistake and you have 'Nav Object Backups' set to more than 0, you will be able to use one of those backups to restore your objects.

This setting saves the position of each dialog over a restart. If the user moves a dialog it will be in the same position when it is displayed after a restart. If this setting is not checked the default position, centre of the OCPN screen, will be used when the dialog is first displayed after a restart

If this is checked and there is a magnetic variation available then this will be applied to all angles that are used within the plugin. If it is checked and there is no magnetic variation available it will assume a '0' variation.

This setting allows dragging objects by placing the mouse over the object, pressing and holding the left mouse button and dragging the object to the desired location.

If this setting is off you will need to right click on the object to get the popup menu and select move from that. Then you can press and hold the left mouse button and drag the object.

A word of warning from user Redog: If “Allow Left Mouse Button Drag” is checked it is very easy to move your entire boundary or zone to a new location, thus changing all coordinates of waypoints you may have painstakingly entered. If you only intend to move 1 waypoint leave unchecked and use right click and move waypoint. If you intend to move entire zone check this option, it is a brilliant concept and very useful.

This setting determines how many backups to keep of the navigation objects file. The location of the files can be found in the opencpn.log file. Each time OpenCPN stops a new copy of the navigation obj file will be created. The latest file is called 'ODnavobj.xml'.

This is the percentage of the screen size distance from the edge that will cause the screen to pan when using the drawing tools. The bigger this number the further from the edge of the screen your pointer will be when the screen starts panning.

This is the same as above, but is used after a drawing tool is picked but before the first object is created. This is supplied so that the screen does not start panning if you move your pointer off of the toll bar near the edge of the screen.

The plugin allows you to use two graphical methods of selecting the tool you wish to draw with:

This setting determines if the tool bar is display and has three settings

This setting allows the user to set all settings back to the default value. If the button has the label 'Yes' and it is clicked this will ensure that no settings are saved when OCPN is shut down. The text of the label will be changed to 'Remove OCPN_Draw setting and restore to default on restart (Yes)' to indicate what will happen. The button label will now say 'No' indicating what will hapen if it is clicked again.

This is the color of an active Boundary Line
Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the default color to use for any active Boundary fill hash. When selected a standard, platform dependent, color picker will be presented. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an inactive Boundary Line.
Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the default color to use for any inactive Boundary fill hash. When selected a standard, platform dependent, color picker will be presented. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the Boundary Line in pixels. It can be a value between 1 and 10 pixels.

This defines how the Boundary Line is drawn. It can be one of the following:

Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800×1900 the difference between the line types may be difficult to see.

This allows the setting of how transparent the fill hash is. A value of 0 means that it is fully transparent and a value of 255 is that it is fully opaque. The term density is used as it seemed clearer, i.e. low density - you can see through it, high density - you cannot see through it.

This defines, in pixels, how wide the hash is around the outside Boundary Line when the Boundary is of type 'Inclusion'.

This radio button selection sets the default type for all Boundary. Points.

This sets whether to show or not the boundary points on a boundary.

This is not really relevant to a Boundary Point at the moment, but may become useful if other items/capabilities are added

This is the default setting for showing the Boundary Point name. Currently Boundary Points are created with the name empty/blank so nothing displays.

This is the default icon to use for all Boundary Points. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual

Boundary Points can have range rings associated with them. To show the rings by default this setting needs to be checked.

This radio button selection sets the default type for all Boundary Points.

This allows the setting of how transparent the fill hash is. A value of 0 means that it is fully transparent and a value of 255 is that it is fully opaque. The term density is used as it seemed clearer, i.e. low density - you can see through it, high density - you cannot see through it.

This defines, in pixels, how wide the hash is around the outside Boundary Point Range Ring when the Boundary Point is of type 'Inclusion'.

This defines the number of range rings to show if they are selected to be shown. If Zero is selected, then there will be no range ring shown.

This is the gap between sucessive range rings. The measurement this is using is defined in the Distance Unit' setting

The unit of measurement to use for the range rings gap. It can be:

This is the default color to use for any Boundary Point Range Ring. When selected a standard, platform dependant, color picker will be presented. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the range rings when drawn in pixels. It can be a value between 1 and 10 pixels.

This defines how the Range Rings are drawn. It can be one of the following:

Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800×1900 the difference between the line types may be difficult to see.

This is the default icon to use for all Text Points. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.

This selects where the text is positioned relative to the location of the Text Point. If you show an Icon it will be easier to see and interact with the text on the screen. If you do not use an Icon it may be easier to use the Path Manager to get to the Text Point.

There are 7 different locations:

This is the color that the default Display Text will have. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

When a Text Point displays text it will have a colored background to help it stand out from the underlying chart. This is the default color of the background box. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This allows the setting of how transparent the background color. A value of 0 means that it is fully transparent and a value of 255 is that it is fully opaque. The term density is used as it seemed clearer, i.e. low density–you can see through it, high density–you cannot see through it. The default density is 100.

This selects either Font metric based sizing or Charcter count for wrapping the displayed text. In Font Based the font being used will determine where the wrapping occurs. In Character Based the count of the characters will determine where the wrapping occurs.

Depending on the selection of Maximum Width Type will determine the meaning of this number. In Font Based it is a virtual number more closely related to the number of pixels available to display the text. In Character Based this is the count of the maximum number of characters allowed on any line.

In Font Based the text will only be wrapped if there is a space in the text. Also, if the value is set too low there will be now wrapping of the text. To use this method you will need to tune your value dependent on the font being used. There is no relationship between this number and the number of characters that will be used on any particular line.

In Character Based this is the maximum number of characters that will be displayed on any line. Line breaks will occur on spaces, if they are available, but if there are no spaces then the line will be broken at this number of characters.

This is the default font to be used for the 'Display Text'. The 'Fonts' button will allow picking of any font that is installed on the system. You can pick the Family, Style and Size of the font. This is presented by a platform specific font picker. The current font that will be used is shown by the work 'Example' which will be drawn using the font selected.

This is the default for when the Display Text of a Text Point is shown.

This is the color of an active generic Path if there is no specific type. Currently this is not used as there are no unspecified Path types in use. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an inactive generic Path if there is no specific type. Currently this is not used as there are no unspecified Path types in use. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the Path Line in pixels. It can be a value between 1 and 10 pixels.

This defines how the Path Line is drawn. It can be one of the following:

Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800×1900 the difference between the line types may be difficult to see.

This is the default icon to use for the start point of an EBL. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.

This is the default icon to use for the end point of an EBL. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.

This is the color of an active EBL. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an inactive EBL. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the EBL in pixels. It can be a value between 1 and 10 pixels.

This defines how the EBL is drawn. It can be one of the following:

This the default for all EBLs. This fixes the End Point of an EBL such that when the boat moves the end point does not. If this is left uncheck the end point of the EBL will move with the boat so the EBL always has the same length and bearing.

This is the default for all EBLs. If checked a direction arrow will be displayed on the EBL at or near the end point. This helps show the direction of the EBL.

This draws a Variable Range Marker (Ring) centered on the start point and sized to go through the end point.

This shows a line drawn perpendicular to the end of the EBL. The line uses the same attributes as are applied to the EBL itself.

The EBLs that are created can be:

This is the color of an active DR Line Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an inactive DR Line. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the DR line in pixels. It can be a value between 1 and 10 pixels.

This defines how the DR line is drawn. It can be one of the following:

This is the default speed over the ground to use when calculating the DR line.

This is the default course over ground to use. The type, True or Magnetic, is determined by the setting in the General tab.

This is the default length of the DR line.

This is the default interval to place points along the DR path.

This is the default length type to be used, either Time or Distance.

This is the default interval between placing points, either Time or Distance.

This is the default distance units to use, either Kilometers or Nautical Miles

This is the default time units to use, one of Minutes, Hours or Days

The DR lines that are created can be:

This is the default icon to use for the all points of a Dead Reckoning line. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.

Boundary Points can have range rings associated with them. To show the rings by default this setting needs to be checked.

This defines the number of range rings to show if they are selected to be shown. If Zero is selected, then there will be no range ring shown.

This is the gap between successive range rings. The measurement this is using is defined in the 'Distance Unit' setting

The unit of measurement to use for the range rings gap. It can be:

This is the default color to use for any DR Point Range Ring. When selected a standard, platform dependant, color picker will be presented. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the range rings when drawn in pixels. It can be a value between 1 and 10 pixels.

This defines how the Range Rings are drawn. It can be one of the following:

Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800×1900 the difference between the line types may be difficult to see.

This is the default icon to use for the first point placed when creating a Guard Zone (GZ). There is a set of OpenCPN icons that can be used as well as user defined icons.

The method of adding user defined icons is documented in the main OpenCPN manual.

This is the default icon to use for the second point placed when creating a Guard Zone (GZ). There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.

The method of adding user defined icons is documented in the main OpenCPN manual.

This is the color of an active Boundary Line
Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the default color to use for any active Boundary fill hash. When selected a standard, platform dependent, color picker will be presented. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an inactive Boundary Line.
Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the default color to use for any inactive Boundary fill hash. When selected a standard, platform dependent, color picker will be presented. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the Boundary Line in pixels. It can be a value between 1 and 10 pixels.

This defines how the Boundary Line is drawn. It can be one of the following:

Some of these may not display well on your screen depending on the resolution you are using. It is known that when using high resolution screens, i.e. 3800×1900 the difference between the line types may be difficult to see.

This allows the setting of how transparent the fill hash is. A value of 0 means that it is fully transparent and a value of 255 is that it is fully opaque. The term density is used as it seemed clearer, i.e. low density - you can see through it, high density - you cannot see through it.

This locks the GZ to either the heading the course over ground of the boat. If this is unset then the GZ will move with the boat but will be at a fixed direction from the boat irrespective of its course or heading.

This setting works with the 'Rotate with Boat' specifying whether to use the current heading or the course over ground.

This defines, in pixels, how wide the hash is around the outside Boundary Line when the Boundary is of type 'Inclusion'.

The GZs that are created can be:

This is the default icon to use for the start point of an PIL. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.

This is the default icon to use for the end point of an PIL. There is a set of OpenCPN icons that can be used as well as user defined icons. The method of adding user defined icons is documented in the main OpenCPN manual.

This is the default offset that the PIL takes from the centre line.

This is the color of an active PIL centre line. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an inactive PIL centre line. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an active PIL offset line. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the color of an inactive PIL offset line. Selection is by a platform specific color picker. This will allow the color to be any RGB (Red, Green, Blue) color that is supported by the platform.

This is the width of the PIL centre line in pixels. It can be a value between 1 and 10 pixels.

This defines how the PIL centre line is drawn. It can be one of the following:

This is the width of the PIL offset line in pixels. It can be a value between 1 and 10 pixels.

This defines how the PIL offset line is drawn. It can be one of the following:

This defines how the EBL is drawn. It can be one of the following:

Parallel Index Line Persistence

The EPILs that are created can be:

This page provides useful information in the event you have problems with the Plug In. Please provide the version number and the patch number with any reported incident. You should also provide the version number of OpenCPN as this will help identify where the issue may be.

This page provides information on the interaction of this plugin with the Watchdog plugin. This shows when alarms should ring for various boundary types.

==