We keep storage of terrain data abstract here since we need different implementations for game and editor. More...

#include <storage.hpp>

Inheritance diagram for Terrain::Storage:

Collaboration diagram for Terrain::Storage:

Public Types
typedef std::vector < osg::ref_ptr< osg::Image > >	ImageVector

Public Member Functions
virtual	~Storage ()

virtual void	getBounds (float &minX, float &maxX, float &minY, float &maxY)=0
	Get bounds of the whole terrain in cell units. More...

virtual bool	getMinMaxHeights (float size, const osg::Vec2f &center, float &min, float &max)=0

virtual void	fillVertexBuffers (int lodLevel, float size, const osg::Vec2f &center, osg::ref_ptr< osg::Vec3Array > positions, osg::ref_ptr< osg::Vec3Array > normals, osg::ref_ptr< osg::Vec4Array > colours)=0

virtual void	getBlendmaps (float chunkSize, const osg::Vec2f &chunkCenter, bool pack, ImageVector &blendmaps, std::vector< LayerInfo > &layerList)=0

virtual float	getHeightAt (const osg::Vec3f &worldPos)=0

virtual LayerInfo	getDefaultLayer ()=0

virtual float	getCellWorldSize ()=0
	Get the transformation factor for mapping cell units to world units. More...

virtual int	getCellVertices ()=0
	Get the number of vertices on one side for each cell. Should be (power of two)+1. More...

Detailed Description

We keep storage of terrain data abstract here since we need different implementations for game and editor.

Member Typedef Documentation

typedef std::vector<osg::ref_ptr<osg::Image> > Terrain::Storage::ImageVector

virtual Terrain::Storage::~Storage ( )

inlinevirtual

virtual void Terrain::Storage::fillVertexBuffers	(	int	lodLevel,
		float	size,
		const osg::Vec2f &	center,
		osg::ref_ptr< osg::Vec3Array >	positions,
		osg::ref_ptr< osg::Vec3Array >	normals,
		osg::ref_ptr< osg::Vec4Array >	colours
	)

pure virtual

Fill vertex buffers for a terrain chunk.

Note: May be called from background threads. Make sure to only call thread-safe functions from here!; returned colors need to be in render-system specific format! Use RenderSystem::convertColourValue.; Vertices should be written in row-major order (a row is defined as parallel to the x-axis). The specified positions should be in local space, i.e. relative to the center of the terrain chunk.

Parameters

lodLevel	LOD level, 0 = most detailed
size	size of the terrain chunk in cell units
center	center of the chunk in cell units
positions	buffer to write vertices
normals	buffer to write vertex normals
colours	buffer to write vertex colours

Here is the caller graph for this function:

virtual void Terrain::Storage::getBlendmaps	(	float	chunkSize,
		const osg::Vec2f &	chunkCenter,
		bool	pack,
		ImageVector &	blendmaps,
		std::vector< LayerInfo > &	layerList
	)

pure virtual

Create textures holding layer blend values for a terrain chunk.

Note: The terrain chunk shouldn't be larger than one cell since otherwise we might have to do a ridiculous amount of different layers. For larger chunks, composite maps should be used.; May be called from background threads. Make sure to only call thread-safe functions from here!

Parameters

chunkSize	size of the terrain chunk in cell units
chunkCenter	center of the chunk in cell units
pack	Whether to pack blend values for up to 4 layers into one texture (one in each channel) - otherwise, each texture contains blend values for one layer only. Shader-based rendering can utilize packing, FFP can't.
blendmaps	created blendmaps will be written here
layerList	names of the layer textures used will be written here