Camera

constructor(latitude: Double, longitude: Double, altitude: Double, heading: Double, pitch: Double, roll: Double)

Creates a camera with the specified latitude, longitude, altitude, heading, pitch, and roll.

Since

200.1.0

Parameters

latitude

The latitude of the camera position in degrees.

longitude

The longitude of the camera position in degrees.

altitude

The altitude of the camera position in meters. If the altitude is below the com.arcgismaps.mapping.ArcGISScene.baseSurface and the com.arcgismaps.mapping.Surface.navigationConstraint is set to com.arcgismaps.mapping.NavigationConstraint.StayAbove, the camera will be located at the com.arcgismaps.mapping.Surface. Note: that the default is com.arcgismaps.mapping.NavigationConstraint.StayAbove.

heading

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

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

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.


constructor(locationPoint: Point, heading: Double, pitch: Double, roll: Double)

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

Since

200.1.0

Parameters

locationPoint

A point geometry containing the location and altitude at which to place the camera. If the altitude is below the com.arcgismaps.mapping.ArcGISScene.baseSurface and the com.arcgismaps.mapping.Surface.navigationConstraint is set to com.arcgismaps.mapping.NavigationConstraint.StayAbove, the camera will be located at the com.arcgismaps.mapping.Surface. Note: that the default is com.arcgismaps.mapping.NavigationConstraint.StayAbove. If the point has a spatial reference, the point projects to WGS84. Otherwise, a point spatial reference of WGS84 is assumed.

heading

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

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

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.


constructor(lookAtPoint: Point, distance: Double, heading: Double, pitch: Double, roll: Double)

Creates a camera based on a point to look at, the distance to this point, heading, pitch, and roll. Note: the given values may mean that the point is not visible on screen. You can check its visibility using SceneView.locationToScreen.

Since

200.1.0

Parameters

lookAtPoint

The point in space the camera will be pointing at.

distance

The distance in meters between the lookAtPoint and the camera location.

heading

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

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

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.


constructor(transformationMatrix: TransformationMatrix)

Creates a camera from a transformation matrix. The TransformationMatrix describes the camera's location and direction it is looking.

Since

200.1.0

Parameters

transformationMatrix

The TransformationMatrix used to create the camera. The TransformationMatrix 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.