Show / Hide Table of Contents

Class SceneView

A user interface control that displays three-dimensional (3D) geographic content defined by a Scene.

Inheritance
System.Object
GeoView
SceneView
Implements
Control
System.ComponentModel.INotifyPropertyChanged
GeoView.OnApplyTemplate()
GeoView.OnLostFocus(RoutedEventArgs)
GeoView.DrawStatusChanged
GeoView.LayerViewStateChanged
GeoView.SpatialReferenceChanged
GeoView.ViewpointChanged
GeoView.ShowCalloutForGeoElement(GeoElement, Windows.Foundation.Point, CalloutDefinition)
GeoView.ShowCalloutAt(MapPoint, CalloutDefinition)
GeoView.ShowCalloutAt(MapPoint, UIElement, Windows.Foundation.Point)
GeoView.DismissCallout()
GeoView.IsCalloutVisible
GeoView.ExportImageAsync()
GeoView.GraphicsOverlays
GeoView.GraphicsOverlaysProperty
GeoView.GetCurrentViewpoint(ViewpointType)
GeoView.SetViewpoint(Viewpoint)
GeoView.SetViewpointAsync(Viewpoint)
GeoView.SetViewpointAsync(Viewpoint, TimeSpan)
GeoView.SetBookmarkAsync(Bookmark)
GeoView.GetLayerViewState(Layer)
GeoView.IdentifyGraphicsOverlayAsync(GraphicsOverlay, Point, Double, Boolean)
GeoView.IdentifyGraphicsOverlayAsync(GraphicsOverlay, Point, Double, Boolean, Int64)
GeoView.IdentifyGraphicsOverlaysAsync(Point, Double, Boolean)
GeoView.IdentifyGraphicsOverlaysAsync(Point, Double, Boolean, Int64)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean, CancellationToken)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean, Int64)
GeoView.IdentifyLayerAsync(Layer, Point, Double, Boolean, Int64, CancellationToken)
GeoView.IdentifyLayersAsync(Point, Double, Boolean)
GeoView.IdentifyLayersAsync(Point, Double, Boolean, CancellationToken)
GeoView.IdentifyLayersAsync(Point, Double, Boolean, Int64)
GeoView.IdentifyLayersAsync(Point, Double, Boolean, Int64, CancellationToken)
GeoView.GeoViewTapped
GeoView.GeoViewDoubleTapped
GeoView.GeoViewHolding
GeoView.INotifyPropertyChanged.PropertyChanged
GeoView.IsAttributionTextVisible
GeoView.AttributionText
GeoView.IsAttributionTextVisibleProperty
GeoView.SpatialReference
GeoView.IsWrapAroundEnabled
GeoView.IsNavigating
GeoView.NavigationCompleted
GeoView.DrawStatus
GeoView.ViewInsets
GeoView.ViewInsetsProperty
GeoView.TimeExtent
GeoView.TimeExtentProperty
GeoView.Overlays
GeoView.OverlaysProperty
GeoView.GetViewOverlayAnchor(FrameworkElement)
GeoView.SetViewOverlayAnchor(FrameworkElement, MapPoint)
GeoView.ViewOverlayAnchorProperty
GeoView.SelectionProperties
GeoView.SelectionPropertiesProperty
GeoView.Labeling
GeoView.LabelingProperty
GeoView.Grid
GeoView.GridProperty
GeoView.ImageOverlays
Namespace: Esri.ArcGISRuntime.UI.Controls
Assembly: Esri.ArcGISRuntime.WinUI.dll
Syntax
public class SceneView : GeoView, INotifyPropertyChanged
Remarks

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 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, 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.

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

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.

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(Windows.Foundation.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(Windows.Foundation.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

TargetVersions
.NET Windows100.13 - 200.8
In This Article
Back to top Copyright © 2022 Esri.