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