OGRE  1.10.12
Object-Oriented Graphics Rendering Engine
Ogre::TerrainMaterialGeneratorA Class Reference

A TerrainMaterialGenerator which can cope with normal mapped, specular mapped terrain. More...

#include <OgreTerrainMaterialGeneratorA.h>

+ Inheritance diagram for Ogre::TerrainMaterialGeneratorA:

Classes

class  SM2Profile
 Shader model 2 profile target. More...
 

Public Types

typedef vector< Profile * >::type ProfileList
 List of profiles - NB should be ordered in descending complexity. More...
 

Public Member Functions

 TerrainMaterialGeneratorA ()
 
virtual ~TerrainMaterialGeneratorA ()
 
Texture_getCompositeMapRTT ()
 
void _markChanged ()
 Internal method - indicates that a change has been made that would require material regeneration. More...
 
virtual void _renderCompositeMap (size_t size, const Rect &rect, const MaterialPtr &mat, const TexturePtr &destCompositeMap)
 Helper method to render a composite map. More...
 
virtual bool canGenerateUsingDeclaration (const TerrainLayerDeclaration &decl)
 Whether this generator can generate a material for a given declaration. More...
 
virtual MaterialPtr generate (const Terrain *terrain)
 Generate a material for the given terrain using the active profile. More...
 
virtual MaterialPtr generateForCompositeMap (const Terrain *terrain)
 Generate a material for the given composite map of the terrain using the active profile. More...
 
ProfilegetActiveProfile () const
 Get the active profile. More...
 
unsigned long long int getChangeCount () const
 Returns the number of times the generator has undergone a change which would require materials to be regenerated. More...
 
virtual unsigned int getDebugLevel () const
 Get the debug level of the material. More...
 
virtual const TerrainLayerDeclarationgetLayerDeclaration () const
 Get the layer declaration that this material generator operates with. More...
 
virtual uint8 getMaxLayers (const Terrain *terrain) const
 Get the maximum number of layers supported with the given terrain. More...
 
virtual const ProfileListgetProfiles () const
 Get the list of profiles that this generator supports. More...
 
virtual bool isVertexCompressionSupported () const
 Return whether this material generator supports using a compressed vertex format. More...
 
virtual void requestOptions (Terrain *terrain)
 Triggers the generator to request the options that it needs. More...
 
virtual void setActiveProfile (const String &name)
 Set the active profile by name. More...
 
virtual void setActiveProfile (Profile *p)
 Set the active Profile. More...
 
virtual void setDebugLevel (unsigned int dbg)
 Set the debug level of the material. More...
 
virtual void setLightmapEnabled (bool enabled)
 Whether to support a light map over the terrain in the shader, if it's present (default true). More...
 
virtual void updateCompositeMap (const Terrain *terrain, const Rect &rect)
 Update the composite map for a terrain. More...
 
virtual void updateParams (const MaterialPtr &mat, const Terrain *terrain)
 Update parameters for the given terrain using the active profile. More...
 
virtual void updateParamsForCompositeMap (const MaterialPtr &mat, const Terrain *terrain)
 Update parameters for the given terrain composite map using the active profile. More...
 

Detailed Description

A TerrainMaterialGenerator which can cope with normal mapped, specular mapped terrain.

Note
Requires the Cg plugin to render correctly

Member Typedef Documentation

◆ ProfileList

List of profiles - NB should be ordered in descending complexity.

Constructor & Destructor Documentation

◆ TerrainMaterialGeneratorA()

Ogre::TerrainMaterialGeneratorA::TerrainMaterialGeneratorA ( )

◆ ~TerrainMaterialGeneratorA()

virtual Ogre::TerrainMaterialGeneratorA::~TerrainMaterialGeneratorA ( )
virtual

Member Function Documentation

◆ getProfiles()

virtual const ProfileList& Ogre::TerrainMaterialGenerator::getProfiles ( ) const
inlinevirtualinherited

Get the list of profiles that this generator supports.

◆ setActiveProfile() [1/2]

virtual void Ogre::TerrainMaterialGenerator::setActiveProfile ( const String name)
inlinevirtualinherited

Set the active profile by name.

◆ setActiveProfile() [2/2]

virtual void Ogre::TerrainMaterialGenerator::setActiveProfile ( Profile p)
inlinevirtualinherited

Set the active Profile.

◆ getActiveProfile()

Profile* Ogre::TerrainMaterialGenerator::getActiveProfile ( ) const
inlineinherited

Get the active profile.

◆ _markChanged()

void Ogre::TerrainMaterialGenerator::_markChanged ( )
inlineinherited

Internal method - indicates that a change has been made that would require material regeneration.

◆ getChangeCount()

unsigned long long int Ogre::TerrainMaterialGenerator::getChangeCount ( ) const
inlineinherited

Returns the number of times the generator has undergone a change which would require materials to be regenerated.

