A scene node for displaying terrain using the geo mip map algorithm. More...

#include <duckcpp/core/engine/ITerrainSceneNode.hpp>

Inheritance diagram for dcpp::scene::ITerrainSceneNode:

Collaboration diagram for dcpp::scene::ITerrainSceneNode:

Public Member Functions
	ITerrainSceneNode (ISceneNode parent, ISceneManager mgr, dcpp::int32_kt id, const dcpp::nub::vector3df &position=dcpp::nub::vector3df(0.0f, 0.0f, 0.0f), const dcpp::nub::vector3df &rotation=dcpp::nub::vector3df(0.0f, 0.0f, 0.0f), const dcpp::nub::vector3df &scale=dcpp::nub::vector3df(1.0f, 1.0f, 1.0f))
	Constructor.

virtual const dcpp::nub::aabbox3df &	getBoundingBox () const =0
	Get the bounding box of the terrain.

virtual const dcpp::nub::aabbox3df &	getBoundingBox (dcpp::int32_kt patchX, dcpp::int32_kt patchZ) const =0
	Get the bounding box of a patch.

virtual dcpp::uint32_kt	getIndexCount () const =0
	Get the number of indices currently in the meshbuffer.

virtual IMesh *	getMesh ()=0
	Get pointer to the mesh.

virtual IMeshBuffer *	getRenderBuffer ()=0
	Get pointer to the buffer used by the terrain (most users will not need this)

virtual void	getMeshBufferForLOD (IDynamicMeshBuffer &mb, dcpp::int32_kt LOD=0) const =0
	Gets the meshbuffer data based on a specified level of detail.

virtual dcpp::int32_kt	getIndicesForPatch (dcpp::nub::array< dcpp::uint32_kt > &indices, dcpp::int32_kt patchX, dcpp::int32_kt patchZ, dcpp::int32_kt LOD=0)=0
	Gets the indices for a specified patch at a specified Level of Detail.

virtual dcpp::int32_kt	getCurrentLODOfPatches (dcpp::nub::array< dcpp::int32_kt > &LODs) const =0
	Populates an array with the CurrentLOD of each patch.

virtual void	setLODOfPatch (dcpp::int32_kt patchX, dcpp::int32_kt patchZ, dcpp::int32_kt LOD=0)=0
	Manually sets the LOD of a patch.

virtual const dcpp::nub::vector3df &	getTerrainCenter () const =0
	Get center of terrain.

virtual dcpp::float32_kt	getHeight (dcpp::float32_kt x, dcpp::float32_kt y) const =0
	Get height of a point of the terrain.

virtual void	setCameraMovementDelta (dcpp::float32_kt delta)=0
	Sets the movement camera threshold.

virtual void	setCameraRotationDelta (dcpp::float32_kt delta)=0
	Sets the rotation camera threshold.

virtual void	setDynamicSelectorUpdate (bool bVal)=0
	Sets whether or not the node should dynamically update its associated selector when the geomipmap data changes.

virtual bool	overrideLODDistance (dcpp::int32_kt LOD, dcpp::float64_kt newDistance)=0
	Override the default generation of distance thresholds.

virtual void	scaleTexture (dcpp::float32_kt scale=1.0f, dcpp::float32_kt scale2=0.0f)=0
	Scales the base texture, similar to makePlanarTextureMapping.

virtual bool	loadHeightMap (dcpp::io::IReadFile *file, dcpp::video::SColor vertexColor=dcpp::video::SColor(255, 255, 255, 255), dcpp::int32_kt smoothFactor=0)=0
	Initializes the terrain data. Loads the vertices from the heightMapFile.

virtual bool	loadHeightMapRAW (dcpp::io::IReadFile *file, dcpp::int32_kt bitsPerPixel=16, bool signedData=false, bool floatVals=false, dcpp::int32_kt width=0, dcpp::video::SColor vertexColor=dcpp::video::SColor(255, 255, 255, 255), dcpp::int32_kt smoothFactor=0)=0
	Initializes the terrain data. Loads the vertices from the heightMapFile.

virtual void	setFixedBorderLOD (dcpp::int32_kt borderLOD=0)=0
	Force node to use a fixed LOD level at the borders of the terrain.

Public Member Functions inherited from dcpp::scene::ISceneNode
	ISceneNode (ISceneNode parent, ISceneManager mgr, dcpp::int32_kt id=-1, const dcpp::nub::vector3df &position=dcpp::nub::vector3df(0, 0, 0), const dcpp::nub::vector3df &rotation=dcpp::nub::vector3df(0, 0, 0), const dcpp::nub::vector3df &scale=dcpp::nub::vector3df(1.0f, 1.0f, 1.0f))
	Constructor.

