GlobeTileLayer Class
A layer that asynchronously loads and caches tiles in a GlobeView.
NuGet/Assembly: Carmenta.Engine.5.16.2.nupkg (in the CECore assembly)
Syntax
public class GlobeTileLayer : LayerSetRemarks
A GlobeTileLayer handles loading and unloading of tiles as the camera moves in a GlobeView. It calculates which tiles are visible and loads the presentation data for each on one or more, depending on the selected TileLoadingPolicy, background threads. During an update, the GUI thread only uses the tiles that are already loaded and does not wait for any more data to be read. This makes updates very fast, and can provide a high and steady frame rate.
A GlobeTileLayer should only be used for application layers in View.Layers; the tiling of the ground is handled automatically by the GlobeView.
A few properties control the loading of the tiles. The MaxScale property is used to limit how far from the camera position that tiles are loaded; this can be very important to specify to avoid performance problems. The MostDetailedTileScale property can be used to prevent the layer from using too small tiles. If you only have a data source with a single resolution, it is often unnecessary to split a tile into a number of smaller tiles, if they load the same data.
Selection is fully supported inside a GlobeTileLayer.
The task based scheduler will fall back and use a single background thread to load tiles if the GlobeTileLayer contains a CustomOperatorProxy with a custom operator implementation.
Inheritance Hierarchy
System.Object (not available in C#)
EngineObject
Layer
LayerSet
GlobeTileLayer
Platforms
Windows, Linux, Android
GlobeTileLayer Members
The GlobeTileLayer type has the following members.
Constructors
| Name | Description |
|---|---|
| GlobeTileLayer | Initializes a new instance of the GlobeTileLayer class. |
Properties
| Name | Description |
|---|---|
| AutoClip | Gets or sets a flag indicating if features are automatically clipped at the tile borders. |
| Condition | Gets or sets the Condition that determines whether the GlobeTileLayer is drawn or not. Inherited from Layer |
| Description | Gets or sets a short description of the layer. Inherited from Layer |
| DisableOnError | Gets or sets a value specifying if an error within the layer should automatically disable the layer, or throw an exception. Inherited from Layer |
| DisplayName | Gets or sets a display name for the layer. Inherited from Layer |
| Effects | List of effects Inherited from Layer |
| Enabled | Determines whether the GlobeTileLayer is enabled or not. Inherited from Layer |
| IsDisposed | Gets a value that tells whether the current GlobeTileLayer has been disposed. Inherited from EngineObject |
| IsoMetadataDocument | Gets or sets the path or URL to an ISO 19139 metadata document for the layer. Inherited from Layer |
| Layers | Gets the child layers of this GlobeTileLayer. Inherited from LayerSet |
| Legend | Gets or sets a map legend associated with this layer. Inherited from Layer |
| MaxScale | Gets or sets the highest inverted nominal scale in a 2D view, or the furthest distance in a 3D globe view, at which objects from this GlobeTileLayer should be drawn. Inherited from Layer |
| MostDetailedTileScale | Gets or sets a value specifying how detailed tiles the GlobeTileLayer should load. |
| Name | Gets or sets the name of the layer. Inherited from Layer |
| NamedStyles | Gets the list of named styles that can be enabled for the layer. Inherited from Layer |
| NativeHandle | Gets the native Carmenta Engine kernel object the current GlobeTileLayer represents. Inherited from EngineObject |
| Opacity | Gets or sets a value that specifies the opacity of the layer. Inherited from Layer |
| Selectable | Gets or sets a value that determines whether features in this GlobeTileLayer can be selected. Inherited from Layer |
| TileLoadingPolicy | Gets or sets a value that determines whether tiles are loaded in parallel or one by one. |
| IUserProperties.UserProperties | Gets the AttributeSet that contains the user properties. Inherited from IUserProperties |
Methods
| Name | Description |
|---|---|
| Clone | Creates a copy of an object. Inherited from EngineObject |
| Dispose | Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject |
| EnableStyle | Enables or disables a named style for the layer. Inherited from Layer |
| Equals | Determines whether this instance is equal to another. Inherited from EngineObject |
| FindChildObject | Overloaded. Finds the child object with the specified name. Inherited from Layer |
| FlushCache | Marks the layer as flushed which will release cached resources during the next update. Inherited from Layer |
| GetChildObjects | Overloaded. Gets the child objects of the current object. Inherited from Layer |
| GetDataBounds | Calculates the bounds of all dataset coverages in the layer. Inherited from Layer |
| GetFeatureAttributes | Gets information about all attributes that may be present on features in this layer. Inherited from Layer |
| GetFeatures | Overloaded. Gets features from the layer and any child layers. Inherited from Layer |
| GetLastError | Gets the error message for the last error that occurred within the layer. Inherited from Layer |
| GetLocalizedDescription | Gets a localized version of the layer description in a specific language. Inherited from Layer |
| GetLocalizedDisplayName | Gets a localized version of the layer display name in a specific language. Inherited from Layer |
| GetLocalizedIsoMetadataDocument | Gets the path to an ISO 19139 metadata document for a specific language. Inherited from Layer |
| HasLocalizedDescription | Checks if a localized version of the layer description is available in a specific language. Inherited from Layer |
| HasLocalizedDisplayName | Checks if a localized version of the layer display name is available in a specific language. Inherited from Layer |
| HasLocalizedIsoMetadataDocument | Checks if an ISO 19139 metadata document is available for a specific language. Inherited from Layer |
| IsStyleEnabled | Checks if a certain style is enabled for the layer or not. Inherited from Layer |
| MoveLayer | Moves a child layer to a new position. Inherited from LayerSet |
| SetLocalizedDescription | Sets a layer description in a specific language. Inherited from Layer |
| SetLocalizedDisplayName | Sets a layer display name in a specific language. Inherited from Layer |
| SetLocalizedIsoMetadataDocument | Sets the path to an ISO 19139 metadata document for the layer, for a specific language. Inherited from Layer |
Events
| Name | Description |
|---|---|
| EnabledChanged | Occurs when the value of the Enabled property has changed. Inherited from Layer |