Ryzom

h1. Howto build Object Viewer Qt (OVQT) with Stlport on Windows

Thank you to Dnk-88 and Sfb.

h2. What you need

* Microsoft Visual Studio C++ 2008 Express Editions with SP1
> http://www.microsoft.com/downloads/details.aspx?FamilyID=f3fbb04e-92c2-4701-b4ba-92e26e408569&displaylang=en

Download vcsetup.exe

* Qt lib with stlport
> http://docs.google.com/leaf?id=0B3LX3q7MsUEGMGJiYmI1OGUtY2YzNy00YzVlLTk1NjMtMDU0MmY3ZDVlOTZi&sort=name&layout=list&num=50

I will assume that you extract qt lib with stlport in c:\
The Qt root folder would be c:\Qt\4.6.3

You can build you own Qt lib with stlport here :
> http://dev.ryzom.com/wiki/ryzom/QtLibStlportWindows

* NeL lib with stlport
Build NeL with the following wikis :
> http://dev.ryzom.com/wiki/ryzom/BuildForWindows

> http://dev.ryzom.com/wiki/ryzom/EverythingWindows

I will assume that NeL is in c:\ryzom\code\nel

* Ryzom core external lib
> https://sourceforge.net/projects/ryzom/files/external_stlport_lua51.7z/download

Extract Ryzom core external lib in c:\3rdParty
The folders would be c:\3rdParty\include, c:\3rdParty\lib, etc.

* TortoiseSVN
> http://tortoisesvn.net/downloads

* CMake
> http://www.cmake.org/cmake/resources/software.html

* NSIS Nullsoft Scriptable Install System (optional)
> http://nsis.sourceforge.net/Download

Download NSIS if you want to create an installer.

Download and install.

h2. Get object-viewer-qt source

Create a folder for object-viewer-qt source.

I will assume that you create the folder c:\object-viewer-qt

Right click on the folder then left click on SVN Checkout.

Fill "URL of repository" :
> http://object-viewer-qt.googlecode.com/svn/trunk/

Click on "OK" to download object-viewer-qt source.

h2. Set up everything

* Visual C++ settings

If you have already added the paths to Ryzom core external lib when you built Nel, skip those settings.

Add the following path paths to the top of Visual C++ "executable files" settings :

> c:\3rdParty\bin

Add the following paths to the top of Visual C++ "include" settings :
> c:\3rdParty\include\stlport

> c:\3rdParty\include

Add the following path paths to the top of Visual C++ "library" settings :
> c:\3rdParty\lib

* NeL settings

Edit the system variable PATH and add :
> c:\ryzom\code\nel\lib

* Qt settings

Edit the system variable PATH and add :
> c:\Qt\4.6.3\bin

Create a systeme variable QTLIB with the following value :
> c:\Qt\4.6.3\lib

* 3rdParty settings

Copy everything from c:\ryzom\code\nel\include to c:\3rdParty\include
Copy everything from c:\ryzom\code\nel\lib to c:\3rdParty\lib

h2. Generate Visual C++ solution with CMake

The 3rdParty subfolder must be in the same folder as object-viewer-qt source subfolder.
In our case :
> c:\object-viewer-qt

> c:\3rdParty

CMake will look after the 3rdParty subfolder.

Run cmake-gui.

Fill "Where is the source code" with object-viewer-qt source path :
> c:\object-viewer-qt

Fill "Where to build the binaries" with the path where you want to build object-viewer-qt :
> c:\object-viewer-qt-build

Click on "Configure".
Choose "Visual Studio 9 2008" and "Use default native compilers".
Click on "Finish".

Click on "Configure" again to finalize the configuration.

Click on "Generate" to generate the Visual C++ solution.

h2. Build object-viewer-qt

Open the Visual C++ solution
> c:\object-viewer-qt-build\object_viewer_qt.sln

Choose Release mode and hit F7 to build.

If you haven't installed NSIS, you won't be able to build some projects, but we don't care.

h2. Run object-viewer-qt

Copy everything from c:\object-viewer-qt\data to c:\object-viewer-qt-build\bin\Release

Run
> c:\object-viewer-qt-build\bin\Release\object-viewer-qt.exe

If you want to create a stand alone object-viewer-qt version, copy the following dll in c:\object-viewer-qt-build\bin\Release\ :
> c:\ryzom\code\nel\lib\nel_drv_direct3d_win_r.dll

> c:\ryzom\code\nel\lib\nel_drv_dsound_win_r.dll

> c:\ryzom\code\nel\lib\nel_drv_fmod_win_r.dll

> c:\ryzom\code\nel\lib\nel_drv_openal_win_r.dll

> c:\ryzom\code\nel\lib\nel_drv_opengl_win_r.dll

> c:\ryzom\code\nel\lib\nel_drv_xaudio2_win_r.dll

> c:\Qt\4.6.3\lib\QtCore4.dll

> c:\Qt\4.6.3\lib\QtGui4.dll

Here is an object-viewer-qt windows binary :
> https://docs.google.com/leaf?id=0B3LX3q7MsUEGZGE4YWU4ODgtYmMxNi00YWEyLTkwMGMtZDE5Y2Y0M2QyNmY3&sort=name&layout=list&num=50

You may also need Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) :
> http://www.microsoft.com/DOWNLOADS/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en

You can find ps and shape files here :
> http://media.ryzom.com/

That's all folks!