HeightmapDescriptor Class Reference

Describes how a Heightmap should be loaded. More...

#include <HeightmapDescriptor.hh>

Public Member Functions
	HeightmapDescriptor ()
	Constructor.
	HeightmapDescriptor (const HeightmapDescriptor &_desc)
	Copy constructor.
	HeightmapDescriptor (HeightmapDescriptor &&_desc) noexcept
	Move constructor.
virtual	~HeightmapDescriptor ()
	Destructor.
void	AddBlend (const HeightmapBlend &_blend)
	Add a heightmap blend.
void	AddTexture (const HeightmapTexture &_texture)
	Add a heightmap texture.
const HeightmapBlend *	BlendByIndex (uint64_t _index) const
	Get a heightmap blend based on an index.
uint64_t	BlendCount () const
	Get the number of heightmap blends.
std::shared_ptr< common::HeightmapData >	Data () const
	Get the heightfield data.
const std::string &	Name () const
	Get the heightmap's name used for caching. This is different from its unique Heightmap::Name().
HeightmapDescriptor &	operator= (const HeightmapDescriptor &_desc)
	Copy Assignment operator.
HeightmapDescriptor &	operator= (HeightmapDescriptor &&_desc)
	Move assignment operator.
gz::math::Vector3d	Position () const
	Get the heightmap's position offset.
unsigned int	Sampling () const
	Get the heightmap's sampling per datum.
void	SetData (const std::shared_ptr< common::HeightmapData > &_data)
	Set the heightfield data.
void	SetName (const std::string &_name)
	Set the heightmap's name.
void	SetPosition (const gz::math::Vector3d &_position)
	Set the heightmap's position offset.
void	SetSampling (unsigned int _sampling)
	Set the heightmap's sampling. Defaults to 1.
void	SetSize (const gz::math::Vector3d &_size)
	Set the heightmap's final size in world units. Defaults to 1x1x1.
void	SetUseTerrainPaging (bool _use)
	Set whether the heightmap uses terrain paging. Defaults to false.
gz::math::Vector3d	Size () const
	Get the heightmap's final size in world units.
const HeightmapTexture *	TextureByIndex (uint64_t _index) const
	Get a heightmap texture based on an index.
uint64_t	TextureCount () const
	Get the number of heightmap textures.
bool	UseTerrainPaging () const
	Get whether the heightmap uses terrain paging.

Detailed Description

Describes how a Heightmap should be loaded.

gz/rendering/HeightmapDescriptor.hh

Constructor & Destructor Documentation

HeightmapDescriptor() [1/3]

HeightmapDescriptor

(

)

Constructor.

HeightmapDescriptor() [2/3]

HeightmapDescriptor

(

const HeightmapDescriptor &

_desc

)

Copy constructor.

Parameters

[in]

_desc

HeightmapDescriptor to copy.

HeightmapDescriptor() [3/3]

HeightmapDescriptor ( HeightmapDescriptor &&  _desc )

noexcept

Move constructor.

Parameters

[in]

_desc

HeightmapDescriptor to move.

~HeightmapDescriptor()

virtual ~HeightmapDescriptor ( )

virtual

Destructor.

Member Function Documentation

AddBlend()

void AddBlend

(

const HeightmapBlend &

_blend

)

Add a heightmap blend.

Parameters

[in]

_blend

Blend to add.

AddTexture()

void AddTexture

(

const HeightmapTexture &

_texture

)

Add a heightmap texture.

Parameters

[in]

_texture

Texture to add.

BlendByIndex()

const HeightmapBlend * BlendByIndex

(

uint64_t

_index

)

const

Get a heightmap blend based on an index.

Parameters

[in]

_index

Index of the heightmap blend. The index should be in the range [0..BlendCount()).

Returns

Pointer to the heightmap blend. Nullptr if the index does not exist.

See also

uint64_t BlendCount() const

BlendCount()

uint64_t BlendCount

(

)

const

Get the number of heightmap blends.

Returns

Number of heightmap blends contained in this Heightmap object.

Data()

std::shared_ptr< common::HeightmapData > Data

(

)

const

Get the heightfield data.

Returns

Heightmap data.

Name()

const std::string & Name

(

)

const

Get the heightmap's name used for caching. This is different from its unique Heightmap::Name().

Returns

Heightmap's given name. Defaults to Heightmap::Name().

operator=() [1/2]

HeightmapDescriptor & operator=

(

const HeightmapDescriptor &

_desc

)

Copy Assignment operator.

Parameters

[in]

_desc

The heightmap to set values from.

Returns

*this

operator=() [2/2]

HeightmapDescriptor & operator=

(

HeightmapDescriptor &&

_desc

)

Move assignment operator.

Parameters

[in]

_desc

HeightmapDescriptor to move.

Returns

Reference to this.

Position()

gz::math::Vector3d Position

(

)

const

Get the heightmap's position offset.

Returns

The heightmap's position offset.

Sampling()

unsigned int Sampling

(

)

const

Get the heightmap's sampling per datum.

Returns

The heightmap's sampling.

SetData()

void SetData

(

const std::shared_ptr< common::HeightmapData > &

_data

)

Set the heightfield data.

Parameters

[in]

_data

New data.

SetName()

void SetName

(

const std::string &

_name

)

Set the heightmap's name.

Parameters

[in]

_name

Heightmap's name.

SetPosition()

void SetPosition

(

const gz::math::Vector3d &

_position

)

Set the heightmap's position offset.

Parameters

[in]

_position

The heightmap's position offset.

SetSampling()

void SetSampling

(

unsigned int

_sampling

)

Set the heightmap's sampling. Defaults to 1.

Parameters

[in]

_sampling

The heightmap's sampling per datum.

SetSize()

void SetSize

(

const gz::math::Vector3d &

_size

)

Set the heightmap's final size in world units. Defaults to 1x1x1.

Parameters

[in]

_size

The heightmap's size factor.

SetUseTerrainPaging()

void SetUseTerrainPaging

(

bool

_use

)

Set whether the heightmap uses terrain paging. Defaults to false.

Parameters

[in]

_use

True to use.

Size()

gz::math::Vector3d Size

(

)

const

Get the heightmap's final size in world units.

Returns

The heightmap's size.

TextureByIndex()

const HeightmapTexture * TextureByIndex

(

uint64_t

_index

)

const

Get a heightmap texture based on an index.

Parameters

[in]

_index

Index of the heightmap texture. The index should be in the range [0..TextureCount()).

Returns

Pointer to the heightmap texture. Nullptr if the index does not exist.

See also

uint64_t TextureCount() const

TextureCount()

uint64_t TextureCount

(

)

const

Get the number of heightmap textures.

Returns

Number of heightmap textures contained in this Heightmap object.

UseTerrainPaging()

bool UseTerrainPaging

(

)

const

Get whether the heightmap uses terrain paging.

Returns

True if the heightmap uses terrain paging.

---

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

• HeightmapDescriptor.hh