The following members of class SceneView are deprecated. They are provided to keep old source code working. We strongly advise against using them in new code.
Public Functions
(deprecated) Esri::ArcGISRuntime::TaskWatcher | screenToLocation(double screenX, double screenY) |
(deprecated) Esri::ArcGISRuntime::TaskWatcher | setViewpointCamera(const Esri::ArcGISRuntime::Camera &camera) |
(deprecated) Esri::ArcGISRuntime::TaskWatcher | setViewpointCamera(const Esri::ArcGISRuntime::Camera &camera, float durationSeconds) |
Protected Functions
(deprecated) virtual void | screenToLocationCompletedEvent(QUuid taskId, const Esri::ArcGISRuntime::Point &location) |
(deprecated) virtual void | setViewpointCameraCompletedEvent(bool success) |
Member Function Documentation
Esri::ArcGISRuntime::TaskWatcher SceneView::screenToLocation (double screenX , double screenY )
This function is deprecated. We strongly advise against using it in new code.
Asynchronously converts a screen coordinate relative to the upper-left corner of the scene view to a location in map coordinates.
This is a high performance calculation executed on the GPU using a triangular mesh. Note that elevation values are approximated, and as the distance between the camera and the surface increases, the precision of the elevation value decreases.
This method will wait for the next drawing cycle to get the exact point from the graphics card that is at the screen coordinate supplied. This location could be on the surface, a building, or a feature.
To call this method, assign a scene to the scene view, ensure that it is loaded and the draw status is DrawStatus::Completed).
- screenX - The screen's x-coordinate to convert to map coordinate.
- screenY - The screen's y-coordinate to convert to map coordinate.
Note: This operation could return an empty point (clicked outside the earth).
[virtual protected]
void SceneView::screenToLocationCompletedEvent (QUuid taskId , const Esri::ArcGISRuntime::Point &location)
This function is deprecated. We strongly advise against using it in new code.
Override this method to perform custom logic when a screenToLocation operation completes.
- taskId - The task ID of the operation.
- location - The location in scene coordinates.
Esri::ArcGISRuntime::TaskWatcher SceneView::setViewpointCamera (const Esri::ArcGISRuntime::Camera &camera)
This function is deprecated. We strongly advise against using it in new code.
Immediately changes the display to the viewpoint specified by the given camera.
The Camera determines at what position and angle the scene is viewed. Animates the display to the viewpoint specified by the given camera.
- camera - The new camera information for the scene view.
Esri::ArcGISRuntime::TaskWatcher SceneView::setViewpointCamera (const Esri::ArcGISRuntime::Camera &camera, float durationSeconds )
This function is deprecated. We strongly advise against using it in new code.
Animates the display to the viewpoint specified by the given camera using the specified duration to arrive.
The Camera determines at what position and angle the scene is viewed.
Use SceneView::setViewpointCamera to set a viewpoint that animates over a specified duration.
- camera - The new camera information for the scene view.
- durationSeconds - The time for the transition animation to complete, in seconds.
[virtual protected]
void SceneView::setViewpointCameraCompletedEvent (bool success)
This function is deprecated. We strongly advise against using it in new code.
Override this method to perform custom logic when a setViewpointCamera operation completes.
- success
true
if setting the viewport camera completed successfully.