virtual	~ISceneNode ()
	Destructor.

virtual void	OnRegisterSceneNode ()
	This method is called just before the rendering process of the whole scene.

virtual void	OnAnimate (dcpp::uint32_kt timeMs)
	OnAnimate() is called just before rendering the whole scene.

virtual void	render ()=0
	Renders the node.

virtual const dcpp::char_kt *	getName () const
	Returns the name of the node.

virtual void	setName (const dcpp::char_kt *name)
	Sets the name of the node.

virtual void	setName (const dcpp::nub::string &name)
	Sets the name of the node.

virtual const dcpp::nub::aabbox3df	getTransformedBoundingBox () const
	Get the axis aligned, transformed and animated absolute bounding box of this node.

virtual void	getTransformedBoundingBoxEdges (dcpp::nub::array< dcpp::nub::vector3df > &edges) const

virtual const dcpp::nub::matrix4 &	getAbsoluteTransformation () const
	Get the absolute transformation of the node. Is recalculated every OnAnimate()-call.

virtual dcpp::nub::matrix4	getRelativeTransformation () const
	Returns the relative transformation of the scene node.

virtual bool	isVisible () const
	Returns whether the node should be visible (if all of its parents are visible).

virtual bool	isTrulyVisible () const
	Check whether the node is truly visible, taking into accounts its parents' visibility.

virtual void	setVisible (bool isVisible)
	Sets if the node should be visible or not.

virtual dcpp::int32_kt	getID () const
	Get the id of the scene node.

virtual void	setID (dcpp::int32_kt id)
	Sets the id of the scene node.

virtual void	addChild (ISceneNode *child)
	Adds a child to this scene node.

virtual bool	removeChild (ISceneNode *child)
	Removes a child from this scene node.

virtual void	removeAll ()
	Removes all children of this scene node.

virtual void	remove ()
	Removes this scene node from the scene.

virtual void	addAnimator (ISceneNodeAnimator *animator)
	Adds an animator which should animate this node.

const dcpp::nub::list< ISceneNodeAnimator * > &	getAnimators () const
	Get a list of all scene node animators.

virtual void	removeAnimator (ISceneNodeAnimator *animator)
	Removes an animator from this scene node.

virtual void	removeAnimators ()
	Removes all animators from this scene node.

virtual dcpp::video::SMaterial &	getMaterial (dcpp::uint32_kt num)
	Returns the material based on the zero based index i.

virtual dcpp::uint32_kt	getMaterialCount () const
	Get amount of materials used by this scene node.

void	setMaterialFlag (dcpp::video::E_MATERIAL_FLAG flag, bool newvalue)
	Sets all material flags at once to a new value.

void	setMaterialTexture (dcpp::uint32_kt textureLayer, dcpp::video::ITexture *texture)
	Sets the texture of the specified layer in all materials of this scene node to the new texture.

void	setMaterialType (dcpp::video::E_MATERIAL_TYPE newType)
	Sets the material type of all materials in this scene node to a new material type.

virtual const dcpp::nub::vector3df &	getScale () const
	Gets the scale of the scene node relative to its parent.

virtual void	setScale (const dcpp::nub::vector3df &scale)
	Sets the relative scale of the scene node.

virtual const dcpp::nub::vector3df &	getRotation () const
	Gets the rotation of the node relative to its parent.

virtual void	setRotation (const dcpp::nub::vector3df &rotation)
	Sets the rotation of the node relative to its parent.

virtual const dcpp::nub::vector3df &	getPosition () const
	Gets the position of the node relative to its parent.

virtual void	setPosition (const dcpp::nub::vector3df &newpos)
	Sets the position of the node relative to its parent.

virtual dcpp::nub::vector3df	getAbsolutePosition () const
	Gets the absolute position of the node in world coordinates.

void	setAutomaticCulling (dcpp::uint32_kt state)
	Set a culling style or disable culling completely.

dcpp::uint32_kt	getAutomaticCulling () const
	Gets the automatic culling state.

void	setUpdateAbsolutePosBehavior (ESCENE_NODE_UPDATE_ABS behavior)
	Set how updateAbsolutePosition calculates the absolute transformation matrix.

ESCENE_NODE_UPDATE_ABS	getUpdateAbsolutePosBehavior () const
	Get how updateAbsolutePosition calculates the absolute transformation matrix.

virtual void	setDebugDataVisible (dcpp::uint32_kt state)
	Sets if debug data like bounding boxes should be drawn.

