A flat cloud layer; drawn as a simple plane. More...

#include <FlatCloudLayer.h>

Public Member Functions
	FlatCloudLayer (Ogre::SceneManager sceneMgr, Ogre::SceneNode cloudRoot)

void	update (Ogre::Real timePassed, const Ogre::Vector3 &sunDirection, const Ogre::ColourValue &sunLightColour, const Ogre::ColourValue &fogColour, const Ogre::ColourValue &sunSphereColour)
	Update function called each frame from above. More...

void	advanceAnimation (Ogre::Real timePassed)
	Advance cloud animation (the time part of FlatCloudLayer::update).

void	reset ()
	Reset most tweak settings to their default values.

void	setCloudSpeed (const Ogre::Vector2 &cloudSpeed)
	Sets cloud movement speed. More...

const Ogre::Vector2	getCloudSpeed () const
	Gets cloud movement speed. More...

void	setSunDirection (const Ogre::Vector3 &sunDirection)

void	setSunLightColour (const Ogre::ColourValue &sunLightColour)

void	setSunSphereColour (const Ogre::ColourValue &sunSphereColour)

void	setFogColour (const Ogre::ColourValue &fogColour)

const Ogre::Vector3	getSunDirection () const

const Ogre::ColourValue	getSunLightColour () const

const Ogre::ColourValue	getSunSphereColour () const

const Ogre::ColourValue	getFogColour () const

void	_ensureGeometry ()
	Regenerate the plane mesh and recreate entity. More...

void	_invalidateGeometry ()
	Regenerate the plane mesh and recreate entity. More...

void	setMeshParameters (Real meshWidth, Real meshHeight, int meshWidthSegments, int meshHeightSegments)
	Reset all mesh parameters.

void	setMeshWidth (Real value)

void	setMeshHeight (Real value)

void	setMeshWidthSegments (int value)

void	setMeshHeightSegments (int value)

Real	getMeshWidth () const

Real	getMeshHeight () const

int	getMeshWidthSegments () const

int	getMeshHeightSegments () const

void	setCloudCover (const Ogre::Real cloudCover)
	Sets cloud cover, between 0 (completely clear) and 1 (completely covered) More...

Ogre::Real	getCloudCover () const
	Gets the current cloud cover. More...

void	setCloudCoverLookup (const Ogre::String &fileName)
	Set the image used to lookup the cloud coverage threshold. More...

const Ogre::String	getCloudCoverLookupFileName () const
	Get the filename of the cloud cover lookup image. More...

void	disableCloudCoverLookup ()
	Disable any cloud cover lookup. More...

Ogre::Real	getCloudCoverVisibilityThreshold () const
	Get cloud cover visiblity threshold. More...

void	setCloudCoverVisibilityThreshold (const Ogre::Real value)
	Set cloud cover visiblity threshold. More...

void	setHeight (Ogre::Real height)
	Set the height of the cloud layer. More...

Ogre::Real	getHeight () const
	Get the height of the cloud layer. More...

void	setCloudBlendTime (const Ogre::Real value)
	Sets the time it takes to blend two cloud shaped together, in seconds. More...

Ogre::Real	getCloudBlendTime () const
	Gets the time it takes to blend two cloud shaped together, in seconds. More...

void	setCloudBlendPos (const Ogre::Real value)
	Set the current blending position; between noise textures. More...

Ogre::Real	getCloudBlendPos () const

void	setCloudUVFactor (const Ogre::Real value)
	Cloud texture coordinates are multiplied with this. More...

Ogre::Real	getCloudUVFactor () const

void	setHeightRedFactor (const Ogre::Real value)
	High-altitude clouds are tinted red in the evening. More...

Ogre::Real	getHeightRedFactor () const

void	setFadeDistances (Ogre::Real nearValue, Ogre::Real farValue)
	Cloud fade distances. More...

void	setNearFadeDist (const Ogre::Real value)
	Set only near fade distance (see setFadeDistances).

Ogre::Real	getNearFadeDist () const
	Get near fade distance (see setFadeDistances).

void	setFarFadeDist (const Ogre::Real value)
	Set only far fade distance (see setFadeDistances).

Ogre::Real	getFarFadeDist () const
	Get fade distance (see setFadeDistances).

void	setFadeDistMeasurementVector (const Ogre::Vector3 &value)
	Set on which components is the fade distance measured. More...

const Ogre::Vector3	getFadeDistMeasurementVector () const
	Get the value set by setFadeDistMeasurementVector.

void	setQueryFlags (uint flags)

uint	getQueryFlags () const

void	setVisibilityFlags (uint flags)

uint	getVisibilityFlags () const

Protected Member Functions
void	_updateVisibilityThreshold ()
	Enforce setCloudCoverVisibilityThreshold.

Detailed Description

A flat cloud layer; drawn as a simple plane.

Supports movement and variable cloud cover.

There are significant incompatible difference between this and the LayeredClouds from version 0.3. This implementation of clouds is positioned in world space while the old implementation was a curved plane moving with the camera. It is not possible to perfectly simulate the older implementation.

Note: This is tighly integrated with LayeredCloud.cg and LayeredClouds.material.

Member Function Documentation

◆ update()

void Caelum::FlatCloudLayer::update	(	Ogre::Real	timePassed,
		const Ogre::Vector3 &	sunDirection,
		const Ogre::ColourValue &	sunLightColour,
		const Ogre::ColourValue &	fogColour,
		const Ogre::ColourValue &	sunSphereColour
	)

Update function called each frame from above.

This can be reproduced with calls to other public functions.

◆ setCloudSpeed()

void Caelum::FlatCloudLayer::setCloudSpeed ( const Ogre::Vector2 & cloudSpeed )

Sets cloud movement speed.

Parameters

cloudSpeed Cloud movement speed.

◆ getCloudSpeed()

const Ogre::Vector2 Caelum::FlatCloudLayer::getCloudSpeed ( ) const

inline

Gets cloud movement speed.

Parameters

cloudSpeed Cloud movement speed.

◆ _ensureGeometry()

void Caelum::FlatCloudLayer::_ensureGeometry ( )

Regenerate the plane mesh and recreate entity.

This automatically happens in update.

◆ _invalidateGeometry()

void Caelum::FlatCloudLayer::_invalidateGeometry ( )

Regenerate the plane mesh and recreate entity.

This automatically happens when mesh parameters are changed.

◆ setMeshWidth()

void Caelum::FlatCloudLayer::setMeshWidth ( Real value )

inline

See also: setMeshParameters

◆ setCloudCover()

void Caelum::FlatCloudLayer::setCloudCover ( const Ogre::Real cloudCover )

Sets cloud cover, between 0 (completely clear) and 1 (completely covered)

Parameters

cloudCover Cloud cover between 0 and 1

◆ getCloudCover()

Ogre::Real Caelum::FlatCloudLayer::getCloudCover ( ) const

inline

Gets the current cloud cover.

Returns: Cloud cover, between 0 and 1

◆ setCloudCoverLookup()

void Caelum::FlatCloudLayer::setCloudCoverLookup ( const Ogre::String & fileName )

Set the image used to lookup the cloud coverage threshold.

This image is used to calculate the cloud coverage threshold based on the desired cloud cover.

The cloud coverage threshold is substracted from cloud intensity at any point; to generate fewer or more clouds. That threshold is not linear, a lookup is required to ensure that setCloudCover(0.1) will actually have 10% the clouds at setCloudCover(1).

The lookup is the inverse of the sum on the histogram, and was calculated with a small hacky tool.

◆ getCloudCoverLookupFileName()

const Ogre::String Caelum::FlatCloudLayer::getCloudCoverLookupFileName ( ) const

Get the filename of the cloud cover lookup image.

This returns the value set by setCloudCoverLookup or an empty string if disabled.

◆ disableCloudCoverLookup()

void Caelum::FlatCloudLayer::disableCloudCoverLookup ( )

Disable any cloud cover lookup.

See also: setCloudCoverLookup.

◆ getCloudCoverVisibilityThreshold()

Ogre::Real Caelum::FlatCloudLayer::getCloudCoverVisibilityThreshold ( ) const

inline

Get cloud cover visiblity threshold.

Beneath this cloud coverage nothing is drawn anymore.

◆ setCloudCoverVisibilityThreshold()

void Caelum::FlatCloudLayer::setCloudCoverVisibilityThreshold ( const Ogre::Real value )

Set cloud cover visiblity threshold.

Beneath this cloud coverage nothing is drawn anymore. Default value is very very low (0.001). All this does is save you from destroying/recreating layers when they're too thin to bother drawing.

◆ setHeight()

void Caelum::FlatCloudLayer::setHeight ( Ogre::Real height )

Set the height of the cloud layer.

Parameters

height In world units above the cloud root node.

◆ getHeight()

Ogre::Real Caelum::FlatCloudLayer::getHeight ( ) const

Get the height of the cloud layer.

Returns: height In world units above the cloud root node.

◆ setCloudBlendTime()

void Caelum::FlatCloudLayer::setCloudBlendTime ( const Ogre::Real value )

Sets the time it takes to blend two cloud shaped together, in seconds.

This will also reset the animation at the current time.

Parameters

value Cloud shape blend time in seconds

◆ getCloudBlendTime()

Ogre::Real Caelum::FlatCloudLayer::getCloudBlendTime ( ) const

Gets the time it takes to blend two cloud shaped together, in seconds.

Returns: Cloud shape blend time in seconds

◆ setCloudBlendPos()

void Caelum::FlatCloudLayer::setCloudBlendPos ( const Ogre::Real value )

Set the current blending position; between noise textures.

Integer values are used for single textures. Float values blend between two textures. Values outside [0, textureCount) are wrapped around.

Parameters

value New cloud blending position

◆ getCloudBlendPos()

Ogre::Real Caelum::FlatCloudLayer::getCloudBlendPos ( ) const

See also: setCloudBlendPos

◆ setCloudUVFactor()

void Caelum::FlatCloudLayer::setCloudUVFactor ( const Ogre::Real value )

Cloud texture coordinates are multiplied with this.

Higher values result in more spread-out clouds. Very low value result in ugly texture repeats.

◆ getCloudUVFactor()

Ogre::Real Caelum::FlatCloudLayer::getCloudUVFactor ( ) const

inline

See also: setCloudUVFactor

◆ setHeightRedFactor()

void Caelum::FlatCloudLayer::setHeightRedFactor ( const Ogre::Real value )

High-altitude clouds are tinted red in the evening.

Higher values attenuate the effect.

◆ getHeightRedFactor()

Ogre::Real Caelum::FlatCloudLayer::getHeightRedFactor ( ) const

inline

See also: setCloudUVFactor

◆ setFadeDistances()

void Caelum::FlatCloudLayer::setFadeDistances	(	Ogre::Real	nearValue,
		Ogre::Real	farValue
	)

Cloud fade distances.

These are measured horizontally in meters (height is not used).

The effect is a fade based on alpha blending which occurs between nearValue and farValue. After farValue nothing is visibile from this layer.

Default values are 10000 and 140000

◆ setFadeDistMeasurementVector()

void Caelum::FlatCloudLayer::setFadeDistMeasurementVector ( const Ogre::Vector3 & value )

Set on which components is the fade distance measured.

Default is Vector3(0, 1, 1) which measures fade distance horizontally in caelum's default assumed coordinate system.

If you're in a Z-up system you probably want to set this to (1, 1, 0).

Fade distance is always measured relative to the camera.

Public Member Functions

Protected Member Functions

Detailed Description

Member Function Documentation

◆ update()

◆ setCloudSpeed()

◆ getCloudSpeed()

◆ _ensureGeometry()

◆ _invalidateGeometry()

◆ setMeshWidth()

◆ setCloudCover()

◆ getCloudCover()

◆ setCloudCoverLookup()

◆ getCloudCoverLookupFileName()

◆ disableCloudCoverLookup()

◆ getCloudCoverVisibilityThreshold()

◆ setCloudCoverVisibilityThreshold()

◆ setHeight()

◆ getHeight()

◆ setCloudBlendTime()

◆ getCloudBlendTime()

◆ setCloudBlendPos()

◆ getCloudBlendPos()

◆ setCloudUVFactor()

◆ getCloudUVFactor()

◆ setHeightRedFactor()

◆ getHeightRedFactor()

◆ setFadeDistances()

◆ setFadeDistMeasurementVector()