Surface QML Type

  • Esri.ArcGISRuntime
  • Surface
  • The surface contains elevation sources and defines a surface upon which layers and overlays can be draped. More...

    Import Statement: import Esri.ArcGISRuntime
    Since: Esri.ArcGISRuntime 100.0
    Inherits:

    Object

    Properties

    Signals

    Methods

    Detailed Description

    The surface is used to represent the ground in a scene. It is comprised of a collection of elevation sources (ElevationSource) which are combined in the scene to generate the surface.

    This QML type supports the following default properties. A default property may be declared inside another declared object without being assigned explicitly to a property.

    TypeDefault Property
    ElevationSourceelevationSources (appends to model)
    BackgroundGridbackgroundGrid (since Esri.ArcGISRuntime 100.1)

    The QML type Surface contains a list of elevation sources, and defines a surface upon which layers and overlays can be draped. The order of the elevation sources determines how the elevations are blended together for each level of detail.

    See also Loadable and Cancelable.

    Property Documentation

    [default, since Esri.ArcGISRuntime 100.1] backgroundGrid : BackgroundGrid

    Grid and color settings to render the background grid of this surface.

    The background grid is visible when no data is draped on the surface.

    This property was introduced in Esri.ArcGISRuntime 100.1.


    elevationExaggeration : real

    The elevation exaggeration for the surface.

    The altitude values of the surface data are multiplied by the exaggeration value. The default value is 1.0, indicating no exaggeration.


    [default] elevationSources : ElevationSourceListModel

    Returns the list of elevation sources for the surface (read-only).

    Elevation sources are an ordered collection of ElevationSource data that are combined to generate elevation values for the surface. The order of the elevation sources in the collection indicate which elevation has priority when the sources are spatially coincident. The collection is specific to a surface so you cannot reuse an elevation source collection coming from another Surface.

    See also Surface.


    enabled : bool

    true if the surface is enabled, false otherwise.

    This value indicates if the surface is enabled and is rendered. If true, the surface's elevation sources are only used in the calculation of the surface if their ElevationSource::enabled is also true.


    [read-only] loadError : Error

    Returns the load error (read-only).

    Note: load errors are also reported on the error property and emit the errorChanged signal.

    See also Loadable.


    [read-only] loadStatus : Enums.LoadStatus

    Returns an enumeration value for the current load status of the surface (read-only).

    See also Loadable and Enums.LoadStatus.


    [read-only] locationToElevationResult : double

    The elevation calculated by locationToElevation method for the specified map point.

    The elevation is expressed in meters above sea level.


    [read-only] locationToElevationStatus : Enums.TaskStatus

    Returns the status of the latest asynchronous task to calculate the elevation of a location (read-only).

    The task is started using locationToElevation.

    See also Enums.TaskStatus.


    name : string

    The name of the surface.


    The type of navigation constraint of the surface.

    This property determines whether the camera altitude is affected by the elevation at the location of the camera. You can restrict the camera to stay above the ground or allow it to move below the surface. The default value is Enums.NavigationConstraintStayAbove.

    This property was introduced in Esri.ArcGISRuntime 100.5.


    [since Esri.ArcGISRuntime 100.5] opacity : real

    The opacity applied to the surface.

    The opacity value of all layers in the basemap, associated with this surface, and the backgroundGrid are multiplied by this opacity value. The value can be between 0 and 1.0, where 0 is transparent and 1.0 is solid or opaque.

    You can adjust this ground surface opacity property to see through the ground. Changing this property also changes the transparency of the basemap. (Draped operational layers are not affected by this property.) Valid values are from 0.0 (full transparency) to 1.0 (full opacity).

    The opacity affects all base layers and the grid color:

    • If an individual base layer has 50% opacity and the surface has 50% opacity, the effect will be multiplicative, i.e. the base layer will appear to have 25% opacity.
    • If the grid color has an alpha value of 50% and the surface has 50% opacity, the effect on the grid will also be multiplicative.

    The default value is 1.0.

    This property was introduced in Esri.ArcGISRuntime 100.5.


    Signal Documentation

    [since Esri.ArcGISRuntime 100.1] backgroundGridChanged()

    Emitted when the backgroundGrid property changes.

    Note: The corresponding handler is onBackgroundGridChanged.

    This signal was introduced in Esri.ArcGISRuntime 100.1.


    elevationExaggerationChanged()

    Emitted when the elevationExaggeration property of the surface changes.

    Note: The corresponding handler is onElevationExaggerationChanged.


    enabledChanged()

    Emitted when the enabled property of the surface changes.

    Note: The corresponding handler is onEnabledChanged.


    loadErrorChanged()

    Emitted when the loadError property of the surface changes.

    Note: load errors are also reported on the error property and emit the errorChanged signal.

    Note: The corresponding handler is onLoadErrorChanged.

    See also Loadable and Object.


    loadStatusChanged()

    Emitted when the loadStatus property of the surface changes.

    Note: The corresponding handler is onLoadStatusChanged.

    See also Loadable.


    locationToElevationStatusChanged()

    Emitted when the locationToElevationStatus property of the surface changes.

    Note: The corresponding handler is onLocationToElevationStatusChanged.


    nameChanged()

    Emitted when the name property of the surface changes.

    Note: The corresponding handler is onNameChanged.


    Emitted when the navigationConstraint property changes.

    Note: The corresponding handler is onNavigationConstraintChanged.

    This signal was introduced in Esri.ArcGISRuntime 100.5.


    [since Esri.ArcGISRuntime 100.5] opacityChanged()

    Emitted when the opacity property changes.

    Note: The corresponding handler is onOpacityChanged.

    This signal was introduced in Esri.ArcGISRuntime 100.5.


    Method Documentation

    void cancelLoad()

    See also Loadable.


    bool cancelTask(string taskId)

    Cancel the task with the ID taskId.

    Returns false if the task cannot be canceled or there is no task with the specified id taskId.

    See also Cancelable.


    void load()

    See also Loadable.


    string locationToElevation(Point location)

    Gets the elevation (in meters) for the specified location on the surface using an asynchronous task.

    Before calling this method, check the locationToElevationStatus property to see whether a locationToElevation task is already in progress. If so, then this method cannot start a new task.

    Returns a task ID that can be used to cancel the task.

    See also Cancelable.


    void retryLoad()

    See also Loadable.


    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.