Class SceneView

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

Inheritance
System.Object
GeoView
SceneView
Implements
IView
Namespace: Esri.ArcGISRuntime.Maui
Assembly: Esri.ArcGISRuntime.Maui.dll
Syntax
public class SceneView : GeoView, ISceneView, IGeoView
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 two dimensional in nature; meaning they are displayed in X/Y (a.k.a. Latitude/Longitude) coordinate space.

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 Esri.ArcGISRuntime.UI.Controls.GeoView.GetCurrentViewpoint(Esri.ArcGISRuntime.Mapping.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 bindable property.
AnalysisOverlaysProperty

Identifies the AnalysisOverlays bindable property.
AtmosphereEffectProperty

Identifies the AtmosphereEffect bindable property.
CameraControllerProperty

Identifies the CameraController bindable property.
ImageOverlaysProperty

Identifies the ImageOverlays 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.
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
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

TargetVersions
.NET200.0 - 200.6
.NET Windows200.0 - 200.6
.NET Android200.0 - 200.6
.NET iOS200.0 - 200.6