Terrain Extension - Revision history

Codepoet at 13:08, 8 June 2008

2008-06-08T13:08:50Z

Ddd: Reverted edits by Qubodup (Talk); changed back to last version by Kal

2008-06-07T23:52:37Z

Reverted edits by Qubodup (Talk); changed back to last version by Kal

Qubodup: moving Category: Extensions to the extension

2008-06-07T15:26:10Z

moving Category: Extensions to the extension

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.

2008-06-07T15:25:10Z

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

Kal at 22:47, 20 May 2008

2008-05-20T22:47:32Z

Ddd at 00:05, 17 April 2008

2008-04-17T00:05:14Z

Ddd: Needs further editing. The

 should be avoided because it turns off the fixed-width layout. If it is cude use the CppSource template. in this case it was logs so i did not remove the tags.

2008-04-17T00:04:00Z

Needs further editing. The <pre> should be avoided because it turns off the fixed-width layout. If it is cude use the CppSource template. in this case it was logs so i did not remove the tags.

Codepoet at 21:30, 14 April 2008

2008-04-14T21:30:12Z

Volker: Added hint for creating combined normal-heightmaps

2008-04-10T06:46:55Z

Added hint for creating combined normal-heightmaps

Ddd at 03:56, 10 April 2008

2008-04-10T03:56:18Z

