Horde3D Wiki - User contributions [en]

Tutorial - Setup Horde with Qt4

2010-02-10T02:59:59Z

Kornerr: updated the tutorial

{| border="0"
| {{ContentBlock|color=white
|content=Before you start you should read QtOpenGL tutorial: http://doc.trolltech.com/4.6/opengl-hellogl.html (Substitute correct version of your Qt distribution).

Horde3D library should be already installed for build scripts to succeed.
{{CppSourceCode|
description= GLWidget.h|
code=
<source lang="cpp" line="1">
#ifndef GL_WIDGET_H
#define GL_WIDGET_H

#include <QtOpenGL>
#include <horde3d/Horde3D.h>
#include <horde3d/Horde3DUtils.h>

class GLWidget : public QGLWidget {
Q_OBJECT
public:
GLWidget();
~GLWidget();

QSize minimumSizeHint() const {
return QSize(640, 480);
}
QSize sizeHint() const {
return QSize(640, 480);
}

protected:
void initializeGL();
void paintGL();
void resizeGL(int width, int height);

private:
H3DRes mCam;
};

#endif // GL_WIDGET_H
</source>
}}
{{CppSourceCode|width=1024|
description= GLWidget.cpp|
code=
<source lang="cpp" line="1">
#include "GLWidget.h"
#include <stdexcept>

GLWidget::GLWidget() : QGLWidget() { }

GLWidget::~GLWidget() {
h3dutDumpMessages();
h3dRelease();
}

void GLWidget::initializeGL() {
if (!h3dInit()) {
h3dutDumpMessages();
throw std::runtime_error("Could not initialize renderer");
}
H3DRes pipeline = h3dAddResource(
H3DResTypes::Pipeline, "pipelines/forward.pipeline.xml", 0);
H3DRes knight = h3dAddResource(
H3DResTypes::SceneGraph , "models/knight/knight.scene.xml", 0);
h3dutLoadResourcesFromDisk("Content");
H3DNode node = h3dAddNodes(H3DRootNode, knight);
h3dSetNodeTransform(node, 0,0,0, 0,0,0, 1,1,1);
mCam = h3dAddCameraNode(H3DRootNode, "cam", pipeline);
h3dSetNodeTransform(mCam, 0,40,-40, 23,-166,0, 1,1,1);
}

void GLWidget::paintGL() {
h3dRender(mCam);
}

void GLWidget::resizeGL(int width, int height) {
h3dSetupViewport(0, 0, width, height, true);
h3dSetupCameraView(
mCam, 45.0f, static_cast<float>(width)/height, 0.1f, 1000.0f);
}
</source>
}}
{{CppSourceCode|
description= main.cpp|
code=
<source lang="cpp" line="1">
#include "GLWidget.h"
#include <QApplication>

int main(int argc, char* argv[]) {
QApplication app(argc, argv);
GLWidget glw;
glw.show();
return app.exec();
}
</source>
}}
QMake project file:
{{CppSourceCode|
description= h3d_qt4.pro|
code=
<source lang="cpp" line="1">
TEMPLATE = app
TARGET = h3d_qt4
DEPENDPATH += .
INCLUDEPATH += .
LIBS += -lHorde3D -lHorde3DUtils
QT += opengl

# Input
HEADERS += GLWidget.h
SOURCES += GLWidget.cpp main.cpp</source>
}}
'''Note''': [http://www.horde3d.org/wiki/index.php5?title=Building_Horde3D#Linkage_order_for_your_application Linkage order for your application]

CMake project file:
{{CppSourceCode|
description= CMakeLists.txt|
code=
<source lang="cpp" line="1">
PROJECT(H3D_QT4)

CMAKE_MINIMUM_REQUIRED(VERSION 2.6)
CMAKE_POLICY(VERSION 2.6)
# Debug, all warnings.
ADD_DEFINITIONS(-g -Wall)
# Find Qt4.
INCLUDE(FindQt4)
FIND_PACKAGE(Qt4 REQUIRED)
SET(QT_USE_QTOPENGL TRUE)
INCLUDE(${QT_USE_FILE})
INCLUDE_DIRECTORIES(${QT_INCLUDES}
/usr/local/include
/usr/include)
# Headers with Q_OBJECT macro.
SET(
H3D_QT4_MOC_HDR
GLWidget.h
)
QT4_WRAP_CPP(H3D_QT4_MOC_SRC ${H3D_QT4_MOC_HDR})
# Sources.
SET(
H3D_QT4_SRC
GLWidget.cpp
main.cpp
)
ADD_EXECUTABLE(h3d_qt4 ${H3D_QT4_MOC_SRC} ${H3D_QT4_SRC})
TARGET_LINK_LIBRARIES(h3d_qt4 Horde3D Horde3DUtils ${QT_LIBRARIES})
</source>
}}
}}
[http://kornerr.alfamoon.com/images/h3d_qt4.png The result should look like this]
|}
[[category: Tutorials]]

Building Horde3D

2010-02-09T06:26:31Z

Kornerr:

__NOTOC__ __NOEDITSECTION__{{ContentBlock|color=white|content={{!!}}
This article contains instructions for building Horde3D from source on all supported platforms. Since Horde3D is very lightweight and has a minimal amount of external dependencies, getting it to compile and run is usually quite straightforward.

== Obtaining the SDK ==

Besides the [http://sourceforge.net/projects/horde3d/files/ official release packages], there is also a subversion repository hosted at SourceForge which is usually more up-to-date than the stable point releases.

The repository has the common SVN structure ''branches'', ''tags'' and ''trunk''. The latest development snapshot can be found in the ''trunk'' folder, while the official releases are tagged in the ''tags'' folder. If you check out the trunk folder, you will get the SDK along with all official extensions.

See [[SVN Source Instructions]] for instructions on how to obtain code from Subversion.

== Building on Windows ==

The preferred way of building Horde3D on Windows is using '''Visual Studio'''. The SDK comes with a solution file for Visual Studio 2005 that can be opened with the Visual C++ Express Edition as well. If you have Visual Studio 2008 (Standard/Professional or Express), you can simply use the VS Conversion Wizard to update the solution and project files. The solution contains the samples that can be started directly from Visual Studio. Just set the desired sample as startup project.

It is also possible to use CMake to create the Visual Studio solution files. The process is similar to what you do on Linux then. However, if you want to use Visual Studio's ''nmake'', you usually have to use the Visual Studio Command Prompt instead of the standard ''cmd'' shell. Sample batch files for creating VS 2005 and 2008 projects can be found in the ''CMake'' folder located in the Horde3D repository.

== Building on Linux ==

The Horde3D SDK is compatible with gcc and ships with [http://www.cmake.org CMake] configuration files. To build Horde3D, just switch to the Horde3D root directory. Create a new directory which will contain the makefiles created by CMake, for example ''CMake'' and change into it. After that, type

cmake ..

which will create the makefiles. Once they are created, you can type <tt>make</tt> to build the code or <tt>make clean</tt> to remove all generated files.

=== Linkage order for your application ===
You must link Horde3D library to your final executable before GL one.

'''WRONG''':
gcc -o app main.cpp -lGL '''-lHorde3D'''

'''RIGHT''':
gcc -o app main.cpp '''-lHorde3D''' -lGL

This is required for GCC 3.x and 4.x series on Linux. If you don't follow the linkage order, you will get [http://horde3d.org/forums/viewtopic.php?f=2&t=384 glCreateShader error within h3dInit call].

== Building on Max OS X ==

Mac OS X is an advanced graphical system layered over a traditional Unix core. Because of this, you can either use Apple's graphical Xcode IDE to develop Horde3D based applications, or you can go the traditional Unix way using gcc and makefiles.

==== The Mac Way Using Xcode ====

To create the Xcode project files, you have to install CMake first. After installing the CMake command line tools, you should be able to run CMake from the console. Switch to Horde3D root directory and create a new directory in which the CMake output will be stored, for example ''CMake''. Change the current directory to that newly created one and type

cmake -G "Xcode" ..

You should now be able to open the newly created project in Xcode in order to build Horde3D.

==== The Unix Way Using the Command Line ====

''TODO''
}}

Building Horde3D

2010-02-09T06:23:41Z

Kornerr: Linkage order on Linux

__NOTOC__ __NOEDITSECTION__{{ContentBlock|color=white|content={{!!}}
This article contains instructions for building Horde3D from source on all supported platforms. Since Horde3D is very lightweight and has a minimal amount of external dependencies, getting it to compile and run is usually quite straightforward.

== Obtaining the SDK ==

Besides the [http://sourceforge.net/projects/horde3d/files/ official release packages], there is also a subversion repository hosted at SourceForge which is usually more up-to-date than the stable point releases.

The repository has the common SVN structure ''branches'', ''tags'' and ''trunk''. The latest development snapshot can be found in the ''trunk'' folder, while the official releases are tagged in the ''tags'' folder. If you check out the trunk folder, you will get the SDK along with all official extensions.

See [[SVN Source Instructions]] for instructions on how to obtain code from Subversion.

== Building on Windows ==

The preferred way of building Horde3D on Windows is using '''Visual Studio'''. The SDK comes with a solution file for Visual Studio 2005 that can be opened with the Visual C++ Express Edition as well. If you have Visual Studio 2008 (Standard/Professional or Express), you can simply use the VS Conversion Wizard to update the solution and project files. The solution contains the samples that can be started directly from Visual Studio. Just set the desired sample as startup project.

It is also possible to use CMake to create the Visual Studio solution files. The process is similar to what you do on Linux then. However, if you want to use Visual Studio's ''nmake'', you usually have to use the Visual Studio Command Prompt instead of the standard ''cmd'' shell. Sample batch files for creating VS 2005 and 2008 projects can be found in the ''CMake'' folder located in the Horde3D repository.

== Building on Linux ==

The Horde3D SDK is compatible with gcc and ships with [http://www.cmake.org CMake] configuration files. To build Horde3D, just switch to the Horde3D root directory. Create a new directory which will contain the makefiles created by CMake, for example ''CMake'' and change into it. After that, type

cmake ..

which will create the makefiles. Once they are created, you can type <tt>make</tt> to build the code or <tt>make clean</tt> to remove all generated files.

=== Linkage order for your application ===
You must link Horde3D library to your final executable before GL one:

'''WRONG''':
gcc -o app main.cpp -lGL '''-lHorde3D'''

'''RIGHT''':
gcc -o app main.cpp '''-lHorde3D''' -lGL

This is required for GCC 3.x and 4.x series on Linux. If you don't follow the linkage order, you will get [http://horde3d.org/forums/viewtopic.php?f=2&t=384 glCreateShader error within h3dInit call].

== Building on Max OS X ==

Mac OS X is an advanced graphical system layered over a traditional Unix core. Because of this, you can either use Apple's graphical Xcode IDE to develop Horde3D based applications, or you can go the traditional Unix way using gcc and makefiles.

==== The Mac Way Using Xcode ====

To create the Xcode project files, you have to install CMake first. After installing the CMake command line tools, you should be able to run CMake from the console. Switch to Horde3D root directory and create a new directory in which the CMake output will be stored, for example ''CMake''. Change the current directory to that newly created one and type

cmake -G "Xcode" ..

You should now be able to open the newly created project in Xcode in order to build Horde3D.

==== The Unix Way Using the Command Line ====

''TODO''
}}