This class implements a layered heightfield. More...

#include <layers.h>

Inheritance diagram for LayerStack:

Public Member Functions
	LayerStack ()
	Create an empty terrain.

	LayerStack (const Box2 &, int, int)
	Create a terrain with different material layers.

	LayerStack (const ScalarField2 &)
	Create terrain.

	LayerStack (const ScalarField2 &, const ScalarField2 &)
	Create terrain.

	LayerStack (const ScalarField2 &, const ScalarField2 &, const ScalarField2 &, const ScalarField2 &, const ScalarField2 &, const ScalarField2 &, const ScalarField2 &, const ScalarField2 &)
	Create a layered terrain model.

	~LayerStack ()
	Empty.

void	Subdivide ()
	Double the resolution of the terrain.

Box	GetBox () const
	Compute the bounding box of the terrain.

double	Vegetation (const Vector2 &) const
	Return the vegetation density.

double	Vegetation (int, int) const
	Return the vegetation density.

double	Grass (const Vector2 &) const
	Return the grass elevation.

double	Grass (int, int) const
	Return the grass elevation.

double	Water (const Vector2 &) const
	Return the water elevation.

double	Water (int, int) const
	Return the water elevation.

double	Rocks (const Vector2 &) const
	Return the rocks elevation.

double	Rocks (int, int) const
	Return the rocks elevation.

ScalarField2 &	GetRock ()
	Access to the rock scalar field.

ScalarField2 &	GetWater ()
	Access to the water scalar field.

ScalarField2 &	GetSnow ()
	Access to the snow scalar field.

ScalarField2 &	GetGrass ()
	Access to the grass scalar field.

ScalarField2 &	GetVegetation ()
	Access to the vegetation scalar field.

ScalarField2 &	GetAlpha ()
	Access to the alpha scalar field.

HeightField	GetHeightField (bool=true, bool=true) const
	Convert the layered model into a simple heightfield.

void	UpdateHeightField (HeightField &, const QRect &=QRect(), bool=true, bool=true) const
	Convert the layer model into a simple heightfield.

bool	Intersect (const Ray &, double &, Vector &) const
	Compute the intersection between a ray and the surface of the terrain.

LayerStack	Crop (const QPoint &, const QPoint &) const
	Crops a rectangular region in the terrain.

void	WaterFlood (const double &)
	Fill the terrain with a water body.

void	WaterFlood (const Vector2 &, const double &)
	Flood fills a region with water.

void	WaterDry (const Vector2 &)
	Dries a connex region, removing water using a flood fill algorithm.

void	SandOverall (const double &)
	Add sand over the terrain.

void	RockOverall (const double &)
	Add rock over the terrain.

QVector< Vector >	GetTrees () const
	<FONT COLOR="AA2222"><B>Warning</B></FONT>

Vector	Vertex (int, int) const
	Compute the vertex corresponding to a given sample.

Vector	Vertex (const Vector2 &) const
	Compute the elevation of a point, which is the sum of the bedrock, sand and rocks layers.

Vector	Normal (int, int) const
	Compute the normal at a given sample.

Color	GetColorVector (int, int) const
	Compute the vertex corresponding to a given sample.

double	Height (const Vector2 &) const
	Compute the elevation of a point, which is the sum of the bedrock, sand and rocks layers.

Vector	Normal (const Vector2 &, bool=false) const
	Compute the normal for a given position on the terrain.

void	Scale (const double &)
	Scale the layer-field.

void	Translate (const Vector2 &)
	Translate the layer-field.

void	Save (const QString &) const
	Save structure as a set of images.

Mesh	CreateWaterGeometry () const
	Create the geometry of the water on the terrain.

void	CreateCubes (Box &, QVector< FrameScaled > &, QVector< FrameScaled > &, QVector< FrameScaled > &, QVector< FrameScaled > &, QVector< FrameScaled > &, QVector< FrameScaled > &, bool=true, bool=true, bool=true, bool=true, bool=true, bool=true) const
	Create a material stack representation of the model.

Public Member Functions inherited from HeightFieldSediment
	HeightFieldSediment ()
	Create an empty terrain.

	HeightFieldSediment (const Box2 &, int, int)
	Create a flat terrain with no sediments.

	HeightFieldSediment (const ScalarField2 &)
	Create a terrain with no sediments from an elevation field.

	HeightFieldSediment (const ScalarField2 &, const ScalarField2 &)
	Create a terrain with sediments.

	~HeightFieldSediment ()
	Empty.

Array2	GetArray () const
	Return the array representing the grid domain.

ScalarField2	AlphaBlend () const
	Compute the alpha blending between sand and bedrock.

HeightField	GetHeightField () const
	Convert the layered model into a simple heightfield.

bool	Intersect (const Ray &, double &, Vector &) const
	Compute the intersection between a ray and the surface of the terrain.

void	SmoothRock (int=1)
	Smoothes the bedrock layer.

HeightField &	GetBedrock ()
	Access to the bedrock scalar field.

ScalarField2 &	GetSand ()
	Access to the sand scalar field.

double	Bedrock (const Vector2 &) const
	Compute the bedrock elevation.

double	Bedrock (int, int) const
	Return the bedrock elevation.

double	Sand (const Vector2 &) const
	Compute the sand thickness.

double	Sand (int, int) const
	Return the sand thickness.

void	Subdivide ()
	Double the resolution of the terrain.

void	BedrockFlatten (const Vector2 &, const double &, const double &=0.25)
	Flatten the bedrock around the target point.

void	BedrockLevel (const Vector2 &, const double &, const double &)
	Level the bedrock to the target elevation.

void	BedrockUplift (const double &)
	Modify the bedrock using a uniform uplift.

void	BedrockUplift (const ScalarField2 &)
	Uplift.

void	ThermalImpact (const double &)
	Globally transform a thin layer of bedrock into sediments.

void	ThermalImpactSlope (const double &)
	Globally transform a thin layer of bedrock into sediments.

void	Stabilize (const double &, const double &=0.84)
	Stabilizes sediments over the entire terrain.

bool	StabilizeStep (int, int, const double &, ScalarField2 &)
	Perform a stabilization step on the given layered cell.

int	CheckFlowSlope (const QPoint &, FlowStruct &) const
	Compute the flow directions at a given point.

int	CheckFlowDirectionsAngle (const QPoint &, const double &, QPoint , double , double , double ) const
	Compute the flow directions at a given point.

bool	SelectFlowDirection (const QPoint &, QPoint &, double &) const
	Select flow direction.

void	TRUC (const QPoint &q, const double &slope, const double &V_T, double &V_T_S, double &V_E_R, double &V_E_S, double &V_D_S)
	Compute eroded material.

Protected Attributes
ScalarField2	rocks
	Rocks.

ScalarField2	water
	Water.

ScalarField2	grass
	Grass.

ScalarField2	vegetation
	Vegetation.

ScalarField2	snow
	Snow.

ScalarField2	alpha
	Alpha.

Protected Attributes inherited from HeightFieldSediment
HeightField	bedrock
	Bedrock.

ScalarField2	sand
	Sand, i.e., sediments.

Additional Inherited Members
Protected Member Functions inherited from HeightFieldSediment
void	Evaporate (const double &, const double &, double &, double &, double &)
	Evaporate some water from the droplet.

Detailed Description

This class implements a layered heightfield.

Constructor & Destructor Documentation

◆ LayerStack() [1/4]

LayerStack::LayerStack	(	const Box2 &	box,
		int	x,
		int	y )

explicit

Create a terrain with different material layers.

Parameters

x,y	Subdivision of the terrain.
box	Domain.

◆ LayerStack() [2/4]

LayerStack::LayerStack ( const ScalarField2 & b )

explicit

Create terrain.

Parameters

b	Bedrock layer.

◆ LayerStack() [3/4]

LayerStack::LayerStack	(	const ScalarField2 &	b,
		const ScalarField2 &	s )

explicit

Create terrain.

Parameters

b	Bedrock layer.
s	Sediment layer.

◆ LayerStack() [4/4]

LayerStack::LayerStack	(	const ScalarField2 &	bedrock,
		const ScalarField2 &	rocks,
		const ScalarField2 &	sand,
		const ScalarField2 &	water,
		const ScalarField2 &	grass,
		const ScalarField2 &	vegetation,
		const ScalarField2 &	snow,
		const ScalarField2 &	alpha )

explicit

Create a layered terrain model.

Parameters

bedrock,rocks,sand,water,grass,vegetation,snow,alpha Set of layers.

Member Function Documentation

◆ CreateCubes()

void LayerStack::CreateCubes	(	Box &	cube,
		QVector< FrameScaled > &	bedrockcubes,
		QVector< FrameScaled > &	rockscubes,
		QVector< FrameScaled > &	sandcubes,
		QVector< FrameScaled > &	watercubes,
		QVector< FrameScaled > &	vegetationcubes,
		QVector< FrameScaled > &	grasscubes,
		bool	b = true,
		bool	r = true,
		bool	s = true,
		bool	w = true,
		bool	v = true,
		bool	g = true ) const

Create a material stack representation of the model.

Parameters

cube	Domain.
bedrockcubes,rockscubes,sandcubes,watercubes,vegetationcubes,grasscubes	Set of cubes.

Stacks are defined as scaled boxes, with a different box for every material.

Parameters

b,r,s,w,v,g Booleans defining whether the corresponding material should be generated.

◆ Crop()

LayerStack LayerStack::Crop	(	const QPoint &	a,
		const QPoint &	b ) const

Crops a rectangular region in the terrain.

Parameters

a,b	Rectangular region.

◆ GetBox()

Box LayerStack::GetBox ( ) const

Compute the bounding box of the terrain.

This function may be expensive as it finds the minimum and maximum elevations of the terrains.

◆ GetColorVector()

Color LayerStack::GetColorVector	(	int	i,
		int	j ) const

Compute the vertex corresponding to a given sample.

Parameters

i,j	Integer coordinates of the sample.

◆ GetHeightField()

HeightField LayerStack::GetHeightField	(	bool	r = true,
		bool	s = true ) const

Convert the layered model into a simple heightfield.

Rock and sand layers may be added to bedrock according to Boolean parameters.

Parameters

r	Rock flag.
s	Sand flag.

◆ Grass() [1/2]

double LayerStack::Grass ( const Vector2 & p ) const

inline

Return the grass elevation.

Parameters

p Point.

◆ Grass() [2/2]

double LayerStack::Grass	(	int	i,
		int	j ) const

inline

Return the grass elevation.

Parameters

i,j	Integer coordinates.

◆ Height()

double LayerStack::Height ( const Vector2 & p ) const

Compute the elevation of a point, which is the sum of the bedrock, sand and rocks layers.

Parameters

p Point.

◆ Intersect()

bool LayerStack::Intersect	(	const Ray &	ray,
		double &	t,
		Vector &	q ) const

Compute the intersection between a ray and the surface of the terrain.

The algorithm uses a ray marching approach, therefore this function may require many iterations and the resulting intersection may not be accurate.

Parameters

ray	The ray.
t	Intersection depth.
q	Intersection point.

◆ Normal() [1/2]

Vector LayerStack::Normal	(	const Vector2 &	p,
		bool	triangular = false ) const

Compute the normal for a given position on the terrain.

Note that this function may be expensive to compute.

Parameters

p	Point.
triangular	Boolean, use triangle normals if set to true, bilinear interpolation of normals at vertices otherwize.

◆ Normal() [2/2]

Vector LayerStack::Normal	(	int	i,
		int	j ) const

Compute the normal at a given sample.

This function uses the weighted sum (area) of the normals of the triangles sharing the point on the grid. The returned vector is normalized.

Parameters

i,j	Integer coordinates of the sample.

◆ RockOverall()

void LayerStack::RockOverall ( const double & s )

Add rock over the terrain.

Parameters

s	Rock thickness.

◆ Rocks() [1/2]

double LayerStack::Rocks ( const Vector2 & p ) const

inline

Return the rocks elevation.

Parameters

p Point.

◆ Rocks() [2/2]

double LayerStack::Rocks	(	int	i,
		int	j ) const

inline

Return the rocks elevation.

Parameters

i,j	Integer coordinates.

◆ SandOverall()

void LayerStack::SandOverall ( const double & s )

Add sand over the terrain.

Parameters

s	Sand thickness.

◆ Save()

void LayerStack::Save ( const QString & name ) const

Save structure as a set of images.

Parameters

name Name.

◆ Scale()

void LayerStack::Scale ( const double & s )

Scale the layer-field.

Parameters

s	Scaling factor.

◆ Translate()

void LayerStack::Translate ( const Vector2 & t )

Translate the layer-field.

Parameters

t	Translation vector.

◆ UpdateHeightField()

void LayerStack::UpdateHeightField	(	HeightField &	e,
		const QRect &	a = QRect(),
		bool	r = true,
		bool	s = true ) const

Convert the layer model into a simple heightfield.

Rock and sand layers may be added to bedrock according to Boolean parameters.

Parameters

e	Returned updated elevation.
a	Area.
r,s	Rock and flags.

◆ Vegetation() [1/2]

double LayerStack::Vegetation ( const Vector2 & p ) const

inline

Return the vegetation density.

Parameters

p Point.

◆ Vegetation() [2/2]

double LayerStack::Vegetation	(	int	i,
		int	j ) const

inline

Return the vegetation density.

Parameters

i,j	Integer coordinates.

◆ Vertex() [1/2]

Vector LayerStack::Vertex ( const Vector2 & p ) const

Compute the elevation of a point, which is the sum of the bedrock, sand and rocks layers.

Parameters

p Point.

◆ Vertex() [2/2]

Vector LayerStack::Vertex	(	int	i,
		int	j ) const

Compute the vertex corresponding to a given sample.

Parameters

i,j	Integer coordinates of the sample.

◆ Water() [1/2]

double LayerStack::Water ( const Vector2 & p ) const

inline

Return the water elevation.

Parameters

p Point.

◆ Water() [2/2]

double LayerStack::Water	(	int	i,
		int	j ) const

inline

Return the water elevation.

Parameters

i,j	Integer coordinates.

◆ WaterDry()

void LayerStack::WaterDry ( const Vector2 & p )

Dries a connex region, removing water using a flood fill algorithm.

Parameters

p	Starting point where the drying process starts.

◆ WaterFlood() [1/2]

void LayerStack::WaterFlood ( const double & height )

Fill the terrain with a water body.

This function also updates the vegetation and snow layers.

Parameters

height Water height.

◆ WaterFlood() [2/2]

void LayerStack::WaterFlood	(	const Vector2 &	p,
		const double &	h )

Flood fills a region with water.

Parameters

p	Starting point where the flood starts.
h	Water height.

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ LayerStack() [1/4]

◆ LayerStack() [2/4]

◆ LayerStack() [3/4]

◆ LayerStack() [4/4]

Member Function Documentation

◆ CreateCubes()

◆ Crop()

◆ GetBox()

◆ GetColorVector()

◆ GetHeightField()

◆ Grass() [1/2]

◆ Grass() [2/2]

◆ Height()

◆ Intersect()

◆ Normal() [1/2]

◆ Normal() [2/2]

◆ RockOverall()

◆ Rocks() [1/2]

◆ Rocks() [2/2]

◆ SandOverall()

◆ Save()

◆ Scale()

◆ Translate()

◆ UpdateHeightField()

◆ Vegetation() [1/2]

◆ Vegetation() [2/2]

◆ Vertex() [1/2]

◆ Vertex() [2/2]

◆ Water() [1/2]

◆ Water() [2/2]

◆ WaterDry()

◆ WaterFlood() [1/2]

◆ WaterFlood() [2/2]