[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Philip Wyett philipwyett@dsl.pipex.com. Last updated 20 Janurary 2004.
These instructions are for building Crystal Space with Cygwin a GNU compiler for Windows created by Red Hat Inc. and other third party contributors.
A full or extensive Cygwin installation can take up alot of hard disk space. Please be careful if installing on low free space disks. A typical install can be around 400MB and large above 700MB.
Cygwin uses a custom setup application for installation of Cygwin which can be obtained from their official website.
The installation program `setup.exe' must be downloaded to your system. You can download it using the following link:
http://www.cygwin.com/setup.exe
First, go to the location where you downloaded the Cygwin `setup.exe'. It is suggested that you download it into a directory of its own since it will place additional files in that directory later on when it downloads the actual Cygwin packages.
Click/double click on `setup.exe' icon to begin the installation process.
You will first be prompted with a Cygwin welcome dialog. It provides basic information about the setup program, such as its version number.
Click on the Next button to continue.
The next dialog you will see is the Choose a Download Source dialog. Here you need to choose if you wish to download and install directly from the internet or download to your system so you can install it later. Cygwin, like Linux, can install, uninstall, and update using this program. So, the decision is whether or not you want to download and keep the downloaded files around in order to avoid a large download at a later date if you re-install. If you have a fast Internet connection, then you can download and install directly without saving the packages to your disk drive. This is a matter of personal preference which we leave to you.
After deciding, click on the Next button to continue.
Note: For the purposes of this discussion, it is assumed that you are installing directly from the Internet.
The next dialog you will see is the Select Root Install Directory dialog. The first thing to choose is the location of where Cygwin should be installed. It is suggested that you install in a directory named `cygwin' at the location of your choice. Point the installer at that directory.
The next thing to decide, if you are a system administrator, is if you want any other users of that computer to have access to Cygwin. Also you are asked if you wish to use DOS text file line-ending format (CR/LF) or Unix format (LF). This is all a matter of preference for the user. If you are a pure Windows users it is suggested that you choose the DOS option. However, if you might move files to a Unix machine, for instance, it might be favorable to use the Unix option.
After deciding on a root install location and other options, click on the Next button to continue.
The next dialog you will see is the Select Local Package Directory dialog. This directory is corresponds to the location where you placed the Cygwin `setup.exe' program.
If they correspond click on the Next button to continue.
The next dialog you will see is the Select Your Internet Connection dialog. This lets you specify the type of connection you have. Most of the time it will be a Direct Connection you have. However, if you access the Internet via proxy server, then select that option and enter the necessary information.
After choosing your internet connection type, click on the Next button to continue.
The next dialog you will see is the Choose A Download Site dialog. Choose a download location in or as close to your own country as possible.
After choosing the closest download location, click on the Next button to continue.
The next dialog you will see is the Select Packages To Install dialog. This shows a tree with selectable packages in the branches. If you have sufficient disk space and a high-speed Internet connection, you may wish to install the majority of the tools. On the other hand, if you want to install only a minimum set of tools, choose the packages in the Devel branch and, at a minimum, jpeg, libpng, opengl, python, w32api, and zlib from the Libs branch.
Note: You do not need to install the Apache server, XFree or Games packages. Also if you miss anything first time round you can simply repeat the install process and install the package(s) you missed.
Important: The above Select Packages To Install section is subject to change.
After choosing the packages for installing, click on the Next button to continue.
At this point the installer will download and install the selected packages and perform post build steps, such as the generation of documentation, etc.
The next dialog you will see is the Create Icons dialog. If you are performing a fresh install and want these icons, then check the boxes. If you are updating you need not check the boxes if you already have the icons.
After making your selection, click on the Finish button to continue.
After all this you will be prompted with a dialog to tell you that the installation is complete. Click on the Ok button to finish the installation process.
The Microsoft DirectX 8 SDK which the Cygwin port uses is one created especially for it. You can download it via the following link.
ftp://sunsite.dk/projects/crystal/support/cygwin/DXforCygwin.zip
To install, extract the archive to a location of your choice. Open a Cygwin Bash prompt and navigate to where you extracted the files (that is, the directory which contains the `Makefile'). Next, at the command prompt type `make install'.
The Open Dynamics Engine library is required for successful compilation of the Crystal Space ODE physics plugin. You can obtain the latest source tar ball via the web link below.
http://opende.sourceforge.net/
In order to successfully compile, you will need to do a couple of things. Open a Cygwin Bash prompt and navigate to where you extracted the files (that is, the directory which contains the `Makefile').
Sadly, unlike on other platforms, during configuration the lib directory would be created for you. However, under Cygwin it will not be, so you must do it yourself. At the command prompt enter the following command and hit return.
mkdir lib |
Next, it is necessary to update the configuration for the Cygwin platform. Open the file `config/user-settings' in your favorite editor and change the following line from:
PLATFORM=unix-gcc |
to:
PLATFORM=cygwin |
Make sure you are back in the directory containing the `Makefile' before continuing. From the Bash prompt issue the following command and then hit return.
make configure |
Once configuration is complete and you have been returned to the Bash prompt, enter the following command and hit return inorder to compile the ODE library.
make ode-lib |
After once again being returned to the Bash prompt, you can proceed and install ODE into Cygwin. The easiest way to install ODE is as follows. Copy the `lib' and `include' directories and paste them into your Cygwin /usr directory. You will be prompted about overwriting files, and you should just answer `Yes to All'.
In order to successfully build the optional jng plugin, you must have mng installed on your system. You can download it via the following link.
ftp://sunsite.dk/projects/crystal/support/general/libmng-1.0.4.tar.gz
To install, extract the archive to a location of your choice. Open a Cygwin Bash prompt and navigate to where you extracted the files (that is, the directory which contains the `install-sh'). Next, at the command prompt type `make install'.
Open a Cygwin Bash prompt via the desktop shortcut or the via item in the Programs menu. Navigate to the `CS\' directory and issue the following commands:
./configure make depend make -k all |
Note that making the `depend' target is optional and can be omitted if you do not plan to make any changes to the Crystal Space source or header files.
The `-k' option used in the `make -k all' command instructs the project builder to ignore errors and continue compiling regardless. This can be useful in cases when localized errors appear in the project since often they affect only a single module.
Finally, you can install the Crystal Space SDK as follows:
make install |
You can also insert the `clean' makefile target into the `make' command, as follows:
make -k clean all |
This will first remove all object files, libraries, etc. from the `out\WIN32\X86\debug' directory and then re-build the entire project.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |