Camera Class

// create a camera
const double latitude = 28.4;
const double longitude = 83.9;
const double altitude = 10010.0;
const double heading = 10.0;
const double pitch = 80.0;
const double roll = 0.0;
Camera camera(latitude, longitude, altitude, heading, pitch, roll);

// set the viewpoint
m_sceneView->setViewpointCameraAndWait(camera);

Member Function Documentation

Camera::Camera(Esri::ArcGISRuntime::Camera &&other)

Move constructor from other Camera.

Camera::Camera(const Esri::ArcGISRuntime::Camera &other)

Copy constructor from other Camera.

Camera::Camera(Esri::ArcGISRuntime::TransformationMatrix *transformationMatrix)

Constructs a camera using transformation matrix.

The transformation matrix describes the camera's location and the direction it is looking. Using this constructor with the location provided by ARKit/ARCore is necessary for enabling augmented reality.

• transformationMatrix - The TransformationMatrix used to create the camera.

This function was introduced in Esri::ArcGISRuntime 100.6.

Camera::Camera(const Esri::ArcGISRuntime::Point &lookAtPoint, double distance, double heading, double pitch, double roll)

Constructs a camera using the location of camera's subject (as a Point) and camera orientation.

• lookAtPoint - The x,y,z-coordinates of subject's location.
• distance - The distance from the camera to the subject in meters.
• heading - The camera heading.
• pitch - The camera pitch.
• roll - The camera roll.

The camera location is calculated such that when the camera has the specified orientation, the lookAtPoint is at the specified distance from the camera and the lookAtPoint is seen in the center of the view.

See also Camera orientation.

Camera::Camera(const Esri::ArcGISRuntime::Point &locationPoint, double heading, double pitch, double roll)

Constructs a camera using camera location (as a Point) and orientation.

• locationPoint - The x,y,z-coordinates of camera's location.
• heading - The camera heading.
• pitch - The camera pitch.
• roll - The camera roll.

See also Camera orientation and Camera transformation.

Camera::Camera(double latitude, double longitude, double altitude, double heading, double pitch, double roll)

Constructs a camera using camera location latitude, longitude, altitude, and orientation.

• latitude - The latitude directly below the camera.
• longitude - The longitude directly below the camera.
• altitude - The camera altitude.
• heading - The camera heading.
• pitch - The camera pitch.
• roll - The camera roll.

See also Camera orientation and Camera transformation.

Camera::Camera()

Default constructor. Creates an empty Camera.

Esri::ArcGISRuntime::Camera &Camera::operator=(Esri::ArcGISRuntime::Camera &&other)

Move operator from other Camera.

Esri::ArcGISRuntime::Camera &Camera::operator=(const Esri::ArcGISRuntime::Camera &other)

Assignment operator from other Camera.

Camera::~Camera()

Destructor.

Esri::ArcGISRuntime::Camera Camera::elevate(double deltaAltitude) const

Create a new Camera with the same orientation and x,y location as this one, with altitude (z-value) changed by deltaAltitude.

double Camera::heading() const

Returns this Camera's heading.

bool Camera::isEmpty() const

Returns whether this object is empty.

Esri::ArcGISRuntime::Point Camera::location() const

Returns this Camera's location.

Esri::ArcGISRuntime::Camera Camera::moveForward(double distance) const

Create a Camera object with the same orientation as this one, but moved along its heading by distance meters.

Esri::ArcGISRuntime::Camera Camera::moveTo(const Esri::ArcGISRuntime::Point &location) const

Create a new Camera object with the same orientation as this one, moved to a new location.

Esri::ArcGISRuntime::Camera Camera::moveToward(const Esri::ArcGISRuntime::Point &targetPoint, double distance) const

Create a new Camera object with the same orientation as this one, moved toward a given targetPoint by a given distance in meters.

Note that targetPoint indicates the direction the camera should be moved. This is not the same thing as lookAtPoint, which indicates the direction that the camera should be oriented.

double Camera::pitch() const

Returns this Camera's pitch.

double Camera::roll() const

Returns this Camera's roll.

Esri::ArcGISRuntime::Camera Camera::rotateAround(const Esri::ArcGISRuntime::Point &targetPoint, double deltaHeading, double deltaPitch, double deltaRoll) const

Create a new Camera object that is rotated around a target point.

• targetPoint - The location to rotate around.
• deltaHeading - The change in heading.
• deltaPitch - The change in pitch.
• deltaRoll - The change in roll.

The result of this transformation is a new camera with the following characteristics.

• The orientation of the camera is changed by the specified values of heading, pitch, and roll.
• The target point remains in the same relative location in the view.
• The camera location is the same distance from the target point.

See also Camera transformation.

Esri::ArcGISRuntime::Camera Camera::rotateTo(double heading, double pitch, double roll) const

Create a new Camera object with the same location as this one, with rotated orientation.

• heading - The new absolute heading.
• pitch - The new absolute pitch.
• roll - The new absolute roll.

See also Camera orientation.

Esri::ArcGISRuntime::TransformationMatrix *Camera::transformationMatrix(QObject *parent = nullptr) const

Returns this Camera's location and orientation as a TransformationMatrix.

• parent - The parent QObject-derived object (optional).

This returns a TransformationMatrix even when this Camera was not created using a TransformationMatrix.

This function was introduced in Esri::ArcGISRuntime 100.6.

Esri::ArcGISRuntime::Camera Camera::zoomToward(const Esri::ArcGISRuntime::Point &targetPoint, double factor) const

Create a new Camera object with the view zoomed toward a specified point.

• targetPoint - The absolute point in space to zoom toward.
• factor - The zoom factor.

bool Camera::operator==(const Esri::ArcGISRuntime::Camera &other) const

Equivalency operator.

Returns whether this object and other are equivalent.