dcpp::uint32_kt	isDebugDataVisible () const
	Returns if debug data like bounding boxes are drawn.

void	setIsDebugObject (bool debugObject)
	Sets if this scene node is a debug object.

bool	isDebugObject () const
	Returns if this scene node is a debug object.

const dcpp::nub::list< ISceneNode * > &	getChildren () const
	Returns a const reference to the list of all children.

virtual void	setParent (ISceneNode *newParent)
	Changes the parent of the scene node.

virtual ITriangleSelector *	getTriangleSelector () const
	Returns the triangle selector attached to this scene node.

virtual void	setTriangleSelector (ITriangleSelector *selector)
	Sets the triangle selector of the scene node.

virtual void	updateAbsolutePosition ()
	Updates the absolute tranformation or position based on the relative and the parents transformation.

dcpp::scene::ISceneNode *	getParent () const
	Returns the parent of this scene node.

virtual ESCENE_NODE_TYPE	getType () const
	Returns type of the scene node.

virtual void	serializeAttributes (dcpp::io::IAttributes out, dcpp::io::SAttributeReadWriteOptions options=0) const override
	Writes attributes of the scene node.

virtual void	deserializeAttributes (dcpp::io::IAttributes in, dcpp::io::SAttributeReadWriteOptions options=0) override
	Reads attributes of the scene node.

virtual ISceneNode *	clone (ISceneNode newParent=0, ISceneManager newManager=0)
	Creates a clone of this scene node and its children.

virtual ISceneManager *	getSceneManager (void) const
	Retrieve the scene manager for this node.

Public Member Functions inherited from dcpp::IReferenceCounted
	IReferenceCounted ()
	Constructor.

virtual	~IReferenceCounted ()
	Destructor.

void	grab () const
	Grabs the object. Increments the reference counter by one.

bool	drop () const
	Drops the object. Decrements the reference counter by one.

dcpp::int32_kt	getReferenceCount () const
	Get the reference count.

const dcpp::char_kt *	getDebugName () const
	Returns the debug name of the object.

Additional Inherited Members
Protected Member Functions inherited from dcpp::scene::ISceneNode
void	cloneMembers (ISceneNode toCopyFrom, ISceneManager newManager)
	A clone function for the ISceneNode members.

void	setSceneManager (ISceneManager *newManager)

Protected Member Functions inherited from dcpp::IReferenceCounted
void	setDebugName (const dcpp::char_kt *newName)
	Sets the debug name of the object.

Protected Attributes inherited from dcpp::scene::ISceneNode
dcpp::nub::string	Name
	Name of the scene node.

dcpp::nub::matrix4	AbsoluteTransformation
	Absolute transformation of the node.

dcpp::nub::vector3df	RelativeTranslation
	Relative translation of the scene node.

dcpp::nub::vector3df	RelativeRotation
	Relative rotation of the scene node.

dcpp::nub::vector3df	RelativeScale
	Relative scale of the scene node.

ISceneNode *	Parent
	Pointer to the parent.

dcpp::nub::list< ISceneNode * >	Children
	List of all children of this node.

dcpp::nub::list< ISceneNodeAnimator * >	Animators
	List of all animator nodes.

ISceneManager *	SceneManager
	Pointer to the scene manager.

ITriangleSelector *	TriangleSelector
	Pointer to the triangle selector.

dcpp::int32_kt	ID
	ID of the node.

ESCENE_NODE_UPDATE_ABS	UpdateAbsolutePosBehavior
	How updateAbsolutePosition calculates AbsoluteTransformation.

dcpp::uint32_kt	AutomaticCullingState
	Automatic culling state.

dcpp::uint32_kt	DebugDataVisible
	Flag if debug data should be drawn, such as Bounding Boxes.

bool	IsVisible
	Is the node visible?

bool	IsDebugObject
	Is debug object?

Detailed Description

A scene node for displaying terrain using the geo mip map algorithm.

The code for the TerrainSceneNode is based on the Terrain renderer by Soconne and the GeoMipMapSceneNode developed by Spintz. They made their code available for Duckcpp and allowed it to be distributed under this licence. I only modified some parts. A lot of thanks go to them.

This scene node is capable of very quickly loading terrains and updating the indices at runtime to enable viewing very large terrains. It uses a CLOD (Continuous Level of Detail) algorithm which updates the indices for each patch based on a LOD (Level of Detail) which is determined based on a patch's distance from the camera.

