Skychart

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== How to install the software from the source code =====

==== Get the source code====

Create a new directory for the source code.
You have two ways to get the code:
  * Download the source file skychart_v4_xxx_source.tar.gz \\ to this directory and extract the files.\\  On Linux use : tar xzf skychart_v4_xxx_source.tar.gz  \\ On Windows use 7-zip available from: http://sourceforge.net/projects/sevenzip/

  * Or better clone or fork the [[https://git-scm.com/|git]] [[https://github.com/pchev/skychart|repository]] to get the last very last version and easily update with the daily changes. You need to do that if you want to send me some code change with a pull request.\\ The command is: \\ <code>git clone https://github.com/pchev/skychart.git </code>



==== Automated Compilation and installation ====

If you just want to compile the software without using the Lazarus interactive environment you can use the scripts available in the base directory.

Before running these scripts be sure to have the Free Pascal binaries in your PATH environment, this is where you find the fpcmake command.

In the base directory you also found the buildpkg.sh script I use to automatically build the packages for Linux and Windows.

=== For Linux and Mac===

<code>./configure [fpc=free_pascal_path] [lazarus=lazarus_path] [prefix=installation_path]
make
make install
make install_data
</code>

For example to install the complete software from source :

<code>sudo apt-get install build-essential lazarus 
git clone https://github.com/pchev/skychart.git
cd skychart
./configure fpc=/usr/lib/fpc/3.0.4 lazarus=/usr/lib/lazarus/1.8.0 prefix=/usr/local
make
sudo make install
sudo make install_data
sudo make install_cat1
sudo make install_cat2
sudo make install_pict
</code>

=== For Windows ===

  * Beware not to have another make command than the Free Pascal one in your path. \\
  * Manually compile the library getdss and plan404 with [[http://www.mingw.org/|Mingw]].\\
  * Install the command [[http://gnuwin32.sourceforge.net/packages/sed.htm|sed for Windows]].\\
  * Edit the file configure.cmd to adjust the values for sed=, fpc=, lazarus=, prefix=
  * You may have to adjust the scripts according to the Linux version because I not use them and they are probably out of date.  

<code>configure.cmd 
make
make install
make install_data
</code>


==== Interactive compilation ====

First, install the required components from src/skychart/component directory.

Click "Open Package", select "component/cdccomponents.lpk", click "Compile", "Install", accept to install anyway.\\
When the installer tells you to rebuild Lazarus say Yes.

You can now open the main project files skychart/cdc.lpi, select the build mode you want and compile.

Lazarus show by default the last form added to the project. To view the main form use the menu Project / Forms, and select f_main.

To run in debug adjust Run-Run Parameters-Working Directory to your CDC directory.

To reduce the executable size for production, select the Release build mode.



==== Install Lazarus ====

To know which version of Lazarus is require for a specific version of Skychart, install the binary version and look at the menu Help / About. There is a line that show the FPC and Lazarus version used.

Install Lazarus from http://lazarus.freepascal.org. See http://wiki.lazarus.freepascal.org/Installing_Lazarus for more information.

Launch Lazarus and open the menu Package - Install/Uninstall Packages.

Check that Pascalscript, Printer4Lazarus and TurboPowerIPro are installed.\\
If not, install them from lazarus/component :
  * printers/printer4lazarus.lpk
  * turbopower_ipro/turbopoweripro.lpk
  * PascalScript/Source/pascalscript.lpk

I use the following procedure to install or update Free Pascal and Lazarus on Linux with the cross compiler for Windows:
<code>cd ~/fpc
# svn co http://svn.freepascal.org/svn/fpc/branches/fixes_xxx
svn up
make clean
make build
sudo make install
make clean OS_TARGET=win32 CPU_TARGET=i386
make build OS_TARGET=win32 CPU_TARGET=i386
sudo make crossinstall OS_TARGET=win32 CPU_TARGET=i386
ver=`fpc -iV`
sudo ln -f -s /usr/local/lib/fpc/$ver/ppc386 /usr/local/bin
sudo ln -f -s /usr/local/lib/fpc/$ver/ppcross386 /usr/local/bin
cd ~/lazarus
# svn co http://svn.freepascal.org/svn/lazarus/trunk .
svn up
make clean
make OS_TARGET=win32 CPU_TARGET=i386 clean
make bigide
make OS_TARGET=win32 CPU_TARGET=i386 bigide
</code>



==== Naming convention for the program source ====

The following naming convention is used for the main project source code
to enable quick recognition of the destination of the units.

<code>
cdc.lpi         : The main project
pu_*.pas        : Form units with specific code only
pu_*.lfm        : Form definition
cu_*.pas        : Unit containing non-visual object.
u_*.pas         : Unit with generic code.
</code>

====Directory structure====

<code>
     |- src -|                            < base directory, compilation scripts 
             |- skychart |                < skychart module
                         |- component     < project component
                         |- library       < project library
                         |- ...
                         |- units         < all compilation object go here

             |- varobs   |                < varobs module 

             |- tools | - data            < the "data" directory structure require to run the progran
                      | - cat             < the basic catalogs, the program used to build them
                      | - ...             < other data files
</code>