1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171
| ----------------------------------------------------------------------
1. Overview
----------------------------------------------------------------------
a. Opencpn was built with the following objectives in mind.
i. Intended use as primary navigation interface for vessels
with full-time helm-visible navigational suites.
Other tools may be better for offline route planning, tide
and current prediction, online logging, etc.
ii. Quick startup and shutdown.
iii. Those and only those toolbar buttons really needed for
daily operation.
iv. Portability, thus wxWidgets core components. Currently
tested and in production use on W98, XP, OSx, and Linux.
v. Conventional ( i.e. popular and modern ) chart format
support. In the real world, this means BSB format raster
charts, and S57ENC format vector charts.
And, of course, opencpn is all GPL'ed (or equivalent)
Open Source code.
Personal Note:
Opencpn is in primary daily use as the navigation package aboard
M/V Dyad, a 48 ft trawler yacht cruising from Newfoundland to the
Bahamas yearly.
----------------------------------------------------------------------
2. Library Notes & Requirements
----------------------------------------------------------------------
a. External OGR/GDAL library support is deprecated from OpenCPN Version
1.2.4 and greater. The required support modules and classes are
integrated into the OpenCPN source tree. See src/mygdal.
b. iso8211 class support is required to build OpenCPN from source with
S57 ENC support. The relevant files are in the source tree as src/myiso8211.
These files are verbatim copies of the files by the same name in the
open source GDAL/OGR library Version 1.2.1.
Thanks to Frank Warmerdam and others for GDAL/OGR.
What an impressive body of work!
c. OpenCPN S57 ENC support works best with access to the OpenGL Utility
library GLU. GLU is used to tesselate large polygon areas into small
triangles for faster display rendering. If you cannot use, or do not have
the OpenGL Utility library, you may choose to build OpenCPN with internal
tesselator support. The internal tesselator is sub-optimal compared to GLU,
but it does work, if somewhat slower. OpenGLU is better.
See the Build Notes section for applicable tesselator configuration options.
d. OpenCPN requires WxWidgets Version 2.6.2 or greater. It has been tested
with the following wxWidgets hosts:
Universal/Native X11 (__WXX11__)
GTK2 (__WXGTK__)
MSWindows (__WXMSW__)
MAC OSx (__WXOSX__)
See below for information on obtaining and installing wxWidgets.
----------------------------------------------------------------------
3. Platform Specific Build Notes
----------------------------------------------------------------------
a. MS Windows
If you would like to build OpenCPN for MS Windows from source, perform
the following steps.
If you experience difficulties, post a note on the OpenCPN project forum
at sourceforge.net. The development team will try to help you out.
---------------------------
STEP 0: Background
---------------------------
OpenCPN for MS Windows (TM) is built using the Watcom C/C++ command line tools.
You may download (for free) the latest version from:
http://www.openwatcom.org/
Version 1.6 tools are current.
---------------------------
STEP 1: Download wxWidgets
---------------------------
To simplify the implementation of a near-identical user
interface across platforms, OpenCPN uses classes and
resources from wxWidgets, a portable GUI framework for C++
(and Python). You must download and build wxWidgets before
attempting to compile OpenCPN.
OpenCPN builds use wxWidgets 2.6.x series (or later) for
Microsoft Windows (MSW), available at
"http://www.wxwidgets.org/".
When you download and execute the MSW setup.exe program for wxWidgets,
the wxWidgets files will be installed to your system.
Make a note of the base install location, which will be something like
C:\wxWidgets-2.8.3
You will need this later.
------------------------
STEP 2: Build wxWidgets
------------------------
When you have downloaded and installed wxWidgets, you must
build it. The standard wxWidgets build procedures work fine,
and are dependent on your system build tools and environment.
See the README files in the wxWidgets installation directory.
For example, if you use the MSVC makefile build methodology, then
in the directory c:\wxWidgets-2.8.3\build\msw, the command
wmake -f makefile.wat
will build a statically linkable Debug configuration of wxWidgets.
Build the configurations for all the wxWidgets projects
corresponding to which configurations of OpenCPN that you want
to build. OpenCPN for Windows may be built in Debug and Release
configurations. OpenCPN can use either multithreaded static or
multithreaded dynamic libraries. Choose...
------------------------
STEP3: Set OpenCPN Options
------------------------
Set the required build options in file:
makefile.wat
See the comments within.
In particular, YOU MUST set the location of the installed wxWidgets
libraries. e.g.
WX_BASE = c:\wxWidgets-2.8.3
------------------------
STEP4: Build OpenCPN
------------------------
From an MS-Dos command line window, in the opencpn base directory, do:
wmake -f makefile.wat clean
wmake -f makefile.wat
The opencpn.exe, (debug version) file will be built in the .\debug_ directory.
For a release build, edit the file makefile.wat and change the definition of
BUILD to
BUILD = release
Then,
wmake -f makefile.wat clean
wmake -f makefile.wat
The release opencpn.exe file will be built in the .\release_ directory.
In either case, do:
wmake -f makefile.wat install
This will copy the appropriate files to the install location specified in
makefile.wat, typically c:\Program Files\opencpn
OpenCPN is now ready to run. |
Partager