Class SceneView
A user interface control that displays three-dimensional (3D) geographic content defined by a Scene.
Implements
Namespace: Esri.ArcGISRuntime.UI.Controls
Assembly: Esri.ArcGISRuntime.WinUI.dll
Syntax
[ContentProperty(Name = "Scene")]
public class SceneView : GeoView, IEquatable<DependencyObject>, IAnimationObject, IVisualElement, IVisualElement2, IEquatable<UIElement>, IEquatable<FrameworkElement>, ICustomQueryInterface, IWinRTObject, IDynamicInterfaceCastable, IEquatable<Control>, 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.
There is only one Scene per SceneView and it is set by the SceneView.Scene Property. Multiple Scene objects can be created and swapped out dynamically as the application is running in the SceneView.
To display a Scene, add a SceneView control to your app and assign the scene to it. This loads the scene, its Surface, Basemap and collection of operational layers, and displays their 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 of the SceneView is represented by the Viewpoint. It is determined by a Camera object and a CameraController is used to enable or constrain user interaction.
To zoom to the Viewpoint specified by a camera, pass the Camera to SetViewpointCamera(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.
In an MVC architecture, this class represents the View tier. The Model tier is represented by the Scene object which provides a collection of operational layers, a Basemap and a Surface. A Layer provides a visual representation of geographic information and comes in many forms. The types of layers that are displayed in a SceneView are three-dimensional in nature; meaning they are displayed in X/Y/Z coordinate space.
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 |
| ImageOverlaysProperty | Identifies the ImageOverlays 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. |
| AnalysisOverlays | Gets or sets a collection of analysis overlays that render the results of 3D visual analysis on the scene view. |
| 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. |
| ImageOverlays | Gets or sets the collection of overlays for displaying images in the scene view. |
| 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. |
| ScreenToBaseSurface(Point) | Converts the specified screen coordinate, relative to the upper-left corner of the scene view, to a location on the base surface in map coordinates. |
| ScreenToLocationAsync(Point) | Asynchronously converts a screen coordinate relative to the upper-left corner of the scene view to a location in map coordinates. |
| 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(Single, Single, Single, Single, Single, Single, 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 6.0 Windows | 100.13 - 200.1 |