Building

Prerequisites

Right now opengate does not provide binaries, but you can build opengate yourself. First of all you need to obtain the sources, install the necessary libraries and install a compiler or IDE on your system.

You will also need the following libraries and SDKs:

• =cmake 2.8.10

• =OGRE 1.8; < OGRE-1.9

• =CEGUI 0.8.2

• =OIS 1.3.0

• =vorbis 1.1.2

• =boost 1.48

For MSVC10

+ openal

Building on Linux

First create working path

mkdir -p opengate
cd opengate

Checkout sources:

git clone --depth=1 git://git.code.sf.net/p/opengate/code opengate
cd opengate

Create build directory

mkdir -p build
cd build

Start build

cmake ../
make

Building on Windows (MSVC)

Currently cegui seems to be broken with mingw so we build opengate with msvc-10.

Probably you need to build cegui and their dependencies.

I successfull compiled cegui and opengate using msvc10 with the following steps.. pls correct me if I'm wrong or there are better ways.
First, assuming all your work is done in one path called the source path $(SRC).

Get cegui-0.8.2 sources and dependencies and copy them in

$(SRC)/cegui/cegui-0.8.2
$(SRC)/cegui/cegui-deps-0.8.x-src

We using Ogre3D we need an OgreSDK, fortunatly there is a prebuild. Copy them to:

$(SRC)/OgreSDK_vc10_v1-8-1

Now we can build first cegui-deps. Go into the path and create a build directory.
I'm running msys, so I have a bash like shell. I guess the Windows cmd shell will do the job simlilar.

cd $(SRC)/cegui/cegui-deps-0.8.x-src
mkdir build
cd build
cmake .. -G "Visual Studio 10"
cmake --build . --config release
cmake --build . --config debug

copy the result into the cegui sources

cp -r dependencies/ ../../cegui-0.8.2/

build cegui with ogrerenderer:

cd $(SRC)/cegui/cegui-0.8.2
make build
cd build
cmake .. -G "Visual Studio 10"  \
-DCEGUI_OPTION_DEFAULT_XMLPARSER=EXPAT \
-DOGRE_H_PATH=$(SRC)/OgreSDK_vc10_v1-8-1/include/OGRE/ \
-DOGRE_LIB=$(SRC)/OgreSDK_vc10_v1-8-1/lib/release/OgreMain.lib \
-DOIS_H_PATH=$(SRC)/OgreSDK_vc10_v1-8-1/include/OIS/ \
-DOIS_LIB=$(SRC)/OgreSDK_vc10_v1-8-1/lib/release/OIS.lib \
-DCEGUI_BUILD_RENDERER_OGRE=True \
-DCMAKE_CXX_FLAGS="-I\"$(SRC)/OgreSDK_vc10_v1-8-1/boost\" -DBOOST_EXCEPTION_DISABLE -EHsc" \
-DCMAKE_SHARED_LINKER_FLAGS="-LIBPATH:\"$(SRC)/OgreSDK_vc10_v1-8-1/boost/lib\"" \
-DCMAKE_INSTALL_PREFIX=$(SRC)/cegui/cegui

cmake --build . --config release --target install

Note: if something goes wrong you can try to finetune your cmake configuration by using cmake-gui

Building opengate:

cd $(SRC)
mkdir opengate

copy opengate dependencies (in devAdds/opengatedeps.zip)

$(SRC)/opengate/deps
cd opengate
git clone --depth=1 git://git.code.sf.net/p/opengate/code opengate
cd opengate
mkdir build
cd build

cmake .. -G "Visual Studio 10"  \
    -DOGRE_HOME=$(SRC)/OgreSDK_vc10_v1-8-1/ \
    -DCEGUIDIR=$(SRC)/cegui/cegui \
    -DBOOST_ROOT=$(SRC)/boost_1_53_0 \
    -DBOOST_LIBRARYDIR=$(SRC)/opengate/deps/lib/

cmake --build . --config release

If you have the date repository installed in

$(SRC)/opengate/opengate/data

you can start the to start the client:

bin/opengateclient

Check commandline arguments to connect with a server

bin/opengateclient -h

This will be obsolete in the not so far future.

The client knows some command line options, please take a look at the help page by using the -h option.

If something is strange, please first check the configuration by using the -c option.

If you know a running server you can add the server ip with -s ip. You need a username to identify yourself to the server with -u username. Please note, if you don't choose a username you will no be connected to the server

Note, if the metaserver is up and running these options will be obsolete.

Everybody likes examples:

./bin/opengateclient -s localhost -u uniqe_pilot_name

This connect to server on localhost and use username uniqe_pilot_name

./bin/opengateclient -O

This connect to the default gameserver(if running), The username can be choosen ingame.

If something goes wrong (probably it will) there are some log files with more or less usefull informations.

• ogre.log -- graphic engine related
• cegui.log -- gui related
• OpenGate.log -- client related

Enjoy this first technical proof of concept.

Good Luck Pilot
Spom