Class SceneView

[ContentProperty("Scene")]
[WinRTRuntimeClassName("Microsoft.UI.Xaml.Data.INotifyPropertyChanged")]
[WinRTExposedType(typeof(SceneViewWinRTTypeDetails))]
public class SceneView : GeoView, INotifyPropertyChanged, IVisualTreeElement, IEffectControlProvider, IToolTipElement, IContextFlyoutElement, IAnimatable, IViewController, IVisualElementController, IElementController, IGestureController, IGestureRecognizers, IPropertyMapperView, IHotReloadableView, IReplaceableView, ISceneView, IGeoView, IView, IElement, ITransform

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 bindable property.
AnalysisOverlaysProperty	Identifies the AnalysisOverlays bindable property.
AtmosphereEffectProperty	Identifies the AtmosphereEffect bindable property.
CameraControllerProperty	Identifies the CameraController bindable property.
InteractionOptionsProperty	Identifies the InteractionOptions bindable property.
SceneProperty	Identifies the Scene bindable property.
SpaceEffectProperty	Identifies the SpaceEffect bindable property.
SunLightingProperty	Identifies the SunLighting bindable property.
SunTimeProperty	Identifies the SunTime bindable 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
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(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	200.0 - 300.0
.NET Windows	200.0 - 300.0
.NET Android	200.0 - 300.0
.NET iOS	200.0 - 300.0