Horde3D Wiki - User contributions [en]

Main Page

2008-06-07T15:59:03Z

Qubodup: centered gallery text

{{ContentBlock|width=100%|color=orange
|header=Welcome to the wiki for the open source next-generation graphics engine Horde3D
|content= This wiki collects information about how to make best use of the numerous features of Horde3D. Since it is a collaborative effort to which all community members are invited to contribute, the Horde3D team does not take any responsibility for the content or the accuracy of the content provided on these pages.
}}
{{SpacerBlock}}
{{Filmstrip}}
<center>[[Gallery]]: Here are a few of the [[samples]], add your own and get famous. [[Gallery|more...]]</center>

<div style="width: 55%; float: left;">
{{ContentBlock|width=100%|color=#FF9900
|icon=InfoIcon.png
|iconsize=32
|halign=top
|header=Getting Started
|sub-header=Start here to learn all the H3D basics.
|content={{!!}}
* [http://www.horde3d.org/features.html Features supported by Horde3D.]
* [http://www.horde3d.org/screenshots.html Screenshots of sample applications created with Horde3D.]
* [http://www.horde3d.org/docs/_tutorial.html A small introductory tutorial which shows the API style.]
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|color=#FFCC33
|icon=DevIcon.png
|iconsize=32
|halign=top
|header=Using Horde
|sub-header=Practical usage of the engine.
|content={{!!}}
* [http://www.horde3d.org/docs/_usageguide.html#Concepts Introduction to basic concepts.]
* [http://www.horde3d.org/docs/_usageguide.html#Content Advice for bringing content to the engine.]
* [http://www.horde3d.org/docs/_usageguide.html#Advanced Introduction to more advanced topics.]
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|color=#FF9900
|icon=ResourcesIcon.png
|iconsize=32
|halign=top
|header=Resources
|sub-header=Explore the website, forums, and [[Horde3D_Wiki:Community_Portal| Community Portal]].
|content={{!!}}
* [[Horde3D_Wiki:Community_Portal | The Community Portal Tutorials.]]
* [http://www.horde3d.org/ Official Horde3D Website.]
* [http://www.horde3d.org/forums/ Forums for discussions and support.]
* [http://www.horde3d.org/docs/manual.html Horde3D Manual.]
* [http://mm-werkstatt.informatik.uni-augsburg.de/project_details.php?id=45 Official Horde3D Editor]
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|color=#FFCC33
|icon=HighlightIcon.png
|iconsize=32
|header=Project Spotlights
|sub-header=This Month: Official Horde3D Editor.
|content={{!!}}
[[Image:H3Deditor.jpg|frame|left|H3D Editor]]
*[[Editor Features]]
*[[Editor Tutorials]]
*[[Future Enhancements]]
}}
</div>
<div style="width:44%; float: right;">
{{ContentBlock|width=100%|header=Download Horde3D|icon=Download45.png |sub-header=Stable Release: v1.0 beta1
|center=true
|content=
'''Get [[Distribution]]'''

<html>
<a href="http://downloads.sourceforge.net/horde3d/Horde3D_SDK_1.0.0_Beta1.zip" ><img src="http://www.horde3d.org/wiki/images/6/66/WinXP80.png"></a>
<a href="http://www.mediafire.com/?csrwjww9dhe" ><img src="http://www.horde3d.org/wiki/images/6/60/MacOSX80.png"></a>
<a href="http://www.horde3d.org/downloads/Horde3D%20SDK%20%5B0.15.0%5D.zip" ><img src="http://www.horde3d.org/wiki/images/3/3d/Ubunto80.png"></a>
</html>

'''Get [[SVN Source Instructions]]'''
{{SpacerBlock|294|2|color=#FF9900}}
{{ContentBlock|width=100% |thickness=0 |content-color=#FFFFCC
|center=true
|content=
'''[[Language Bindings]]:'''

[[JavaBindings|Java]] • [[dotNETBindings|.NET]] • [[DBindings|Digitalmars D]] • [[PyBindings|Python]]
}}
{{SpacerBlock|294|1|color=#FF9900}}
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|
|icon=DevIcon45.png
|header=[[Development | Horde3D Development]]
|sub-header=[[Current events | Current Events]]: v1.0
|content-color=#FFFFCC
|content=
These pages are only of interest to developers who are modifying Horde itself, or developing extensions.
=== [[Hardware]] ===
*[[ATI Development]] - Issues specific to ATI Cards
*[[NVidia Development]] - Issues specific to NVidia Cards
=== [[Platforms]] ===
*[[Windows Development]] - Issues specific to Microsoft Windows.
*[[Linux Development]] - Issues specific to Linux.
*[[Mac OS X Development]] - Issues specific to Mac OS X.
=== [[Extensions]] ===
*[[Terrain Extension]] - Adds Large Terrain support.
*[[Bullet Physics]] - Connects Bullet Physics Engine to Horde3D.
}}
</div>

__NOEDITSECTION__ __NOTOC__

Template:Filmstrip

2008-06-07T15:58:12Z

Qubodup: centered it

Template:ContentBlock

2008-06-07T15:56:56Z

Qubodup:

{{#vardefine:boxwith|{{{width| 300}}} }}{{#vardefine:iconwith|{{{iconsize|45}}} }}
{| width="{{{width|800}}}" cellspacing="0" style="border: 0px; padding: 0px; border-style: solid; border-color: {{{color|#8BC3DF;}}}; border-width: {{{thickness|2}}}px;"
{{#if: {{{icon|}}} | {{#if: {{{sub-header|}}} | {{!}} style="background-color: {{{color|#8BC3DF;}}}" width="{{{iconsize|45}}}" rowspan="2" {{!}} [[Image:{{{icon}}}]] | {{!}} style="background-color: {{{color|#8BC3DF;}}}" width="{{{iconsize|45}}}" {{!}} [[Image:{{{icon}}}]]}} }}

{{ #if: {{{header|}}} | {{!}} style="background-color: {{{color|#8BC3DF;}}}" width="{{ #expr: {{#var:boxwith}} - {{#var:iconwith}} }}" valign="{{{halign|bottom}}}" {{!}} '''{{{header}}}'''| }}
|-
{{ #if: {{{sub-header|}}} | {{!}} style="background-color: {{{color|#8BC3DF;}}}" width="{{ #expr: {{#var:boxwith}} - {{#var:iconwith}} }}" valign="top" {{!}} {{{sub-header}}} |}}
|-
{{ #if: {{{content|}}} | {{!}} style="padding: 2px; background-color: {{{content-color|#FFFFEF;}}}" colspan="2" {{!}} {{#if: {{{center|}}}|<div align="center">|}} {{{content}}} {{#if: {{{center|}}}|</div>|}} |}}
|-
{{ #if: {{{description|}}} | {{!}} style="background-color: {{{color|#8BC3DF;}}}" colspan="2" {{!}} {{{description}}} |}}
|}
<noinclude>
ContentBox is a very flexible layout configuration tool. You can use it to render all sorts of content and to layout multiple pages in your articles. It is very configurable: icon, header, sub-header, content, description, border, border thickess, color, content color and size.
You can see how such a configurable box can be very easy and flexible to use.
==Usage==
Here is how you use it and the parameter list:
like every other template you include it by using the
<pre>{{ContentBox
|content= Content Goes here. (issue, for lists and other items it may be necessary to add the following hack {{!!}}. This is necessary due to weaknesses in the parser, that remove all white space. This is only one of the multiple flaws of the mediawiki parser.
}}</pre> If no parameter apart from content are passed then the template uses a set default parameters.
</noinclude>

Main Page

2008-06-07T15:52:46Z

Qubodup: don't lynch me for this, but content has to be floating

{{ContentBlock|width=100%|color=orange
|header=Welcome to the wiki for the open source next-generation graphics engine Horde3D
|content= This wiki collects information about how to make best use of the numerous features of Horde3D. Since it is a collaborative effort to which all community members are invited to contribute, the Horde3D team does not take any responsibility for the content or the accuracy of the content provided on these pages.
}}
{{SpacerBlock}}
{{Filmstrip}}
[[Gallery]]: Here are a few of the [[samples]], add your own and get famous. [[Gallery|more...]]

<div style="width: 55%; float: left;">
{{ContentBlock|width=100%|color=#FF9900
|icon=InfoIcon.png
|iconsize=32
|halign=top
|header=Getting Started
|sub-header=Start here to learn all the H3D basics.
|content={{!!}}
* [http://www.horde3d.org/features.html Features supported by Horde3D.]
* [http://www.horde3d.org/screenshots.html Screenshots of sample applications created with Horde3D.]
* [http://www.horde3d.org/docs/_tutorial.html A small introductory tutorial which shows the API style.]
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|color=#FFCC33
|icon=DevIcon.png
|iconsize=32
|halign=top
|header=Using Horde
|sub-header=Practical usage of the engine.
|content={{!!}}
* [http://www.horde3d.org/docs/_usageguide.html#Concepts Introduction to basic concepts.]
* [http://www.horde3d.org/docs/_usageguide.html#Content Advice for bringing content to the engine.]
* [http://www.horde3d.org/docs/_usageguide.html#Advanced Introduction to more advanced topics.]
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|color=#FF9900
|icon=ResourcesIcon.png
|iconsize=32
|halign=top
|header=Resources
|sub-header=Explore the website, forums, and [[Horde3D_Wiki:Community_Portal| Community Portal]].
|content={{!!}}
* [[Horde3D_Wiki:Community_Portal | The Community Portal Tutorials.]]
* [http://www.horde3d.org/ Official Horde3D Website.]
* [http://www.horde3d.org/forums/ Forums for discussions and support.]
* [http://www.horde3d.org/docs/manual.html Horde3D Manual.]
* [http://mm-werkstatt.informatik.uni-augsburg.de/project_details.php?id=45 Official Horde3D Editor]
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|color=#FFCC33
|icon=HighlightIcon.png
|iconsize=32
|header=Project Spotlights
|sub-header=This Month: Official Horde3D Editor.
|content={{!!}}
[[Image:H3Deditor.jpg|frame|left|H3D Editor]]
*[[Editor Features]]
*[[Editor Tutorials]]
*[[Future Enhancements]]
}}
</div>
<div style="width:44%; float: right;">
{{ContentBlock|width=100%|header=Download Horde3D|icon=Download45.png |sub-header=Stable Release: v1.0 beta1
|center=true
|content=
'''Get [[Distribution]]'''

<html>
<a href="http://downloads.sourceforge.net/horde3d/Horde3D_SDK_1.0.0_Beta1.zip" ><img src="http://www.horde3d.org/wiki/images/6/66/WinXP80.png"></a>
<a href="http://www.mediafire.com/?csrwjww9dhe" ><img src="http://www.horde3d.org/wiki/images/6/60/MacOSX80.png"></a>
<a href="http://www.horde3d.org/downloads/Horde3D%20SDK%20%5B0.15.0%5D.zip" ><img src="http://www.horde3d.org/wiki/images/3/3d/Ubunto80.png"></a>
</html>

'''Get [[SVN Source Instructions]]'''
{{SpacerBlock|294|2|color=#FF9900}}
{{ContentBlock|width=100% |thickness=0 |content-color=#FFFFCC
|center=true
|content=
'''[[Language Bindings]]:'''

[[JavaBindings|Java]] • [[dotNETBindings|.NET]] • [[DBindings|Digitalmars D]] • [[PyBindings|Python]]
}}
{{SpacerBlock|294|1|color=#FF9900}}
}}
{{SpacerBlock|1|1}}
{{ContentBlock|width=100%|
|icon=DevIcon45.png
|header=[[Development | Horde3D Development]]
|sub-header=[[Current events | Current Events]]: v1.0
|content-color=#FFFFCC
|content=
These pages are only of interest to developers who are modifying Horde itself, or developing extensions.
=== [[Hardware]] ===
*[[ATI Development]] - Issues specific to ATI Cards
*[[NVidia Development]] - Issues specific to NVidia Cards
=== [[Platforms]] ===
*[[Windows Development]] - Issues specific to Microsoft Windows.
*[[Linux Development]] - Issues specific to Linux.
*[[Mac OS X Development]] - Issues specific to Mac OS X.
=== [[Extensions]] ===
*[[Terrain Extension]] - Adds Large Terrain support.
*[[Bullet Physics]] - Connects Bullet Physics Engine to Horde3D.
}}
</div>

__NOEDITSECTION__ __NOTOC__

File:H3Dterrain.jpg

2008-06-07T15:27:39Z

Qubodup:

This image is an example of the [[Terrain Extension]]. At least I guess so.

Template:Extension Summary

2008-06-07T15:26:37Z

Qubodup:

{|align="right" style="background-color: #FFE8CF; border: 2px solid #EC8A1C; margin: 2px; padding: 5px;"
|-
|width=100px|
|width=100px|
|-
| colspan="2" align="center" |'''{{{name}}}'''
|-
| colspan="2" align="center" |[[Image:{{{screenshot}}}]]
|-
| colspan="2" align="center" |''{{{description}}}''
|-
|'''Version: '''||{{{version}}}
|-
|'''Compatible with Horde3D:'''||{{{horde3dversion}}}
|-
|'''Release date:'''||{{{released}}}
|-
|'''Author(s):'''||{{{author}}}
|-
|}<includeonly>[[Category: Extensions]]</includeonly>

Terrain Extension

2008-06-07T15:26:10Z

Qubodup: moving Category: Extensions to the extension

{{Extension_Summary
|name = Terrain Extension
|screenshot = H3Dterrain.jpg
|description = Terrain Extension in use
|version = 0.1.0
|horde3dversion = 0.15
|released = 2008-03-30
|author = Nicolas Schulz and Volker Wiendl
}}
The Terrain Extension extends Horde3D with the capability to render large landscapes.

== Features ==

=== Level of Detail ===

A special level of detail algorithm adapts the resolution of the terrain mesh so that near regions get more details than remote ones. The algorithm considers the geometric complexity of the terrain to increase the resolution solely where this is required. This makes the rendering fast and provides a high quality with a minimum of popping artifacts.

=== Height map ===

A height map is used to define the altitude of the terrain.

The height map is a usual texture map that encodes 16 bit height information in two channels. The red channel of the texture contains the coarse height, while the green channel encodes finer graduations. The encoding of the information is usually done with an appropriate tool. If you just want to use 8 bit height information, you can simply copy the greyscale image to the red channel of the height map and leave the green channel black.

== Installation on Windows ==

To install the extension, simply copy the contents of the extension root directory to the Horde3D SDK folder and merge the directories. In Visual Studio, add the extension and sample projects to the solution. Then add the extension project to the project dependencies of the Horde3D Engine and the Horde3D Engine to the dependencies of the Terrain Sample. After that, include 'Terrain/extension.h' in 'egExtensions.cpp' of the engine and add '#pragma comment( lib, "Extension_Terrain.lib" )' to link against the terrain extension (under Windows). Finally, add the following line to ExtensionManager::installExtensions to register the extension:

<pre>
installExtension( Horde3DTerrain::getExtensionName,
Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );
</pre>

The extension is then part of the Horde3D DLL and can be used with the Horde3DTerrain.h header file.

== Installation on Linux ==
Go to your target directory where you want to install Horde3D. Then extract the files, replace versions as needed.
<pre>
unzip Horde3D_SDK_1.0.0_Beta1.zip
unzip Horde3D_ExtTerrain_0.1.1.zip
</pre>

Now change Horde3D/Source/Horde3D Engine/egExtensions.cpp. Basically just uncomment all lines with code regarding the terrain extension:
<pre>
--- Horde3D/Source/Horde3D Engine/egExtensions.cpp.old 2008-04-14 23:19:44.000000000 +0200
+++ Horde3D/Source/Horde3D Engine/egExtensions.cpp 2008-04-14 22:56:19.000000000 +0200
@@ -25,16 +25,16 @@
#include "egExtensions.h"

// Include files for extensions
-//#include "Terrain/Source/extension.h"
+#include "Terrain/Source/extension.h"

// Lib files for extensions
-//#pragma comment( lib, "Extension_Terrain.lib" )
+#pragma comment( lib, "Extension_Terrain.lib" )

bool ExtensionManager::installExtensions()
{
// Install desired extensions here
- //installExtension( Horde3DTerrain::getExtensionName,
Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );
+ installExtension( Horde3DTerrain::getExtensionName,
Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );

return true;
}
</pre>

Now fix Horde3D/Source/Horde3D Engine/makefile:
<pre>--- Horde3D/Source/Horde3D Engine/makefile.old 2008-04-01 20:42:58.000000000 +0200
+++ Horde3D/Source/Horde3D Engine/makefile 2008-04-14 23:09:49.000000000 +0200
@@ -6,13 +6,15 @@
egRenderer.o egResource.o egScene.o egSceneGraphRes.o egShader.o egTextures.o \
utImage.o utOpenGL.o ../Shared/utXMLParser.o

+TERRAIN_OBJECTS = ../../../Extensions/Terrain/Source/extension.o
../../../Extensions/Terrain/Source/terrain.o
+

libHorde3D: $(OBJECTS)
- g++ $(OBJECTS) -olibHorde3D.so -lGL -shared
+ g++ $(OBJECTS) $(TERRAIN_OBJECTS) -olibHorde3D.so -lGL -shared
mv libHorde3D.so ../../Binaries/Linux_x86

%.o: %.cpp
- g++ -c $< -o$@ -I../Shared -I../../Extensions -fPIC ${CFLAGS}
+ g++ -c $< -o$@ -I../Shared -I../../../Extensions -fPIC ${CFLAGS}

clean:
</pre>

If you are using the 1.0.0 Beta1 on a 64 bit system you have to fix Horde3D/Source/Horde3D Engine/utImage.cpp:
<pre>--- Horde3D/Source/Horde3D Engine/utImage.cpp.old 2008-04-01 23:28:22.000000000 +0200
+++ Horde3D/Source/Horde3D Engine/utImage.cpp 2008-04-14 23:03:28.000000000 +0200
@@ -1257,7 +1257,7 @@
}
return e("outofmem", "Out of memory");
}
- img_comp[i].data = (uint8*) (((int) img_comp[i].raw_data + 15) & ~15);
+ img_comp[i].data = (uint8*) (((size_t) img_comp[i].raw_data + 15) & ~15);
img_comp[i].linebuf = NULL;
}
</pre>

Now we can compile the project: Call make in the following directories in the specified order:
<pre>
Extensions/Terrain/Source
Horde3D
Extensions/Terrain/Sample
</pre>

Now everything should be working. Go to Horde3D/Binaries/Linux_x86 to try the samples.

== Using the extension ==

The extension defines the uniform *terBlockParams* and the attribute *terHeight* that can be used in a shader to render the terrain. To see how this is working in detail, have a look at the included sample shader.

In the Terrain Sample distributed with the extension, there's also a normal map encoded in the heightmap texture. The data for the
normal map is encoded in the blue and alpha channel. A simple tool to create such a combined normal height map is integrated in the Horde3D Scene Editor. It can use 8-bit or 16-bit images as heightmap input. In case of 8-bit images you can also specify a smoothing operator to convert the 8-bit heightmap into a more smooth 16-bit one.

Terrain Extension

2008-06-07T15:25:10Z

Qubodup: some fixes: more headers, removed table (tables are not for formatting and fixed width is a no-no), image texts are for describing images.

[[Category: Extensions]]

{{Extension_Summary
|name = Terrain Extension
|screenshot = H3Dterrain.jpg
|description = Terrain Extension in use
|version = 0.1.0
|horde3dversion = 0.15
|released = 2008-03-30
|author = Nicolas Schulz and Volker Wiendl
}}

The Terrain Extension extends Horde3D with the capability to render large landscapes.

== Features ==

=== Level of Detail ===

A special level of detail algorithm adapts the resolution of the terrain mesh so that near regions get more details than remote ones. The algorithm considers the geometric complexity of the terrain to increase the resolution solely where this is required. This makes the rendering fast and provides a high quality with a minimum of popping artifacts.

=== Height map ===

A height map is used to define the altitude of the terrain.

The height map is a usual texture map that encodes 16 bit height information in two channels. The red channel of the texture contains the coarse height, while the green channel encodes finer graduations. The encoding of the information is usually done with an appropriate tool. If you just want to use 8 bit height information, you can simply copy the greyscale image to the red channel of the height map and leave the green channel black.

== Installation on Windows ==

To install the extension, simply copy the contents of the extension root directory to the Horde3D SDK folder and merge the directories. In Visual Studio, add the extension and sample projects to the solution. Then add the extension project to the project dependencies of the Horde3D Engine and the Horde3D Engine to the dependencies of the Terrain Sample. After that, include 'Terrain/extension.h' in 'egExtensions.cpp' of the engine and add '#pragma comment( lib, "Extension_Terrain.lib" )' to link against the terrain extension (under Windows). Finally, add the following line to ExtensionManager::installExtensions to register the extension:

<pre>
installExtension( Horde3DTerrain::getExtensionName,
Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );
</pre>

The extension is then part of the Horde3D DLL and can be used with the Horde3DTerrain.h header file.

== Installation on Linux ==
Go to your target directory where you want to install Horde3D. Then extract the files, replace versions as needed.
<pre>
unzip Horde3D_SDK_1.0.0_Beta1.zip
unzip Horde3D_ExtTerrain_0.1.1.zip
</pre>

Now change Horde3D/Source/Horde3D Engine/egExtensions.cpp. Basically just uncomment all lines with code regarding the terrain extension:
<pre>
--- Horde3D/Source/Horde3D Engine/egExtensions.cpp.old 2008-04-14 23:19:44.000000000 +0200
+++ Horde3D/Source/Horde3D Engine/egExtensions.cpp 2008-04-14 22:56:19.000000000 +0200
@@ -25,16 +25,16 @@
#include "egExtensions.h"

// Include files for extensions
-//#include "Terrain/Source/extension.h"
+#include "Terrain/Source/extension.h"

// Lib files for extensions
-//#pragma comment( lib, "Extension_Terrain.lib" )
+#pragma comment( lib, "Extension_Terrain.lib" )

bool ExtensionManager::installExtensions()
{
// Install desired extensions here
- //installExtension( Horde3DTerrain::getExtensionName,
Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );
+ installExtension( Horde3DTerrain::getExtensionName,
Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );

return true;
}
</pre>

Now fix Horde3D/Source/Horde3D Engine/makefile:
<pre>--- Horde3D/Source/Horde3D Engine/makefile.old 2008-04-01 20:42:58.000000000 +0200
+++ Horde3D/Source/Horde3D Engine/makefile 2008-04-14 23:09:49.000000000 +0200
@@ -6,13 +6,15 @@
egRenderer.o egResource.o egScene.o egSceneGraphRes.o egShader.o egTextures.o \
utImage.o utOpenGL.o ../Shared/utXMLParser.o

+TERRAIN_OBJECTS = ../../../Extensions/Terrain/Source/extension.o
../../../Extensions/Terrain/Source/terrain.o
+

libHorde3D: $(OBJECTS)
- g++ $(OBJECTS) -olibHorde3D.so -lGL -shared
+ g++ $(OBJECTS) $(TERRAIN_OBJECTS) -olibHorde3D.so -lGL -shared
mv libHorde3D.so ../../Binaries/Linux_x86

%.o: %.cpp
- g++ -c $< -o$@ -I../Shared -I../../Extensions -fPIC ${CFLAGS}
+ g++ -c $< -o$@ -I../Shared -I../../../Extensions -fPIC ${CFLAGS}

clean:
</pre>

If you are using the 1.0.0 Beta1 on a 64 bit system you have to fix Horde3D/Source/Horde3D Engine/utImage.cpp:
<pre>--- Horde3D/Source/Horde3D Engine/utImage.cpp.old 2008-04-01 23:28:22.000000000 +0200
+++ Horde3D/Source/Horde3D Engine/utImage.cpp 2008-04-14 23:03:28.000000000 +0200
@@ -1257,7 +1257,7 @@
}
return e("outofmem", "Out of memory");
}
- img_comp[i].data = (uint8*) (((int) img_comp[i].raw_data + 15) & ~15);
+ img_comp[i].data = (uint8*) (((size_t) img_comp[i].raw_data + 15) & ~15);
img_comp[i].linebuf = NULL;
}
</pre>

Now we can compile the project: Call make in the following directories in the specified order:
<pre>
Extensions/Terrain/Source
Horde3D
Extensions/Terrain/Sample
</pre>

Now everything should be working. Go to Horde3D/Binaries/Linux_x86 to try the samples.

== Using the extension ==

The extension defines the uniform *terBlockParams* and the attribute *terHeight* that can be used in a shader to render the terrain. To see how this is working in detail, have a look at the included sample shader.

In the Terrain Sample distributed with the extension, there's also a normal map encoded in the heightmap texture. The data for the
normal map is encoded in the blue and alpha channel. A simple tool to create such a combined normal height map is integrated in the Horde3D Scene Editor. It can use 8-bit or 16-bit images as heightmap input. In case of 8-bit images you can also specify a smoothing operator to convert the 8-bit heightmap into a more smooth 16-bit one.