The Patch Size of the terrain must always be a size of ( 2^N+1, i.e. 8+1(9), 16+1(17), etc. ). The MaxLOD available is directly dependent on the patch size of the terrain. LOD 0 contains all of the indices to draw all the triangles at the max detail for a patch. As each LOD goes up by 1 the step taken, in generating indices increases by - 2^LOD, so for LOD 1, the step taken is 2, for LOD 2, the step taken is 4, LOD 3 - 8, etc. The step can be no larger than the size of the patch, so having a LOD of 8, with a patch size of 17, is asking the algorithm to generate indices every 2^8 ( 256 ) vertices, which is not possible with a patch size of 17. The maximum LOD for a patch size of 17 is 2^4 ( 16 ). So, with a MaxLOD of 5, you'll have LOD 0 ( full detail ), LOD 1 ( every 2 vertices ), LOD 2 ( every 4 vertices ), LOD 3 ( every 8 vertices ) and LOD 4 ( every 16 vertices ).

Member Function Documentation

◆ getBoundingBox() [1/2]

virtual const dcpp::nub::aabbox3df & dcpp::scene::ITerrainSceneNode::getBoundingBox ( ) const

pure virtual

Get the bounding box of the terrain.

Returns: The bounding box of the entire terrain.

Implements dcpp::scene::ISceneNode.

◆ getBoundingBox() [2/2]

virtual const dcpp::nub::aabbox3df & dcpp::scene::ITerrainSceneNode::getBoundingBox	(	dcpp::int32_kt	patchX,
		dcpp::int32_kt	patchZ
	)		const

pure virtual

Get the bounding box of a patch.

Returns: The bounding box of the chosen patch.

◆ getCurrentLODOfPatches()

virtual dcpp::int32_kt dcpp::scene::ITerrainSceneNode::getCurrentLODOfPatches ( dcpp::nub::array< dcpp::int32_kt > & LODs ) const

pure virtual

Populates an array with the CurrentLOD of each patch.

Parameters

LODs	A reference to a dcpp::nub::array<dcpp::int32_kt> to hold the values

Returns: Number of elements in the array

◆ getIndexCount()

virtual dcpp::uint32_kt dcpp::scene::ITerrainSceneNode::getIndexCount ( ) const

pure virtual

Get the number of indices currently in the meshbuffer.

Returns: The index count.

◆ getIndicesForPatch()

virtual dcpp::int32_kt dcpp::scene::ITerrainSceneNode::getIndicesForPatch	(	dcpp::nub::array< dcpp::uint32_kt > &	indices,
		dcpp::int32_kt	patchX,
		dcpp::int32_kt	patchZ,
		dcpp::int32_kt	LOD = `0`
	)

pure virtual

Gets the indices for a specified patch at a specified Level of Detail.

Parameters

indices	A reference to an array of dcpp::uint32_kt indices.
patchX	Patch x coordinate.
patchZ	Patch z coordinate.
LOD	The level of detail to get for that patch. If -1, then get the CurrentLOD. If the CurrentLOD is set to -1, meaning it's not shown, then it will retrieve the triangles at the highest LOD (0).

Returns: Number of indices put into the buffer.

◆ getMesh()

virtual IMesh * dcpp::scene::ITerrainSceneNode::getMesh ( )

pure virtual

Get pointer to the mesh.

Returns: Pointer to the mesh.

◆ getMeshBufferForLOD()

virtual void dcpp::scene::ITerrainSceneNode::getMeshBufferForLOD	(	IDynamicMeshBuffer &	mb,
		dcpp::int32_kt	LOD = `0`
	)		const

pure virtual

Gets the meshbuffer data based on a specified level of detail.

Parameters

mb	A reference to an IDynamicMeshBuffer object
LOD	The level of detail you want the indices from.

◆ loadHeightMap()

virtual bool dcpp::scene::ITerrainSceneNode::loadHeightMap	(	dcpp::io::IReadFile *	file,
		dcpp::video::SColor	vertexColor = `dcpp::video::SColor(255, 255, 255, 255)`,
		dcpp::int32_kt	smoothFactor = `0`
	)

pure virtual

Initializes the terrain data. Loads the vertices from the heightMapFile.

The file must contain a loadable image of the heightmap. The heightmap must be square.

Parameters

file	The file to read the image from. File is not rewinded.
vertexColor	Color of all vertices.
smoothFactor	Number of smoothing passes.

◆ loadHeightMapRAW()

virtual bool dcpp::scene::ITerrainSceneNode::loadHeightMapRAW	(	dcpp::io::IReadFile *	file,
		dcpp::int32_kt	bitsPerPixel = `16`,
		bool	signedData = `false`,
		bool	floatVals = `false`,
		dcpp::int32_kt	width = `0`,
		dcpp::video::SColor	vertexColor = `dcpp::video::SColor(255, 255, 255, 255)`,
		dcpp::int32_kt	smoothFactor = `0`
	)