@@ Line 103: / Line 103: @@
 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.
 }} <!-- Right panel -->
 | valign="top" |{{Extension_Summary|

@@ Line 1: / Line 1: @@
-{{Extension_Summary
+[[category: Extensions]]
-|name = Terrain Extension
+{| border="0"
-|screenshot = H3Dterrain.jpg
+| {{ContentBlock|width=800|color=white |content=
-|description = Terrain Extension in use
+The Terrain Extension extends Horde3D with the capability to render large landscapes. 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 also considers the geometric complexity of the terrain to increase the resolution solely where this is really required. This makes the rendering fast and provides a high quality with a minimum of popping artifacts.
-|version = 0.1.0
-|horde3dversion = 0.15
+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.
 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:
@@ Line 33: / Line 16: @@
 The extension is then part of the Horde3D DLL and can be used with the Horde3DTerrain.h header file.
-== Installation on Linux ==
+= Installation Linux =
 Go to your target directory where you want to install Horde3D. Then extract the files, replace versions as needed.
 <pre>
@@ Line 114: / Line 97: @@
 Now everything should be working. Go to Horde3D/Binaries/Linux_x86 to try the samples.
-== Using the extension ==
+= 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.
@@ Line 120: / Line 103: @@
 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.

@@ Line 1: / Line 1: @@
 {{Extension_Summary
 |name = Terrain Extension
@@ Line 10: / Line 8: @@
 |author = Nicolas Schulz and Volker Wiendl
 }}
 The Terrain Extension extends Horde3D with the capability to render large landscapes.

@@ Line 1: / Line 1: @@
-[[category: Extensions]]
+[[Category: Extensions]]
-{| border="0"
-| {{ContentBlock|width=800|color=white |content=
+{{Extension_Summary
-The Terrain Extension extends Horde3D with the capability to render large landscapes. 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 also considers the geometric complexity of the terrain to increase the resolution solely where this is really required. This makes the rendering fast and provides a high quality with a minimum of popping artifacts.
+|name = Terrain Extension
+|screenshot = H3Dterrain.jpg
-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.
+|description = Terrain Extension in use
 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:
@@ Line 16: / Line 36: @@
 The extension is then part of the Horde3D DLL and can be used with the Horde3DTerrain.h header file.
-= Installation Linux =
+== Installation on Linux ==
 Go to your target directory where you want to install Horde3D. Then extract the files, replace versions as needed.
 <pre>
@@ Line 97: / Line 117: @@
 Now everything should be working. Go to Horde3D/Binaries/Linux_x86 to try the samples.
-= Using the extension =
+== 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.
@@ Line 103: / Line 123: @@
 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.

@@ Line 2: / Line 2: @@
 {| border="0"
 | {{ContentBlock|width=800|color=white |content=
-The Terrain Extension extends Horde3D with the capability to render large landscapes. 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 also considers the geometric complexity of the terrain to increase the resoultion solely where this is really required. This makes the rendering fast and provides a high quality with a minimum of popping artifacts.
+The Terrain Extension extends Horde3D with the capability to render large landscapes. 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 also considers the geometric complexity of the terrain to increase the resolution solely where this is really required. This makes the rendering fast and provides a high quality with a minimum of popping artifacts.
 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.

@@ Line 1: / Line 1: @@
 [[category: Extensions]]
+{| border="0"
-{{Extension_Summary|
+| {{ContentBlock|width=800|color=white |content=
 The Terrain Extension extends Horde3D with the capability to render large landscapes. A special
 level of detail algorithm adapts the resolution of the terrain mesh so that near regions get
@@ Line 33: / Line 24: @@
 to register the extension:
-'''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.
@@ Line 39: / Line 33: @@
 = Installation Linux =
 Go to your target directory where you want to install Horde3D. Then extract the files, replace versions as needed.
-<code><pre>unzip Horde3D_SDK_1.0.0_Beta1.zip
+<pre>
-unzip Horde3D_ExtTerrain_0.1.1.zip</pre></code>
+unzip Horde3D_SDK_1.0.0_Beta1.zip
 Now change Horde3D/Source/Horde3D Engine/egExtensions.cpp. Basically just uncomment all lines with code regarding the terrain extension:
-<code><pre>--- Horde3D/Source/Horde3D Engine/egExtensions.cpp.old        2008-04-14 23:19:44.000000000 +0200
+<pre>
 +++ Horde3D/Source/Horde3D Engine/egExtensions.cpp    2008-04-14 22:56:19.000000000 +0200
 @@ -25,16 +25,16 @@
@@ Line 59: / Line 57: @@
+  {
          // Install desired extensions here
--       //installExtension( Horde3DTerrain::getExtensionName, Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );
+-       //installExtension( Horde3DTerrain::getExtensionName,
-+       installExtension( Horde3DTerrain::getExtensionName, Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );
+Horde3DTerrain::initExtension, Horde3DTerrain::releaseExtension );
          return true;
+  }
-</pre></code>
+</pre>
 Now fix Horde3D/Source/Horde3D Engine/makefile:
-<code><pre>--- Horde3D/Source/Horde3D Engine/makefile.old      2008-04-01 20:42:58.000000000 +0200
+<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 @@
@@ Line 73: / Line 73: @@
          utImage.o utOpenGL.o ../Shared/utXMLParser.o
-+TERRAIN_OBJECTS = ../../../Extensions/Terrain/Source/extension.o ../../../Extensions/Terrain/Source/terrain.o
++TERRAIN_OBJECTS = ../../../Extensions/Terrain/Source/extension.o
++
@@ Line 87: / Line 88: @@
   clean:
-</pre></code>
+</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:
-<code><pre>--- Horde3D/Source/Horde3D Engine/utImage.cpp.old   2008-04-01 23:28:22.000000000 +0200
+<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 @@
@@ Line 100: / Line 101: @@
         img_comp[i].linebuf = NULL;
+     }
 </pre>
 Now we can compile the project: Call make in the following directories in the specified order:
-<code><pre>Extensions/Terrain/Source
+<pre>
 Horde3D
 Extensions/Terrain/Sample
-</pre></code>
+</pre>
 Now everything should be working. Go to Horde3D/Binaries/Linux_x86 to try the samples.
@@ Line 119: / Line 120: @@
 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
+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.
-images you can also specify a smoothing operator to convert the 8-bit heightmap into a more smooth 16-bit one
+}} <!-- Right panel -->

← Older revision		Revision as of 06:46, 10 April 2008
Line 39:		Line 39:
	in a shader to render the terrain. To see how this is working in detail, have a look at the included		in a shader to render the terrain. To see how this is working in detail, have a look at the included
	sample shader.		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

@@ Line 6: / Line 6: @@
 description = The Terrain Extension extends Horde3D with the capability to render large landscapes.|
 version = 0.1.0|
 author = Nicolas Schulz and Volker Wiendl|
 }}