Scene View
A view that displays 3D content from a ArcGISScene with a viewing mode of SceneViewingMode.Global. A scene view is a user interface that displays ArcGISScene layers and graphics on a spherical globe in 3D. It uses a camera to control the visible area (extent) of the ArcGISScene 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 ArcGISScene with a viewing mode of SceneViewingMode.Global, add this view to your app and assign the scene to it via SceneView.scene. 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 scene view 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 the scene view is defined by the position and orientation of a Camera. To determine the current visible area, call GeoView.getCurrentViewpoint. Make sure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint by calling GeoView.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 scene view using one of its methods, such as SceneView.setViewpointCamera. The scene view has a camera controller (SceneView.cameraController) to manage the camera's movement and user interactions.
In an MVC architecture, the scene view represents the View tier. The Model tier is represented by the ArcGISScene object which can provide a collection of operational layers, a Basemap and a Surface. You can only set one ArcGISScene per scene view, but you can replace the SceneView.scene with another when the application is running.
See Scene view for more information.
Since
200.0.0
Properties
The color of the scene view's ambient light.
The effect applied to the scene's atmosphere. The default value is AtmosphereEffect.HorizonOnly.
The camera controller manages the position, orientation, and movement of the camera for a scene view. The controller handles user-interaction with the scene view and updates the Camera. You can assign a CameraController with a specific navigation mode that is free roaming, following a moving target, fixed on a stationary target, or that supports AR transformation matrices. For more information, see CameraController.
The horizontal field of view of the scene view in degrees.
The ratio indicates how much the vertical field of view is distorted.
The InteractionOptions for this SceneView.
Indicates whether manual rendering is enabled or not.
A SharedFlow which emits DoubleTapEvent when the user double taps on the screen.
A SharedFlow which emits InteractiveZoomingChangeEvent when a user performs a pinch or double-tap-drag gesture on the GeoView.
A SharedFlow which emits LongPressEvent when a user holds a pointer on the screen.
A SharedFlow which emits PanChangeEvent when a user drags a pointer or pointers across the screen.
A SharedFlow which emits RotationChangeEvent when a user performs a rotation gesture on the GeoView.
A SharedFlow which emits ScaleChangeEvent when a user performs a pinch gesture on the GeoView.
A SharedFlow which emits SingleTapConfirmedEvents when the user taps once on the screen.
A SharedFlow which emits TwoPointerTapEvent when a user taps two pointers on the screen.
The visual effect of outer space in the scene view. The modes are black with stars or transparent. The default value is SpaceEffect.Stars.
The type of ambient sunlight and shadows in the scene view.
Inherited properties
A collection of analysis overlays that render the analysis results on the view.
A SharedFlow that emits when the view status of any analysis in the GeoView changes.
The attribution text for the data that is currently displayed in the GeoView.
The GeoView's current draw status.
The geo model error on the view. This error is used to indicate that the geo model assigned to the view had an issue loading or didn't meet the requirements after loading, resulting in nothing rendering on screen. The error could be resolved by replacing the geo model with one that meets the requirements or by ensuring the geo model can load successfully.
A collection containing the GraphicsOverlays.
A collection of overlays for displaying images in the view. An image overlay collection cannot belong to more that one GeoView.
True if attribution bar is visible in the GeoView, false otherwise.
Indicates whether the user is currently interacting with the GeoView.
Is the GeoView currently navigating.
True if continuous panning across the international date line is enabled in the GeoView, false otherwise. By default, a GeoView attempts to wrap the ArcGISMap or ArcGISScene across the international date line for a continuous panning user experience. The eastern and western hemispheres wrap to form a continuous map, giving the impression that the map is endless.
The view label properties. The view label properties are an overall control for whether labels will be created and displayed for layers added to the view. Individual layers can also control whether labels should be displayed for their features. Labels need to be enabled both in the view and in the layer. By default the labeling for a view is enabled. The view label properties also control global aspects of the label appearance e.g. animation effects.
A SharedFlow that emits when the view state of any layer in the GeoView changes.
A SharedFlow which emits a boolean to indicate that the navigation status of a GeoView has changed.
A SharedFlow that emits when the attribution bar's position or size changes due to expanding, collapsing, or inset changes.
The selection properties that is applied to the GeoView. This property allows configuration of new selection highlighting functionality such as selection promotion and switchable selection halo.
The SpatialReference is used to relate map coordinates to locations in the real world. This property is available when the view's map or scene has been loaded.
The current TimeExtent of the GeoView. The Time Extent of the GeoView defines how time-enabled data is displayed. Participating layers filter their data to only show data within the time extent set on the GeoView (see TimeAware for details). The range of the time extent includes the start and end values (a feature at 10/24/2016 would be included in a time extent defined as 10/24/2016 - 11/14/2016). Time filtering is not enabled until a non-null time extent is set on the GeoView. When the time extent is null on the GeoView, no time filtering is applied and all content is rendered.
A SharedFlow which notifies when the viewpoint of the view has changed.
Functions
Retrieves the camera that displays the current viewpoint.
Converts a location in map coordinates to a point in screen coordinates relative to the upper-left corner of the scene view.
Draws the scene based on a user-defined pulse.
Converts a screen coordinate to a location on the base surface in scene coordinates, considering only the scene's base surface and ignoring other scene content.
Converts a screen coordinate to a location in scene coordinates, considering both the scene's base surface and other scene content.
Sets the field of view on the scene view in degrees
Sets the field of view on the scene view in degrees and determines how much the vertical field of view is distorted.
Matches the field of view of the scene view to the field of view of a camera lens using the lens characteristics. All parameter values must be greater than 0.
Updates the display to the viewpoint specified by the given camera.
Animates the display to the viewpoint specified by the given camera.
Animates the display to the viewpoint specified by the given camera using the specified duration to arrive.
Inherited functions
Exports the current view to the provided buffer.
Retrieves the analysis' status in the view. This method is not supported on LocalSceneView.
Retrieve the current viewpoint for this GeoView.
Retrieve the layer's view state.
Initiate an Identify operation on the specified graphicsOverlay.
Initiate an Identify operation on all graphics overlays.
Initiate an Identify operation on the specified layer.
Initiate an Identify operation on all layers in the view.
Sets the GeoView's viewpoint with the bookmark's value. Applies the viewpoint of the bookmark to the GeoView.
Sets the TimeExtent? value of the timeExtent StateFlow property.
Change the GeoView to the new viewpoint. The viewpoint is updated instantaneously.
Change the GeoView to the new viewpoint with animation. This function uses the standard animation duration.
Change the GeoView to the new viewpoint with animation, taking the given number of seconds to complete the navigation.