Skip To Content ArcGIS for Developers Sign In Dashboard

KmlViewpoint Class

(Esri::ArcGISRuntime::KmlViewpoint)

Contains all information about the the KML camera and look at point. More...

Header: #include <KmlViewpoint>
Since: Esri::ArcGISRuntime 100.4

Public Functions

KmlViewpoint()
KmlViewpoint(const KmlViewpoint &other)
KmlViewpoint(KmlViewpoint &&other)
~KmlViewpoint()
KmlAltitudeMode altitudeMode() const
double heading() const
bool isEmpty() const
Point location() const
double pitch() const
double range() const
double roll() const
KmlViewpointType type() const
KmlViewpoint &operator=(const KmlViewpoint &other)
KmlViewpoint &operator=(KmlViewpoint &&other)

Static Public Members

KmlViewpoint createCameraViewpoint(const Point &cameraLocation, double heading, double pitch, double roll, KmlAltitudeMode altitudeMode)
KmlViewpoint createLookAtViewpoint(const Point &lookAtLocation, double heading, double pitch, double range, KmlAltitudeMode altitudeMode)
KmlViewpoint createWithViewpoint(const Viewpoint &viewpoint)

Detailed Description

Contains all information about the the KML camera and look at point.

Member Function Documentation

KmlViewpoint::KmlViewpoint()

Default constructor.

Use this constructor to create a KML viewpoint for Qt. This is provided for convenience only and will construct an empty object.

KmlViewpoint::KmlViewpoint(const KmlViewpoint &other)

Copy constructor from the other KmlViewpoint.

KmlViewpoint::KmlViewpoint(KmlViewpoint &&other)

Move constructor from the other KmlViewpoint.

KmlViewpoint::~KmlViewpoint()

Destructor.

KmlAltitudeMode KmlViewpoint::altitudeMode() const

Returns the KML viewpoint's altitude mode.

Altitude mode indicates how the altitude values relate to the ground or sea level.

[static] KmlViewpoint KmlViewpoint::createCameraViewpoint(const Point &cameraLocation, double heading, double pitch, double roll, KmlAltitudeMode altitudeMode)

A static method that creates a KML viewpoint from the provided camera location.

  • cameraLocation - The location of the camera.
  • heading - The heading value.
  • pitch - The pitch value.
  • roll - The roll value.
  • altitudeMode - Enumeration of the KML altitude modes.

This function was introduced in Esri::ArcGISRuntime 100.6.

[static] KmlViewpoint KmlViewpoint::createLookAtViewpoint(const Point &lookAtLocation, double heading, double pitch, double range, KmlAltitudeMode altitudeMode)

A static method that creates a KML viewpoint from the provided look at location.

  • lookAtLocation - The observed location.
  • heading - - The heading value.
  • pitch - The pitch value.
  • range - The range value.
  • altitudeMode - Enumeration of the KML altitude modes.

This function was introduced in Esri::ArcGISRuntime 100.6.

[static] KmlViewpoint KmlViewpoint::createWithViewpoint(const Viewpoint &viewpoint)

A static method that creates a KML viewpoint from the provided viewpoint.

The viewpoint must have a look at point, and optionally a camera.

This function was introduced in Esri::ArcGISRuntime 100.6.

double KmlViewpoint::heading() const

Returns the KML viewpoint's heading.

Heading is defined in terms of degrees from 0 (North) to 360, with 90 being East.

bool KmlViewpoint::isEmpty() const

Returns true if the object is empty, false otherwise.

Point KmlViewpoint::location() const

Returns the KML viewpoint's location.

The location can be an observed point (LookAt in KML) or the position of the Camera.

double KmlViewpoint::pitch() const

Returns the KML viewpoint's pitch.

Pitch is the angle (in degrees) between the camera and the target location, the angle of the observer's view. Values can range from 0 (straight down) through 90 (looking horizontally) to 180 (straight up toward the sky).

Pitch corresponds to tilt in the KML specification.

Value ranges from 0 and 90 for LookAt viewpoints, 0 and 180 for Camera viewpoints.

double KmlViewpoint::range() const

Returns the KML viewpoint's range.

Range indicates the distance between the camera and the LookAt viewpoint's target location.

double KmlViewpoint::roll() const

Returns the KML viewpoint's roll.

Roll indicates rotation in degrees around the camera's Z axis.

KmlViewpointType KmlViewpoint::type() const

Returns the KML viewpoint's type.

KmlViewpoint &KmlViewpoint::operator=(const KmlViewpoint &other)

Assignment operator from other KmlViewpoint.

KmlViewpoint &KmlViewpoint::operator=(KmlViewpoint &&other)

Move operator from other KmlViewpoint.


Feedback on this topic?