Difference between revisions of "Building CEED for Windows"

Revision as of 06:36, 11 June 2014

(Written by Ident (Lukas Meindl). Works to date: 9. June, 2014) (Modified by Nickenstein79 on 11th June, 2014)

The following instructions need to be done in the presented order and are created for the currently available version of CEED and could therefore be outdated at some point. Please notify us if you think this is outdated.

Clone CEED repository

Using whatever source-control software you use (I'm using TortoiseHG) clone the following CEED repository, and verify that you are on the v0-8 branch. https://bitbucket.org/cegui/ceed

Installing the prerequisites

When downloading/installing binaries, be sure to get the version which matches your version of visual studio, for instance choose the 32-bit and VC9 (visual studio 2008) versions of the binaries if that is what you are using to build. (or VC10 / VC11 / VC12 if you are building with those.)

Installing Python

• Get Python 2.7.7 (32 bit version) for Windows and install it: https://www.python.org/downloads/
• Add your Python install folder path to the PATH variable in your Windows environment variables, e.g.: C:Projects\Python27
• Now add the Scripts folder to the PATH environment variable, e.g.: C:\Projects\Python27\Scripts & C:\Projects\Python27\Tools\Scripts (depending on which of those folders exists in your install)
• Open up a dos-command-prompt (cmd.exe) with admin rights and type "python" - See if you get something written into the console, such as "Python 2.7.6 (default [...]", if this is the case then the install worked.

Installing pip

• Install the latest pip distribution: First download get-pip.py : http://pip.readthedocs.org/en/latest/installing.html
• Open up a dos-command-prompt (cmd.exe) with admin rights, change to the folder to which you downloaded "get-pip.py" by using the "cd" command, e.g.: cd "A:/Downloads/Not porn"
• Type "python get-pip.py" and click enter in the dos-command-prompt
• pip should now be installed
• Afterwards enter "pip" and click enter. You should get some sort of information about pip now, if the install succeeded.

Installing pyside

• Now you can install pyside easily with the following command: "pip install -U PySide"
• You should get a console output notifying you of a successful install

Installing pyOpenGL

• pip install requires a C compiler for this and some other things. We suggest just installing pyOpenGL on Windows from this installer: https://pypi.python.org/packages/any/P/PyOpenGL/PyOpenGL-3.0.2.win32.exe

Installing boost binaries

• We also need to install boost. You can use an .exe file for this that will install the necessary binaries from this download page: http://sourceforge.net/projects/boost/files/boost-binaries/1.55.0-build2/ (Be sure to get the version which matches the version of msvc you intend to build with. If you you use MSVC2008, then get the download with 'msvc-9.0' in the name, if you use MSVC2010 get the version with 'msvc-10.0' in the name, etc...)

• Note : If you have multiple version of MSVS on your machine, it is safe to install different versions of these boost distributions into the same folder, as the *.h and *.hpp files are all identical, and the compiled binary libs all go into sub-folders specific to that version of msvc. (It is these lib folders that we will pointing cmake to in the next section.)

setting up cmake

• Clone CEGUI v0-8 from the CEGUI repository to a new local folder https://bitbucket.org/cegui/cegui/branch/v0-8 , e.g. to C:/cegui-v0-8
• Check that the branch of your working directory is really v0-8 after cloning, if not then update to the latest v0-8 commit
• Add the usual CEGUI dependencies to their usual spot (dependencies folder)
• Open CMake and set the source code folder to your new local folder, e.g.: C:/cegui-v0-8 and the binaries to for example: C:/cegui-v0-8/build

• When you hit 'configure' in cmake, it will fail to automatically detect boost, and so the following paths _MUST_ be set manually by the user:

These are directory paths and file-paths to locations inside the boost and Python distribution that you installed in the previous steps. (Here are examples of what they are set to on my machine)

examples

• • Boost_PYTHON_LIBRARY_DEBUG C:/boost_1_55_0/lib32-msvc-9.0/boost_python-vc90-mt-gd-1_55.lib
  • Boost_PYTHON_LIBRARY_RELEASE C:/boost_1_55_0/lib32-msvc-9.0/boost_python-vc90-mt-1_55.lib
  • Boost_SYSTEM_LIBRARY_DEBUG C:/boost_1_55_0/lib32-msvc-9.0/boost_system-vc90-mt-gd-1_55.lib
  • Boost_SYSTEM_LIBRARY_RELEASE C:/boost_1_55_0/lib32-msvc-9.0/boost_system-vc90-mt-1_55.lib
  • Boost_INCLUDE_DIR C:/boost_1_55_0

CMake may correctly auto-find the following Python variables, but if fails then set them manually, here are examples of mine:

examples

• • PYTHON_INCLUDE_DIR C:/Python27/include
  • PYTHON_LIBRARY C:/Python27/libs/python27.lib
  • PYTHON_EXECUTABLE C:/Python27/python.exe

• Unselect Building the samples and select only OpenGL3 and OpenGL out of the available renderers to build
• Select CEGUI_BUILD_PYTHON_MODULES so that this option is checked
• Click configure and generate, it should work without errors

Build pyCEGUI

• Open the generated solution in the build folder and build it (You need 'Release' mode only)
• Go for a very long walk along a very long beach. Building pyCEGUI & pyCEGUI_Renderer will take quite a long time.

Setup pyCEGUI dll dependencies

• Put the following dependencies of CEGUI into your build's bin folder, e.g.: C:/cegui-v0-8/build/bin
  • From your CEGUI dependencies folder (e.g.: C:/cegui-v0-8/dependencies) :
    • freetype.dll
    • glew.dll
    • pcre.dll
  • From the boost binaries folder (e.g.: A:\Programs\boost_1_55_0\lib32-msvc-9.0 )
    • boost_python-vc90-mt-1_55.dll (Or higher, depending on your version of MSVS & the boost lib folder you are using.)

Run CEED

• Go to your CEED bin folder, e.g.: A:\Programs\CEED\bin
• Edit runwrapper.bat so that the relative path CEGUI_BUILD_PATH matches your the CEGUI folder you just compiled to
• Run the batch file, and the CEED editor should be launched

CEED-Migrate

You can also migrate your old CEGUI_0.7.x data files by running "Python ceed-migrate [params]" or by creating a batch file similar to runwrapper.bat to process all of your old data files.