1Ocular plugin for Stellarium
2============================
3
4Simulates various eyepieces.
5
6TODO
7====
8
9
10BUILDING THE PLUGIN
11===================
12
13Please note, these instructions are only directly applicable to Linux.
14Windows and OSX targets will probably require modification of the
15CMakeLists.txt file.
16
170.  Install and build the SVN version of Stellarium as per the
18instructions on the Stellarium wiki:
19
20  http://stellarium.org/wiki/index.php/Compilation_on_Linux
21
221.  Set the environment variable STELROOT to the root of the Stellarium
23source tree.  The Stellarium build directory is expected to be:
24
25  $STELROOT/builds/unix   (Linux)
26  or
27  $STELROOT/builds/macosx (Mac)
28  or
29  $STELROOT/builds/msys   (Windows)
30
312.  Create a sub-directory builds/unix, builds/msys or builds/macosx and
32change into that directory.
33
343. UNIX's:
35 Run:
36
37  cmake ../..
38  make
39  make install
40
41If all goes well, the relevant files should be built and copied to your
42~/.stellarium/modules directory.
43
444. Windows:
45   Run:
46   CD "External modules ROOT directory"/builds/msys
47   cmake -G "MSYS Makefiles" ../..
48   make && echo "BUILD WORKED" || echo "BUILD FAILED"
49   This will generate the dynamic module ocular.dll and the static binary
50   ocular_static.a in the "External modules ROOT directory"/builds/msys/src
51   The static module binary ocular_static.a will need to be shortened to
52   ocular.a to agree with the Stellarium call.
53
54If all goes well, the relevant files should be built in their respective folders:
55   Dynamic module: the ocular.dll must be copied to your $STELROOT\modules\oculars folder
56   along with the button icons and Module.ini
57   Static module: The Stellarium source will need to be re-compiled with the
58   respective USE_STATIC_PLUGIN_OCULAR:BOOL=1
59   The button icons and module.ini will need to be copied into your $STELROOT\modules\oculars folder
60
61
62
63