Class LocalSceneView

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

Remarks

The LocalSceneView 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 LocalSceneView 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 LocalSceneView 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 LocalSceneView 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 LocalSceneView 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 LocalSceneView using one of its methods, such as SetViewpointCamera(Camera).

In an MVC architecture, the LocalSceneView 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 LocalSceneView, 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.

note

The GraphicsOverlays collection is not currently supported by the LocalSceneView and will not render. This will be enabled in a future release.

Constructors

Name	Description
LocalSceneView()	Initializes a new instance of the LocalSceneView class.

Fields

Name	Description
InteractionOptionsProperty	Identifies the InteractionOptions bindable property.
SceneProperty	Identifies the Scene bindable property.

Properties

Name	Description
Camera	Gets the current Camera for the view.
InteractionOptions	Gets or sets a set of properties that control user interaction with the LocalSceneView.
Scene	Gets or sets the scene that the LocalSceneView is displaying.
Warnings	Gets the warnings on the local scene view.

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 point in screen coordinates relative to the upper-left corner of the local scene view.
ScreenToBaseSurface(Point)	Converts the specified screen coordinate, relative to the upper-left corner of the local scene view, to a location on the base surface in geographic coordinates.
ScreenToLocationAsync(Point, CancellationToken)	Asynchronously converts a screen coordinate, relative to the upper-left corner of the LocalSceneView, to a location in scene coordinates.
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.

Events

Name	Description
WarningsChanged	Raised when the Warnings have changed on the view.

Applies to

Target	Versions
.NET	300
.NET Windows	300
.NET Android	300
.NET iOS	300