Namespace: GameEngine.MapView
Class: GameEngine/MapView/ArcGISCamera
Since: 1.0.0
Summary
A camera represents an observer's location and their perspective of an ArcGISMap. It is used as a data loading point.
Constructors
ArcGISCamera(ArcGISPoint locationPoint, double heading, double pitch, double roll)
Creates a camera with the specified location, heading, pitch, and roll. The camera's spatial reference is derived from the locationPoint.
Since 1.0.0
Arguments
| Name | Type | Summary |
|---|---|---|
location | ArcGISPoint | A point geometry defining the 3D location at which to place the camera. If the point has a
spatial reference, the camera will adopt it. Otherwise, a spatial reference of WGS84 is assumed.
If the point's z value is below the |
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.
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 |
|---|---|---|
Creates a copy of the camera with the specified change in altitude applied. | ||
Creates a copy of the camera with a new location. | ||
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 specified change in altitude applied.
Since 1.0.0
Arguments
| Name | Type | Summary |
|---|---|---|
delta | double | The altitude delta in meters to apply to the output camera. |
Returns ArcGISCamera
A copy of the camera with an elevation delta adjusted by the parameter delta_altitude.
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. The returned camera is in the same spatial reference as the source camera. If the spatial reference of the point is not specified, it is assumed to be the spatial reference of the camera. |
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