pure virtual

Initializes the terrain data. Loads the vertices from the heightMapFile.

The data is interpreted as (signed) integers of the given bit size or floats (with 32bits, signed). Allowed bitsizes for integers are 8, 16, and 32. The heightmap must be square.

Parameters

file	The file to read the RAW data from. File is not rewinded.
bitsPerPixel	Size of data if integers used, for floats always use 32.
signedData	Whether we use signed or unsigned ints, ignored for floats.
floatVals	Whether the data is float or int.
width	Width (and also Height, as it must be square) of the heightmap. Use 0 for autocalculating from the filesize.
vertexColor	Color of all vertices.
smoothFactor	Number of smoothing passes.

◆ overrideLODDistance()

virtual bool dcpp::scene::ITerrainSceneNode::overrideLODDistance	(	dcpp::int32_kt	LOD,
		dcpp::float64_kt	newDistance
	)

pure virtual

Override the default generation of distance thresholds.

For determining the LOD a patch is rendered at. If any LOD is overridden, then the scene node will no longer apply scaling factors to these values. If you override these distances, and then apply a scale to the scene node, it is your responsibility to update the new distances to work best with your new terrain size.

◆ scaleTexture()

virtual void dcpp::scene::ITerrainSceneNode::scaleTexture	(	dcpp::float32_kt	scale = `1.0f`,
		dcpp::float32_kt	scale2 = `0.0f`
	)

pure virtual

Scales the base texture, similar to makePlanarTextureMapping.

Parameters

scale	The scaling amount. Values above 1.0 increase the number of time the texture is drawn on the terrain. Values below 0 will decrease the number of times the texture is drawn on the terrain. Using negative values will flip the texture, as well as still scaling it.
scale2	If set to 0 (default value), this will set the second texture coordinate set to the same values as in the first set. If this is another value than zero, it will scale the second texture coordinate set by this value.

◆ setCameraMovementDelta()

virtual void dcpp::scene::ITerrainSceneNode::setCameraMovementDelta ( dcpp::float32_kt delta )

pure virtual

Sets the movement camera threshold.

It is used to determine when to recalculate indices for the scene node. The default value is 10.0f.

◆ setCameraRotationDelta()

virtual void dcpp::scene::ITerrainSceneNode::setCameraRotationDelta ( dcpp::float32_kt delta )

pure virtual

Sets the rotation camera threshold.

It is used to determine when to recalculate indices for the scene node. The default value is 1.0f.

◆ setDynamicSelectorUpdate()

virtual void dcpp::scene::ITerrainSceneNode::setDynamicSelectorUpdate ( bool bVal )

pure virtual

Sets whether or not the node should dynamically update its associated selector when the geomipmap data changes.

Parameters

bVal	Boolean value representing whether or not to update selector dynamically.

◆ setFixedBorderLOD()

virtual void dcpp::scene::ITerrainSceneNode::setFixedBorderLOD ( dcpp::int32_kt borderLOD = 0 )

pure virtual

Force node to use a fixed LOD level at the borders of the terrain.

This can be useful when several TerrainSceneNodes are connected.

Parameters

borderLOD When >= 0 all patches at the 4 borders will use the given LOD. When < 0 borders are just regular patches (that's default).

◆ setLODOfPatch()

virtual void dcpp::scene::ITerrainSceneNode::setLODOfPatch	(	dcpp::int32_kt	patchX,
		dcpp::int32_kt	patchZ,
		dcpp::int32_kt	LOD = `0`
	)

pure virtual

Manually sets the LOD of a patch.

NOTE: Any values set here are overwritten again in the automatic recalculations when the camera changes.

Parameters

patchX	Patch x coordinate.
patchZ	Patch z coordinate.
LOD	The level of detail to set the patch to.

The documentation for this class was generated from the following file:

include/duckcpp/core/engine/ITerrainSceneNode.hpp

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ getBoundingBox() [1/2]

◆ getBoundingBox() [2/2]

◆ getCurrentLODOfPatches()

◆ getIndexCount()

◆ getIndicesForPatch()

◆ getMesh()

◆ getMeshBufferForLOD()

◆ loadHeightMap()

◆ loadHeightMapRAW()

◆ overrideLODDistance()

◆ scaleTexture()

◆ setCameraMovementDelta()

◆ setCameraRotationDelta()

◆ setDynamicSelectorUpdate()

◆ setFixedBorderLOD()

◆ setLODOfPatch()