OrbitGeoElementCameraController QML Type

GeoElement object."> OrbitGeoElementCameraController QML Type | ArcGISQtQml
  • Esri.ArcGISRuntime
  • OrbitGeoElementCameraController
  • Support Orbital Camera navigation around a stationary or moving point GeoElement object. More...

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

    CameraController

    Properties

    Signals

    Methods

    Detailed Description

    Camera controllers can be applied to a SceneView to determine the camera interaction and navigation model.

    Setting this type as the CameraController for a SceneView will ensure that the camera is always focused on the targetGeoElement. The controller allows the camera to be adjusted relative to the orientation of the targetGeoElement.

    When the target moves, the camera will move with the target to maintain its relative position. To update the target's heading, pitch and roll you must use a Renderer and GeoElement attributes.

    When using a Graphic as the GeoElement, the Graphic and the GraphicsOverlay that contains it must be added to the SceneView before you add the OrbitGeoElementCameraController to the SceneView.

    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
    GeoElementtargetGeoElement

    See also CameraController, Cancelable, OrbitLocationCameraController, and GlobeCameraController.

    Property Documentation

    autoHeadingEnabled : bool

    Determines if cameraHeadingOffset is updated with target's heading.

    If true, the camera will maintain its heading offset when the target's heading changes. Defaults to true. The graphic's heading can be controlled using an expression in the renderer class.

    See also RendererSceneProperties::headingExpression.


    autoPitchEnabled : bool

    Whether the camera pitch offset is updated with target's pitch.

    If true, the camera will maintain its pitch offset when the target's pitch changes. The target's pitch can be controlled using an expression in the renderer class.

    See also RendererSceneProperties::pitchExpression.


    autoRollEnabled : bool

    whether the camera roll offset is updated with target's roll.

    If true, the camera will maintain its roll offset when the target's roll changes. Defaults to true. The graphic's roll can be controlled using an expression in the renderer class.

    See also RendererSceneProperties::rollExpression.


    cameraDistance : double

    The distance from the target object to the camera in meters.

    This value must be greater than 0.


    cameraDistanceInteractive : bool

    Enables user interactions for changing the distance/zoom between the camera and the target object.

    When true, the user may zoom towards and away from the targetGeoElement using mouse/touch interactions with the view.

    The default setting is true.


    cameraHeadingOffset : double

    The heading offset of the camera, in degrees, relative to the target object.

    The camera heading offset is a clockwise angle in the target's horizontal plane, starting from the heading of the target.

    For example, if the target has a heading of 45°,a heading offset of 10 for the camera controller indicates an effective compass bearing of 55°.

    Any angle in degrees is valid: the value will be wrapped between -180° and 180°.

    The default is 0°.


    cameraHeadingOffsetInteractive : bool

    Enables user interactions for changing the heading offset between the camera and the target object.

    Set this property to true to allow the user to interactively change the heading between the camera and the target object using mouse/touch interactions with the view.


    cameraPitchOffset : double

    The pitch offset of the camera, in degrees, relative to the target object.

    An anti-clockwise angle from the positive z-axis of the target element to the target's horizontal plane. Any angle is valid: the value will be wrapped between 0° and 180°.

    The default is 45°.


    cameraPitchOffsetInteractive : bool

    Enables user interactions for changing the pitch offset between the camera and the target object.

    Set this property true to allow the user to interactively change the pitch of the camera relative to the target object using mouse/touch interactions with the view.


    maxCameraDistance : double

    The maximum distance from the camera to the target in meters.

    There is no limit on the set maximum distance. Animations and interactions are bounded by this limit.


    maxCameraHeadingOffset : double

    The maximum camera heading offset in degrees.

    Any angle, positive or negative. Will be wrapped to a clockwise angle in (0, 360). Animations and interactions are bounded by this limit.

    This value must be greater than minCameraHeadingOffset.


    maxCameraPitchOffset : double

    The maxCameraPitchOffset of the OrbitGeoElementCameraController.

    The maximum camera Pitch. Must be between (MinCameraPitchOffset, 90). Defaults to 90. Animations and interactions are bounded by this limit.

    Defaults to 180°.


    minCameraDistance : double

    minimum distance from the camera to the target in meters.

    Animations and interactions are bounded by this limit.

    Defaults to 0.


    minCameraHeadingOffset : double

    The minimum camera heading offset in degrees.

    The minimum camera Pitch. Must be between (-90, maxCameraPitchOffset). Defaults to -90. Animations and interactions are bounded by this limit.

    Defaults to 0°.


    minCameraPitchOffset : double

    The minimum camera pitch offset in degrees.

    This value must be less than maxCameraPitchOffset.

    Defaults to 0°.


    [read-only] moveCameraStatus : Enums.TaskStatus

    The status of the moveCamera task.

    See also Enums.TaskStatus.


    [read-only] setTargetOffsetsStatus : Enums.TaskStatus

    The status of the setTargetOffsets task.

    See also Enums.TaskStatus.


    [default] targetGeoElement : GeoElement

    The target geo element of the camera controller.

    The target GeoElement can represent either point Graphic, a point Feature, or a point DynamicEntity. The target determines the focal point of the camera managed by the orbit camera controller.


    targetOffsetX : double

    The x offset of the target focus point relative to the target object in the x-axis of the target's coordinate system.

    The offset of the camera focal point from the targetGeoElement along its x-axis. Setting the offsets for the target allows the user to move the focal point from the target's geometry to any point.

    Defaults to 0.


    targetOffsetY : double

    The y offset of the target focus point relative to the target object in the y-axis of the target's coordinate system.

    The offset of the camera focal point from the targetGeoElement along its y-axis. Setting the offsets for the target allows the user to move the focal point from the target's geometry to any point.

    Defaults to 0.


    targetOffsetZ : double

    The z offset of the target focus point relative to the target object in the z-axis of the target's coordinate system.

    The offset of the camera focal point from the targetGeoElement along its z-axis. Setting the offsets for the target allows the user to move the focal point from the target's geometry to any point.

    Defaults to 0.


    targetVerticalScreenFactor : real

    The target vertical screen factor of the orbit camera controller.

    Controls the vertical position of the target on the screen. The value can range between 0.0 (bottom of the screen) and 1.0 (top of the screen).

    Defaults to 0.5 (center of the screen).


    Signal Documentation

    autoHeadingEnabledChanged()

    Emitted when the autoHeadingEnabled property changes.

    Note: The corresponding handler is onAutoHeadingEnabledChanged.


    autoPitchEnabledChanged()

    Emitted when the autoPitchEnabled property changes.

    Note: The corresponding handler is onAutoPitchEnabledChanged.


    autoRollEnabledChanged()

    Emitted when the autoRollEnabled property changes.

    Note: The corresponding handler is onAutoRollEnabledChanged.


    cameraDistanceChanged()

    Emitted when the cameraDistance property changes.

    Note: The corresponding handler is onCameraDistanceChanged.


    cameraDistanceInteractiveChanged()

    Emitted when the cameraDistanceInteractive property changes.

    Note: The corresponding handler is onCameraDistanceInteractiveChanged.


    cameraHeadingOffsetChanged()

    Emitted when the cameraHeadingOffset property changes.

    Note: The corresponding handler is onCameraHeadingOffsetChanged.


    cameraHeadingOffsetInteractiveChanged()

    Emitted when the cameraHeadingOffsetInteractive property changes.

    Note: The corresponding handler is onCameraHeadingOffsetInteractiveChanged.


    cameraPitchOffsetChanged()

    Emitted when the cameraPitchOffset property changes.

    Note: The corresponding handler is onCameraPitchOffsetChanged.


    cameraPitchOffsetInteractiveChanged()

    Emitted when the cameraPitchOffsetInteractive property changes.

    Note: The corresponding handler is onCameraPitchOffsetInteractiveChanged.


    maxCameraDistanceChanged()

    Emitted when the maxCameraDistance property changes.

    Note: The corresponding handler is onMaxCameraDistanceChanged.


    maxCameraHeadingOffsetChanged()

    Emitted when the maxCameraHeadingOffset property changes.

    Note: The corresponding handler is onMaxCameraHeadingOffsetChanged.


    maxCameraPitchOffsetChanged()

    Emitted when the maxCameraPitchOffset property changes.

    Note: The corresponding handler is onMaxCameraPitchOffsetChanged.


    minCameraDistanceChanged()

    Emitted when the minCameraDistance property changes.

    Note: The corresponding handler is onMinCameraDistanceChanged.


    minCameraHeadingOffsetChanged()

    Emitted when the minCameraHeadingOffset property changes.

    Note: The corresponding handler is onMinCameraHeadingOffsetChanged.


    minCameraPitchOffsetChanged()

    Emitted when the minCameraPitchOffset property changes.

    Note: The corresponding handler is onMinCameraPitchOffsetChanged.


    moveCameraStatusChanged()

    Emitted when the moveCameraStatus property changes.

    Note: The corresponding handler is onMoveCameraStatusChanged.


    setTargetOffsetsStatusChanged()

    Emitted when the setTargetOffsetsStatus property changes.

    Note: The corresponding handler is onSetTargetOffsetsStatusChanged.


    targetGeoElementChanged()

    Emitted when the targetGeoElement property changes.

    Note: The corresponding handler is onTargetGeoElementChanged.


    targetOffsetXChanged()

    Emitted when the targetOffsetX property changes.

    Note: The corresponding handler is onTargetOffsetXChanged.


    targetOffsetYChanged()

    Emitted when the targetOffsetY property changes.

    Note: The corresponding handler is onTargetOffsetYChanged.


    targetOffsetZChanged()

    Emitted when the targetOffsetZ property changes.

    Note: The corresponding handler is onTargetOffsetZChanged.


    targetVerticalScreenFactorChanged()

    Emitted when the targetVerticalScreenFactor property changes.

    Note: The corresponding handler is onTargetVerticalScreenFactorChanged.


    Method Documentation

    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.


    bool cancelTask(string taskId)

    Cancels a moveCamera or or setTargetOffsets task.

    • taskId - The ID of the task to be canceled.

    See also Cancelable.


    string moveCamera(double distanceDelta, double headingDelta, double pitchDelta, real duration)

    Animate the camera to the new offset position relative to the target.

    • distanceDelta - The change in distance (meters) to apply in the animation.
    • headingDelta - The change in heading (degrees) to apply in the animation.
    • pitchDelta - The change in pitch (degrees) to apply in the animation.
    • duration - The duration of the animation in seconds.

    The moveCameraStatus property reports the status of the operation.


    string setTargetOffsets(double x, double y, double z, real duration)

    Animate the camera target offsets of the camera.

    • x - The change x offset symbol center.
    • y - The change y offset symbol center.
    • z - The change z offset symbol center.
    • duration - The duration of the animation in seconds.

    By default the camera focus's on the target's geometry center point. Using the offsets you can move the focal point to a new position relative to that center point.

    The setTargetOffsetsStatus property reports the status of the operation.


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