Class Scene
The scene is a container for layers. You use a scene together with a SceneView or LocalSceneView to display layers of geographic data in 3D.
Namespace: Esri.ArcGISRuntime.Mapping
Assembly: Esri.ArcGISRuntime.dll
Syntax
public class Scene : GeoModel, INotifyPropertyChanged, ILoadableRemarks
The scene contains layers of mapping data and information such as elevation data, renderers, and labels which define the scene's capabilities. You can access the scene content directly or, more commonly, visualize a global scene in a SceneView or a local scene in a LocalSceneView depending on the SceneViewingMode.
In an MVC architecture, the scene represents the model and the scene view represents the 3D view. The scene specifies how the geographic data is organized, and the scene view renders the data on the screen and allows users to interact with it.
A scene can contain a base surface, a basemap, and one or more operational layers:
- A base surface is the default surface on which layers are draped or from which relative layers are offset. The ground height is provided by ElevationSource objects that are combined to make the Surface.
- A basemap helps orient the user of the scene. It is composed of a collection of base layers, such as imagery or hillshade, that are draped on the surface, and/or reference layers such as street labels that are displayed on top of operational layers. This content is relatively static.
- An operational layer provides content that is of unique interest to the app and the task at hand, such as data about earthquakes, traffic, or weather. This content can change frequently.
You can create a scene from an existing web scene using its URL or PortalItem. Alternatively, you can get a scene directly from a Scenes collection. Scene properties are hydrated when the scene is loaded.
If you create a new scene without specifying a spatial reference, the spatial reference of the first layer you add, which is typically the Basemap, defines the spatial reference of the entire scene.
See Scenes 3D) for more information about scenes.
Constructors
| Name | Description |
|---|---|
| Scene() | Initializes a new instance of the Scene class with a global SceneViewingMode. |
| Scene(Basemap) | Initializes a new instance of the Scene class with a global SceneViewingMode and a Basemap. |
| Scene(BasemapStyle) | Initializes a new instance of the Scene class with a global SceneViewingMode and a BasemapStyle. |
| Scene(SceneViewTilingScheme) | Initializes a new instance of the Scene class with a global SceneViewingMode and a specific tiling scheme. |
| Scene(SceneViewingMode) | Initializes a new instance of the Scene class with the specified SceneViewingMode. |
| Scene(SceneViewingMode, SpatialReference) | Initializes a new instance of the Scene class with the specified SceneViewingMode and SpatialReference. |
| Scene(SceneViewingMode, Basemap) | Initializes a new instance of the Scene class with the specified SceneViewingMode and Basemap. |
| Scene(SceneViewingMode, BasemapStyle) | Initializes a new instance of the Scene class with the specified SceneViewingMode and BasemapStyle |
| Scene(Item) | Initializes a new instance of the Scene class a portal item of type WebScene. |
| Scene(Uri) | Initializes a new instance of the Scene class with a Uri to a web scene. |
Properties
| Name | Description |
|---|---|
| BaseSurface | Gets or sets the base surface for the scene. |
| ClippingArea | Gets or sets the area that defines what is clipped for display. |
| Environment | Gets or sets the environment when the scene is displayed. |
| IsClippingEnabled | Gets or sets a value indicating whether clipping is enabled. |
| SceneViewTilingScheme | Gets the SceneViewTilingScheme that defines how tile based data is rendered. |
| ViewingMode | Gets the viewing mode of the scene, either global or local. |
Methods
| Name | Description |
|---|---|
| FromJson(string) | Creates a scene from the specified JSON. |
Applies to
| Target | Versions |
|---|---|
| .NET Standard 2.0 | 100.3 - 200.8 |
| .NET | 100.13 - 300.0 |
| .NET Windows | 100.13 - 300.0 |
| .NET Android | 200.0 - 300.0 |
| .NET iOS | 200.0 - 300.0 |
| .NET Framework | 100.0 - 200.8 |
| Xamarin.Android | 100.0 - 100.15 |
| Xamarin.iOS | 100.0 - 100.15 |
| UWP | 100.0 - 200.8 |