Class SceneView
Inheritance
Implements
Namespace: Esri.ArcGISRuntime.UI.Controls
Assembly: Esri.ArcGISRuntime.WPF.dll
Syntax
public class SceneView : GeoView, IAnimatable, ISupportInitialize, IFrameworkInputElement, IInputElement, IQueryAmbient, INotifyPropertyChangedRemarks
The SceneView is a container that holds a Scene. A Scene holds a collection of operational layers and Basemap. Layers are visual representations of geographic information and come in many forms. The types of layers that are displayed in a SceneView are three dimensional.
A SceneView is a user interface that displays Scene layers and graphics on a spherical globe in 3D. It uses a camera to control the visible area (extent) of the Scene and supports user interactions such as pan, zoom, tilt, and rotate. A scene view also provides access to the underlying layer data in a scene.
To display a Scene with a viewing mode of Global, add a SceneView control to your app and assign the scene to it. This loads the scene and its content, such as a Surface, Basemap and collection of operational layers, and displays this content on screen.
User interactions such as pan, zoom, tilt, rotate, and identify or selection are supported in the SceneView using touch, mouse, keyboard, or pen/pencil. If required, you can override keys, clicks, and gestures to provide a specific user experience.
The visible area (Viewpoint) of a SceneView is defined by the position and orientation of a Camera. To determine the current visible area, call GetCurrentViewpoint(ViewpointType). Make sure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint by calling IsNavigating.
You can programmatically set the visible area by specifying a viewpoint. For example, to zoom to the Viewpoint specified by a camera, pass the Camera to the SceneView using one of its methods, such as SetViewpointCamera(Camera). The SceneView has a camera controller (CameraController) to manage the camera's movement and user interactions.
The scene view supports only Scene with a global SceneViewingMode in WGS84. For local scenes, use LocalSceneView.
In an MVC architecture, the SceneView represents the View tier. The Model tier is represented by the Scene object which can provide a collection of operational layers, a Basemap and a Surface. You can only set one Scene per SceneView, but you can swap the Scene with another when the application is running. See the Scene view discussion in the developer guide for more information.
Constructors
| Name | Description |
|---|---|
| SceneView() | Initializes a new instance of the SceneView class. |
Fields
| Name | Description |
|---|---|
| AmbientLightColorProperty | Identifies the AmbientLightColor dependency property. |
| AnalysisOverlaysProperty | Identifies the AnalysisOverlays dependency property. |
| AtmosphereEffectProperty | Identifies the AtmosphereEffect dependency property. |
| CameraControllerProperty | Identifies the CameraController dependency property |
| InteractionOptionsProperty | Identifies the InteractionOptions Dependency Property. |
| SceneProperty | Identifies the Scene dependency property |
| SpaceEffectProperty | Identifies the SpaceEffect dependency property. |
| SunLightingProperty | Identifies the SunLighting dependency property. |
| SunTimeProperty | Identifies the SunTime dependency property. |
Properties
| Name | Description |
|---|---|
| AmbientLightColor | Gets or sets the color of the scene view's ambient light. |
| AtmosphereEffect | Gets or sets the effect applied to the scene's atmosphere. |
| Camera | Gets the current Camera for the view. |
| CameraController | Gets or sets the camera controller that manages the position, orientation, and movement of the camera for a SceneView. |
| FieldOfView | Gets the horizontal field of view of the scene view in degrees. |
| FieldOfViewDistortionRatio | Gets how much the vertical field of view is distorted. |
| InteractionOptions | Gets or sets a set of properties that control user interaction with the SceneView. |
| Scene | Gets or sets the scene that the SceneView is displaying. |
| SpaceEffect | Gets or sets the visual effect of outer space in the scene view. The modes are black with stars or transparent. |
| SunLighting | Gets or sets the type of ambient sunlight and shadows in the scene view. |
| SunTime | Gets or sets the position of the sun in the scene view based on a specific date and time. |
Methods
| Name | Description |
|---|---|
| CancelSetViewpointOperations() | Cancels any pending or currently running SetViewpointAsync operations. |
| LocationToScreen(MapPoint) | Converts a location in map coordinates to a point in screen coordinates relative to the upper-left corner of the scene view. |
| LocationToScreen(MapPoint, out LocationVisibility) | Converts a location in map coordinates to a screen coordinate relative to the upper-left corner of the scene. |
| OnCreateAutomationPeer() | Returns a class-specific AutomationPeer implementation for the Microsoft UI Automation infrastructure. |
| ScreenToBaseSurface(Point) | Converts a screen coordinate to a location on the base surface in scene coordinates, considering only the scene's base surface and ignoring other scene content. |
| ScreenToLocationAsync(Point) | Converts a screen coordinate to a location in scene coordinates, considering both the scene's base surface and other scene content. |
| SetFieldOfView(double) | Sets the horizontal field of view of the scene view in degrees. |
| SetFieldOfView(double, double) | Sets the field of view on the scene view in degrees and determines how much the vertical field of view is distorted. |
| SetFieldOfView(float, float, float, float, float, float, DeviceOrientation) | Matches the field of view of the scene view to the field of view of a camera lens using the lens intrinsics characteristics. |
| SetViewpointCamera(Camera) | Immediately changes the display to the viewpoint specified by the given camera. |
| SetViewpointCameraAsync(Camera) | Changes the scene view to the new camera viewpoint asynchronously. |
| SetViewpointCameraAsync(Camera, TimeSpan) | Animates the display to the viewpoint specified by the given camera using the specified duration to arrive. |
Applies to
| Target | Versions |
|---|---|
| .NET Windows | 100.13 - 300.0 |
| .NET Framework | 100.0 - 200.8 |