Viewpoint QML Type

GeoModel that is displayed in a GeoView on a user's screen."> Viewpoint QML Type | ArcGISQtQml
  • Esri.ArcGISRuntime
  • Viewpoint
  • Defines the visible area of a GeoModel that is displayed in a GeoView on a user's screen. More...

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

    Object

    Inherited By:

    ViewpointCenter and ViewpointExtent

    Properties

    Signals

    Methods

    • bool equals(Viewpoint other)

    Detailed Description

    In a MapView, the bounding extent of a geometry or the map's center point and scale can define the map view's two-dimensional Viewpoint.

    In a SceneView, a Camera represents the observer's position and perspective within three dimensions and defines the scene view's three-dimensional Viewpoint. Each camera has the following properties:

    • Geographic location on the surface (longitude and latitude).
    • Altitude (height, in meters, above sea level).
    • Heading (angle about the z axis the camera is rotated, in degrees).
    • Pitch (angle the camera is rotated up or down, in degrees).
    • Roll (angle the camera is rotated side-to-side, in degrees).

    When you publish or save a map or scene, as a web map, web scene, mobile map package, or mobile scene package, you define its initial Viewpoint. When you load a map or scene into your app, you can access and change the value of this GeoModel::initialViewpoint. If you add the map or scene to a GeoView, any change you make to the GeoModel::initialViewpoint is ignored. To change the Viewpoint of a displayed map or scene, use view methods such as:

    To determine the current visible area, call GeoView::currentViewpointExtent. Make sure that any user-initiated or programmatic navigation is complete before getting the current Viewpoint by calling GeoView::navigating.

    See also JsonSerializable.

    Property Documentation

    [default] camera : Camera

    The viewpoint's Camera, if it has one (read-only).

    See also Viewpoint.


    json : jsobject

    The JSON representing this Viewpoint.


    rotation : string

    The viewpoint rotation angle in degrees between 0 and 360 (read-only).

    See also Viewpoint.


    [read-only] unknownJson : jsobject

    Returns the unknown JSON from the source JSON.

    Unknown JSON is a jsobject of values not defined in the ArcGIS specification used to create this object but found in the source JSON. If the object is written back to JSON, any unknown JSON data is not persisted. The ArcGIS specification may be for a web map, web scene, REST API, and so on.


    [read-only] unsupportedJson : jsobject

    Returns the unsupported data from the source JSON.

    See also JsonSerializable.


    [read-only] viewpointType : Enums.ViewpointType

    Returns the Enums.ViewpointType of this Viewpoint (read-only).

    This will be defined by a geometry or a Point geometry and scale.

    See also Viewpoint.


    Signal Documentation

    [since Esri.ArcGISRuntime 100.4] cameraChanged()

    Emitted when the camera property changes.

    Note: This signal will only be emitted when the property initializes during the instantiation of the component.

    Note: The corresponding handler is onCameraChanged.

    This signal was introduced in Esri.ArcGISRuntime 100.4.


    [since Esri.ArcGISRuntime 100.4] rotationChanged()

    Emitted when the rotation property changes.

    Note: This signal will only be emitted when the property initializes during the instantiation of the component.

    Note: The corresponding handler is onRotationChanged.

    This signal was introduced in Esri.ArcGISRuntime 100.4.


    Method Documentation

    [since Esri.ArcGISRuntime 200.1] bool equals(Viewpoint other)

    Compares two Viewpoints for equality.

    Returns whether this instance and other are equivalent.

    This method was introduced in Esri.ArcGISRuntime 200.1.


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