ObjectTerrainGlobal Class
Inherits: | Object |
This class is used to create a global terrain object representing a certain fragment of Earth's surface on the basis of available GIS data (elevation and imagery). The global terrain is rendered using pre-generated tilesets which represent LODs for different data layers (heights, albedo and normals).
ObjectTerrainGlobal Class
Members
static ObjectTerrainGlobal()
Constructor. Creates a new empty global terrain object with default properties.void setAlbedoLodEnabled(int num, int enabled)
Enables or disables a given albedo LOD.Arguments
- int num - Albedo LOD number.
- int enabled - 1 to enable the LOD, 0 to disable it.
float getNormalLodClearDistance(int num)
Returns the clear distance of a given normal LOD. Starting from this distance the tiles of the LOD are removed from memory.Arguments
- int num - Normal LOD number.
Return value
Clear distance, in units.void setNormalLodClearDistance(int num, float distance)
Sets the clear distance of a given normal LOD. Starting from this distance the tiles of the LOD are removed from memory.Arguments
- int num - Normal LOD number.
- float distance - Clear distance, in units.
float getNormalLodTileDensity(int num)
Returns the density of a tile of a given normal LOD.Arguments
- int num - Normal LOD number.
Return value
Density of a normal LOD tile, in meters per pixel.string getNormalLodPath(int num)
Returns the path to a given normal LOD.Arguments
- int num - Normal LOD number.
Return value
Returns the path to a given normal LOD.void setHeightLodIntersection(int num, int enabled)
Enables or disables intersection detection for a given height LOD.Arguments
- int num - Height LOD number.
- int enabled - 1 to enable intersection detection, 0 to disable it.
void setHeightLodLoadDistance(int num, float distance)
Sets the load distance for a given height LOD. Starting from this distance the tiles of the LOD are loaded into memory.Arguments
- int num - Height LOD number.
- float distance - Load distance, in units.
float getHeightLodClearDistance(int num)
Returns the clear distance of a given height LOD. Starting from this distance the tiles of the LOD are removed from memory.Arguments
- int num - Height LOD number.
Return value
Clear distance, in units.void setHeightLodCollisionMask(int num, int mask)
Sets the collision mask for a given height LOD.Arguments
- int num - Height LOD number.
- int mask - Collision mask.
int getAlbedoLodViewportMask(int num)
Returns the viewport mask for a given albedo LOD.Arguments
- int num - Albedo LOD number.
Return value
Viewport mask.void setNormalLodLoadDistance(int num, float distance)
Sets the load distance for a given normal LOD. Starting from this distance the tiles of the LOD are loaded into memory.Arguments
- int num - Normal LOD number.
- float distance - Load distance, in units.
string getHeightLodPath(int num)
Returns the path to the folder where a given height LOD is stored.Arguments
- int num - Height LOD number.
Return value
Path to the folder where a given height LOD is stored.int getNormalLodEnabled(int num)
Returns a value indicating if a given normal LOD is enabled.Arguments
- int num - Normal LOD number.
Return value
1 if a given normal LOD is enabled; otherwise, 0.float getAlbedoLodClearDistance(int num)
Returns the clear distance of a given albedo LOD. Starting from this distance the tiles of the LOD are removed from memory.Arguments
- int num - Albedo LOD number.
Return value
Clear distance, in units.int getHeightNumLods()
Returns the total number of height LODs.Return value
Total number of height LODs.float getAlbedoLodVisibleDistance(int num)
Returns the visible distance of a given albedo LOD. Starting from this distance the tiles of the LOD become visible.Arguments
- int num - Albedo LOD number.
Return value
Visible distance, in units.string getHeightVideoMemoryUsage()
Returns information about the total video memory usage for all height LODs.Return value
Total video memory usage for all height LODs.void removeNormalLod(int num)
Removes a given normal LOD.Arguments
- int num - Normal LOD number.
void removeAlbedoLod(int num)
Removes a given albedo LOD.Arguments
- int num - Albedo LOD number.
void setNormalLodEnabled(int num, int enabled)
Enables or disables a given normal LOD.Arguments
- int num - Normal LOD number.
- int enabled - 1 to enable the LOD, 0 to disable it.
int getHeightLodCollision(int num)
Returns a value indicating if collision detection for a given height LOD is enabled.Arguments
- int num - Height LOD number.
Return value
1 if collision detection for a given LOD is enabled; otherwise, 0.int getHeightLodIntersection(int num)
Returns a value indicating if intersection detection for a given height LOD is enabled.Arguments
- int num - Height LOD number.
Return value
1 if intersection detection for a given LOD is enabled; otherwise, 0.void removeHeightLod(int num)
Arguments
- int num - Height LOD number.
int addAlbedoLod()
Adds a new albedo LOD.Return value
1 if a new albedo LOD was added successfully; otherwise, 0.void setAlbedoLodViewportMask(int num, int mask)
Sets the viewport mask for a given albedo LOD.Arguments
- int num - Albedo LOD number.
- int mask - Viewport mask.
float getNormalLodVisibleDistance(int num)
Returns the visible distance of a given normal LOD. Starting from this distance the tiles of the LOD become visible.Arguments
- int num - Normal LOD number.
Return value
Visible distance, in units.float getHeightLodLoadDistance(int num)
Returns the load distance for a given height LOD. Starting from this distance the tiles of the LOD are loaded into memory.Arguments
- int num - Height LOD number.
Return value
Load distance, in units.int getHeightLodIntersectionMask(int num)
Sets the intersection mask for a given height LOD.Arguments
- int num - Height LOD number.
Return value
Intersection mask.void setHeightLodViewportMask(int num, int mask)
Sets the viewport mask for a given height LOD.Arguments
- int num - Height LOD number.
- int mask - Viewport mask.
int addHeightLod()
Adds a new height LOD.Return value
1 if a new height LOD was added successfully; otherwise, 0.void setAlbedoLodPath(int num, string path)
Sets the path to the folder where a given albedo LOD is stored.Arguments
- int num - Albedo LOD number.
- string path - Path to the folder where a given albedo LOD is stored.
void setHeightLodPath(int num, string path)
Sets the path to the folder where a given height LOD is stored.Arguments
- int num - Height LOD number.
- string path - Path to the folder where a given height LOD is stored.
void setNormalLodViewportMask(int num, int mask)
Sets the viewport mask for a given normal LOD.Arguments
- int num - Normal LOD number.
- int mask - Viewport mask.
void setHeightLodClearDistance(int num, float distance)
Returns the clear distance of a given height LOD. Starting from this distance the tiles of the LOD are removed from memory.Arguments
- int num - Height LOD number.
- float distance - Clear distance, in units.
void setNormalLodVisibleDistance(int num, float distance)
Sets the visible distance of a given normal LOD. Starting from this distance the tiles of the LOD become visible.Arguments
- int num - Normal LOD number.
- float distance - Visible distance, in units.
string getNormalVideoMemoryUsage()
Returns information about the total video memory usage for all normal LODs.Return value
Total video memory usage for all normal LODs.void clear()
Removes all current terrain data from memory.void setHeightLodVisibleDistance(int num, float distance)
Sets the visible distance of a given height LOD. Starting from this distance the tiles of the LOD become visible.Arguments
- int num - Height LOD number.
- float distance - Visible distance, in units.
float getHeightLodTileDensity(int num)
Returns the density of a tile of a given height LOD.Arguments
- int num - Height LOD number.
Return value
Density of a height LOD tile, in meters per pixel.string getAlbedoLodPath(int num)
Returns the path to the folder where a given albedo LOD is stored.Arguments
- int num - Albedo LOD number.
Return value
Path to the folder where a given albedo LOD is stored.static ObjectTerrainGlobal cast(Node node)
Casts an ObjectTerrainGlobal out of the Node instance.Arguments
- Node node - Node instance.
Return value
ObjectTerrainGlobal instance.int addNormalLod()
Adds a new normal LOD.Return value
1 if a new normal LOD was added successfully; otherwise, 0.void setAlbedoLodClearDistance(int num, float distance)
Sets the clear distance of a given albedo LOD. Starting from this distance the tiles of the LOD are removed from memory.Arguments
- int num - Albedo LOD number.
- float distance - Clear distance, in units.
void setAlbedoLodLoadDistance(int num, float distance)
Sets the load distance for a given albedo LOD. Starting from this distance the tiles of the LOD are loaded into memory.Arguments
- int num - Albedo LOD number.
- float distance - Load distance, in units.
float getAlbedoLodLoadDistance(int num)
Returns the load distance for a given albedo LOD. Starting from this distance the tiles of the LOD are loaded into memory.Arguments
- int num - Albedo LOD number.
Return value
Load distance, in units.void setHeightLodIntersectionMask(int num, int mask)
Sets the intersection mask for a given height LOD.Arguments
- int num - Height LOD number.
- int mask - Intersection mask.
void setHeightLodEnabled(int num, int enabled)
Enables of disables a given height LOD.Arguments
- int num - Height LOD number.
- int enabled - 1 to enable the LOD, 0 to disable it.
int getHeightLodEnabled(int num)
Returns a value indicating if a given height LOD is enabled.Arguments
- int num - Height LOD number.
Return value
1 if a given height LOD is enabled; otherwise, 0.int getNormalNumLods()
Returns the total number of normal LODs.Return value
Total number of normal LODs.float getHeightLodVisibleDistance(int num)
Returns the visible distance of a given height LOD. Starting from this distance the tiles of the LOD become visible.Arguments
- int num - Height LOD number.
Return value
Visible distance, in units.static int type()
Returns the type of the object.Return value
Object Terrain Global type identifierstring getAlbedoVideoMemoryUsage()
Returns information about the total video memory usage for all albedo LODs.Return value
Total video memory usage for all albedo LODs.float getAlbedoLodTileDensity(int num)
Returns the density of a tile of a given albedo LOD.Arguments
- int num - Albedo LOD number.
Return value
Density of a height LOD tile, in meters per pixel.static ObjectTerrainGlobal cast(Object base)
Casts an ObjectTerrainGlobal out of the Object instance.Arguments
- Object base - Object instance.
Return value
ObjectTerrainGlobal instance.int getAlbedoNumLods()
Returns the total number of albedo LODs.Return value
Total number of albedo LODs.float getNormalLodLoadDistance(int num)
Returns the load distance for a given normal LOD. Starting from this distance the tiles of the LOD are loaded into memory.Arguments
- int num - Normal LOD number.
Return value
Load distance, in units.int getHeightLodViewportMask(int num)
Returns the viewport mask for a given height LOD.Arguments
- int num - Height LOD number.
Return value
Veiwport mask.int getHeightLodCollisionMask(int num)
Returns the collision mask for a given height LOD.Arguments
- int num - Height LOD number.
Return value
Collision mask.int getAlbedoLodEnabled(int num)
Returns a value indicating if a given albedo LOD is enabled.Arguments
- int num - Albedo LOD number.
Return value
1 if a given albedo LOD is enabled; otherwise, 0.int getNormalLodViewportMask(int num)
Returns the viewport mask for a given normal LOD.Arguments
- int num - Normal LOD number.
Return value
Viewport mask.void setHeightLodCollision(int num, int enabled)
Enables or disables collision detection for a given height LOD.Arguments
- int num - Height LOD number.
- int enabled - 1 to enable collision detection, 0 to disable it.
void setAlbedoLodVisibleDistance(int num, float distance)
Sets the visible distance of a given albedo LOD. Starting from this distance the tiles of the LOD become visible.Arguments
- int num - Albedo LOD number.
- float distance - Visible distance, in units.
void setNormalLodPath(int num, string path)
Sets the path to the folder where a given normal LOD is stored.Arguments
- int num - Normal LOD number.
- string path - Path to the folder where a given normal LOD is stored.
Last update: 2017-07-03
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)