◆ getLayerDeclaration()

virtual const TerrainLayerDeclaration& Ogre::TerrainMaterialGenerator::getLayerDeclaration ( ) const
inlinevirtualinherited

Get the layer declaration that this material generator operates with.

◆ canGenerateUsingDeclaration()

virtual bool Ogre::TerrainMaterialGenerator::canGenerateUsingDeclaration ( const TerrainLayerDeclaration decl)
inlinevirtualinherited

Whether this generator can generate a material for a given declaration.

By default this only returns true if the declaration is equal to the standard one returned from getLayerDeclaration, but if a subclass wants to be flexible to generate materials for other declarations too, it can specify here.

◆ isVertexCompressionSupported()

virtual bool Ogre::TerrainMaterialGenerator::isVertexCompressionSupported ( ) const
inlinevirtualinherited

Return whether this material generator supports using a compressed vertex format.

This is only possible when using shaders.

◆ requestOptions()

virtual void Ogre::TerrainMaterialGenerator::requestOptions ( Terrain terrain)
inlinevirtualinherited

Triggers the generator to request the options that it needs.

References Ogre::TerrainMaterialGenerator::Profile::requestOptions().

◆ generate()

virtual MaterialPtr Ogre::TerrainMaterialGenerator::generate ( const Terrain terrain)
inlinevirtualinherited

Generate a material for the given terrain using the active profile.

References Ogre::TerrainMaterialGenerator::Profile::generate().

◆ generateForCompositeMap()

virtual MaterialPtr Ogre::TerrainMaterialGenerator::generateForCompositeMap ( const Terrain terrain)
inlinevirtualinherited

Generate a material for the given composite map of the terrain using the active profile.

References Ogre::TerrainMaterialGenerator::Profile::generateForCompositeMap().

◆ setLightmapEnabled()

virtual void Ogre::TerrainMaterialGenerator::setLightmapEnabled ( bool  enabled)
inlinevirtualinherited

Whether to support a light map over the terrain in the shader, if it's present (default true).

References Ogre::TerrainMaterialGenerator::Profile::setLightmapEnabled().

◆ getMaxLayers()

virtual uint8 Ogre::TerrainMaterialGenerator::getMaxLayers ( const Terrain terrain) const
inlinevirtualinherited

Get the maximum number of layers supported with the given terrain.

Note
When you change the options on the terrain, this value can change.

References Ogre::TerrainMaterialGenerator::Profile::getMaxLayers().

◆ updateCompositeMap()

virtual void Ogre::TerrainMaterialGenerator::updateCompositeMap ( const Terrain terrain,
const Rect rect 
)
inlinevirtualinherited

Update the composite map for a terrain.

The composite map for a terrain must match what the terrain should look like at distance. This method will only be called in the render thread so the generator is free to render into a texture to support this, so long as the results are blitted into the Terrain's own composite map afterwards.

References Ogre::TerrainMaterialGenerator::Profile::updateCompositeMap().

◆ updateParams()

virtual void Ogre::TerrainMaterialGenerator::updateParams ( const MaterialPtr mat,
const Terrain terrain 
)
inlinevirtualinherited

Update parameters for the given terrain using the active profile.

References Ogre::TerrainMaterialGenerator::Profile::updateParams().

◆ updateParamsForCompositeMap()

virtual void Ogre::TerrainMaterialGenerator::updateParamsForCompositeMap ( const MaterialPtr mat,
const Terrain terrain 
)
inlinevirtualinherited

Update parameters for the given terrain composite map using the active profile.

References Ogre::TerrainMaterialGenerator::Profile::updateParamsForCompositeMap().

◆ setDebugLevel()

virtual void Ogre::TerrainMaterialGenerator::setDebugLevel ( unsigned int  dbg)
inlinevirtualinherited

Set the debug level of the material.

Remarks
Sets the level of debug display for this material. What this debug level means is entirely depdendent on the generator, the only constant is that 0 means 'no debug' and non-zero means 'some level of debugging', with any graduations in non-zero values being generator-specific.

◆ getDebugLevel()

virtual unsigned int Ogre::TerrainMaterialGenerator::getDebugLevel ( ) const
inlinevirtualinherited

Get the debug level of the material.

◆ _renderCompositeMap()

virtual void Ogre::TerrainMaterialGenerator::_renderCompositeMap ( size_t  size,
const Rect rect,
const MaterialPtr mat,
const TexturePtr destCompositeMap 
)
virtualinherited

Helper method to render a composite map.

Parameters
sizeThe requested composite map size
rectThe region of the composite map to update, in image space
matThe material to use to render the map
destCompositeMapA TexturePtr for the composite map to be written into

◆ _getCompositeMapRTT()

Texture* Ogre::TerrainMaterialGenerator::_getCompositeMapRTT ( )
inlineinherited

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