# Unigine.TerrainGlobalLods Class (CPP)

**Header:** #include <UnigineObjects.h>


This class is used to manage a group of [LODs](../../../objects/objects/terrain/terrain_global/index.md#lods) (level of detail) of the [global terrain](../../../objects/objects/terrain/terrain_global/index.md) object.


## TerrainGlobalLods Class

### Members

## int getNumLods () const

Returns the current total number of lods in the group.
### Return value

Current total number of lods in the group
## void setNumLayers ( int layers )

Sets a new number of layers of the lod group.
### Arguments

- *int* **layers** - The number of layers of the lod group

## int getNumLayers () const

Returns the current number of layers of the lod group.
### Return value

Current number of layers of the lod group
## int getMaskFormat () const

Returns the current value indicating current image format for the tile mask. One of the [Image::FORMAT_*](../../../api/library/common/class.image_cpp.md) values.
### Return value

Current value indicating current image format for the tile mask
## int getDataFormat () const

Returns the current value indicating current image format for the tile data. One of the [Image::FORMAT_*](../../../api/library/common/class.image_cpp.md#FORMAT_ATI1) values.
### Return value

Current value indicating current image format for the tile data
## int getDataType () const

Returns the current value indicating current image type for the tile data. One of the [Image::IMAGE_*](../../../api/library/common/class.image_cpp.md#IMAGE_2D) values.
### Return value

Current value indicating current image format for the tile data
## int getType () const

Returns the current type of lods.
### Return value

Current type of lods
## const char * getName () const

Returns the current name of the lod group.
### Return value

Current name of the lod group
---

## int addLod ( )

Adds a new LOD.
### Return value

Index of the last added LOD.
## void insertLod ( int num )

Inserts a new LOD at the specified position.
### Arguments

- *int* **num** - Position to insert a new LOD at.

## void removeLod ( int num )

Removes the LOD with the specified number.
### Arguments

- *int* **num** - LOD number.

## void clearLods ( )

Removes all LODs.
## int fetch ( const BoundSphere & bs , const BoundBox & bb , int force = 0 )

Loads the data of all LODs for the tiles within a given bounding box and a bounding sphere.
### Arguments

- *const [BoundSphere](../../../api/library/math/bounds/class.boundsphere_cpp.md) &* **bs** - Bounding sphere.
- *const [BoundBox](../../../api/library/math/bounds/class.boundbox_cpp.md) &* **bb** - Bounding box.
- *int* **force** - Force flag. Use 1 to load files in any case; otherwise, 0. The default value is 0.

### Return value

**1** if the data of all LODs was fetched successfully; otherwise, 0.
## int fetchData ( double x , double y , Image::Pixel & ret_pixel , int layer , bool force )

Fetches the data for the point on the terrain with given coordinates and puts it to the specified output structure.
### Arguments

- *double* **x** - X coordinate of the point on the terrain.
- *double* **y** - Y coordinate of the point on the terrain.
- *[Image::Pixel](../../../api/library/common/class.image_cpp.md#Pixel) &* **ret_pixel** - Output [Pixel structure](../../../api/library/common/class.image_cpp.md#pixel) to store the pixel color.
- *int* **layer** - Layer number.
- *bool* **force** - Force flag. > **Notice:** It is recommended to set this flag to 0 when possible to avoid spikes. .

  - If 1 is specified, the data will be fetched immediately.
  - If 0 is specified, the operation will be queued to a separate thread.

### Return value

**1** if the data for the specified pixel was fetched successfully; otherwise, 0.
## Ptr < TerrainGlobalLod > getLod ( int num )

Returns the LOD with a given number.
### Arguments

- *int* **num** - LOD number.

### Return value

Pointer to TerrainGlobalLod.
## String getVideoMemoryUsage ( )

Returns information about the total video memory usage for all LODs in the group.
### Return value

Total video memory usage for all LODs.