ArcGISCamera

Namespace: GameEngine.MapView
Class: GameEngine/MapView/ArcGISCamera
Since: 1.0.0

Summary

A camera represents an observer's location and their perspective of a ArcGISMap. It is used as a data loading point.

Constructors

ArcGISCamera(ArcGISPoint, double, double, double)

Creates a camera with the specified location, heading, pitch, and roll.

Since 1.0.0

Arguments

Name	Type	Summary
`locationPoint`	`ArcGISPoint`	A point geometry containing the location and altitude at which to place the camera. If the altitude is below the `Scene.baseSurface` and the `Surface.navigationConstraint` is set to `NavigationConstraint.stayAbove`, the camera will be located at the `Surface`. Note: that the default is `NavigationConstraint.stayAbove`. If the point has a spatial reference, the point projects to WGS84. Otherwise, a point spatial reference of WGS84 is assumed.
`heading`	`double`	The angle around the z-axis the camera is rotated. The angle is clockwise from north in the East, North, Up (ENU) ground reference frame. The value is between 0 to 360. 0 is looking North and 90 is looking East. Values are wrapped around so that they fall within 0 to 360.
`pitch`	`double`	The angle around the y-axis the camera is rotated in the East, North, Up (ENU) ground reference frame. The value is between 0 to 180. 0 is looking straight down and 180 is looking straight up. A negative value defaults to 0 and a value greater than 180 defaults to 180. If the behavior of a negative pitch is required, then the corresponding transformation with positive pitch can be set instead. For example, if heading:0 pitch:-20 roll:0 is required then heading:180 pitch:20 roll:180 can be used instead.
`roll`	`double`	The angle around the x-axis the camera is rotated in the East, North, Up (ENU) ground reference frame. The value is between 0 to 360. 0 is horizontal, 180 is upside down. Values are wrapped so that they fall within 0 to 360.

Properties

Property	Type	Nullable	Readonly	Summary
`Heading`	`double`	`No`	`Yes`	The heading of the camera.
`Location`	`ArcGISPoint`	`No`	`Yes`	The point geometry containing the location and altitude of the camera.
`Pitch`	`double`	`No`	`Yes`	The pitch of the camera.
`Roll`	`double`	`No`	`Yes`	The roll of the camera.

Heading

double Heading

The heading of the camera.

The angle around the z-axis the camera is rotated. The angle is clockwise from north in the East, North, Up (ENU) ground reference frame. The value is between 0 to 360. 0 is looking North and 90 is looking East.

Location

ArcGISPoint Location

The point geometry containing the location and altitude of the camera.

Pitch

double Pitch

The pitch of the camera.

The angle around the y-axis the camera is rotated in the East, North, Up (ENU) ground reference frame. The value is between 0 to 180. 0 is looking straight down and 180 is looking straight up.

Roll

double Roll

The roll of the camera.

The angle around the x-axis the camera is rotated in the East, North, Up (ENU) ground reference frame. The value is between 0 to 360. 0 is horizontal, 180 is upside down.

Methods

Signature	Return Type	Summary
Elevate(double)	ArcGISCamera	Creates a copy of the camera with the change in altitude applied.
Equals(ArcGISCamera)	bool	Tests if this object is equal to a second ArcGISCamera object.
MoveTo(ArcGISPoint)	ArcGISCamera	Creates a copy of the camera with a new location.
RotateTo(double, double, double)	ArcGISCamera	Creates a copy of the camera with the specified heading, pitch and roll values.

Elevate

ArcGISCamera Elevate(double deltaAltitude)

Creates a copy of the camera with the change in altitude applied.

Since 1.0.0

Arguments

Name	Type	Summary
`deltaAltitude`	`double`	The altitude delta to apply to the output camera.

Returns ArcGISCamera

A copy of the camera with an elevation delta adjusted by the parameter delta_altitude.

Equals

bool Equals(ArcGISCamera otherCamera)

Tests if this object is equal to a second ArcGISCamera object.

Since 1.0.0

Arguments

Name	Type	Summary
`otherCamera`	`ArcGISCamera`	The other camera object.

Returns bool

True if the comparison succeeds and the objects are equal, false otherwise.

MoveTo

ArcGISCamera MoveTo(ArcGISPoint location)

Creates a copy of the camera with a new location.

Since 1.0.0

Arguments

Name	Type	Summary
`location`	`ArcGISPoint`	The location to move the output camera to.

Returns ArcGISCamera

A copy of the camera with the location changed.

RotateTo

ArcGISCamera RotateTo(double heading, double pitch, double roll)

Creates a copy of the camera with the specified heading, pitch and roll values.

Since 1.0.0

Arguments

Name	Type	Summary
`heading`	`double`	The angle around the z-axis the new camera is rotated. The angle is clockwise from north in the East, North, Up (ENU) ground reference frame. The value is between 0 to 360. 0 is looking North and 90 is looking East. Values are wrapped around so that they fall within 0 to 360.
`pitch`	`double`	The angle around the y-axis the camera is rotated in the East, North, Up (ENU) ground reference frame. The value is between 0 to 180. 0 is looking straight down and 180 is looking straight up. A negative value defaults to 0 and a value greater than 180 defaults to 180. If the behavior of a negative pitch is required, then the corresponding transformation with positive pitch can be set instead. For example, if heading:0 pitch:-20 roll:0 is required then heading:180 pitch:20 roll:180 can be used instead.
`roll`	`double`	The angle around the x-axis the new camera is rotated in the East, North, Up (ENU) ground reference frame. The value is between 0 to 360. 0 is horizontal, 180 is upside down. Values are wrapped so that they fall within 0 to 360.

Returns ArcGISCamera

A copy of the camera with the position moved