Added in API level 1

Camera

---

Kotlin |Java

open class Camera

kotlin.Any
↳	android.graphics.Camera

A camera instance can be used to compute 3D transformations and generate a matrix that can be applied, for instance, on a Canvas.

Summary

Public constructors
Camera() Creates a new camera, with empty transformations.

Public methods
open Unit	applyToCanvas(canvas: Canvas!) Computes the matrix corresponding to the current transformation and applies it to the specified Canvas.
open Float	dotWithNormal(dx: Float, dy: Float, dz: Float)
open Float	getLocationX() Gets the x location of the camera.
open Float	getLocationY() Gets the y location of the camera.
open Float	getLocationZ() Gets the z location of the camera.
open Unit	getMatrix(matrix: Matrix!) Computes the matrix corresponding to the current transformation and copies it to the supplied matrix object.
open Unit	restore() Restores the saved state, if any.
open Unit	rotate(x: Float, y: Float, z: Float) Applies a rotation transform around all three axis.
open Unit	rotateX(deg: Float) Applies a rotation transform around the X axis.
open Unit	rotateY(deg: Float) Applies a rotation transform around the Y axis.
open Unit	rotateZ(deg: Float) Applies a rotation transform around the Z axis.
open Unit	save() Saves the camera state.
open Unit	setLocation(x: Float, y: Float, z: Float) Sets the location of the camera.
open Unit	translate(x: Float, y: Float, z: Float) Applies a translation transform on all three axis.

Protected methods
open Unit	finalize()

Public constructors

Camera

Added in API level 1

Camera()

Creates a new camera, with empty transformations.

Public methods

applyToCanvas

Added in API level 1

open fun applyToCanvas(canvas: Canvas!): Unit

Computes the matrix corresponding to the current transformation and applies it to the specified Canvas.

Parameters
canvas	Canvas!: The Canvas to set the transform matrix onto

dotWithNormal

Added in API level 1

open fun dotWithNormal(
    dx: Float, 
    dy: Float, 
    dz: Float
): Float

getLocationX

Added in API level 16

open fun getLocationX(): Float

Gets the x location of the camera.

See Also

• #setLocation(float, float, float)

getLocationY

Added in API level 16

open fun getLocationY(): Float

Gets the y location of the camera.

See Also

• #setLocation(float, float, float)

getLocationZ

Added in API level 16

open fun getLocationZ(): Float

Gets the z location of the camera.

See Also

• #setLocation(float, float, float)

getMatrix

Added in API level 1

open fun getMatrix(matrix: Matrix!): Unit

Computes the matrix corresponding to the current transformation and copies it to the supplied matrix object.

Parameters
matrix	Matrix!: The matrix to copy the current transforms into

restore

Added in API level 1

open fun restore(): Unit

Restores the saved state, if any.

See Also

• #restore()

rotate

Added in API level 12

open fun rotate(
    x: Float, 
    y: Float, 
    z: Float
): Unit

Applies a rotation transform around all three axis.

Parameters
x	Float: The angle of rotation around the X axis, in degrees
y	Float: The angle of rotation around the Y axis, in degrees
z	Float: The angle of rotation around the Z axis, in degrees

See Also

• #rotateX(float)
• #rotateY(float)
• #rotateZ(float)

rotateX

Added in API level 1

open fun rotateX(deg: Float): Unit

Applies a rotation transform around the X axis.

Parameters
deg	Float: The angle of rotation around the X axis, in degrees

See Also

• #rotateY(float)
• #rotateZ(float)
• #rotate(float, float, float)

rotateY

Added in API level 1

open fun rotateY(deg: Float): Unit

Applies a rotation transform around the Y axis.

Parameters
deg	Float: The angle of rotation around the Y axis, in degrees

See Also

• #rotateX(float)
• #rotateZ(float)
• #rotate(float, float, float)

rotateZ

Added in API level 1

open fun rotateZ(deg: Float): Unit

Applies a rotation transform around the Z axis.

Parameters
deg	Float: The angle of rotation around the Z axis, in degrees

See Also

• #rotateX(float)
• #rotateY(float)
• #rotate(float, float, float)

save

Added in API level 1

open fun save(): Unit

Saves the camera state. Each save should be balanced with a call to restore().

See Also

• #save()

setLocation

Added in API level 12

open fun setLocation(
    x: Float, 
    y: Float, 
    z: Float
): Unit

Sets the location of the camera. The default location is set at 0, 0, -8.

Parameters
x	Float: The x location of the camera
y	Float: The y location of the camera
z	Float: The z location of the camera

translate

Added in API level 1

open fun translate(
    x: Float, 
    y: Float, 
    z: Float
): Unit

Applies a translation transform on all three axis.

Parameters
x	Float: The distance to translate by on the X axis
y	Float: The distance to translate by on the Y axis
z	Float: The distance to translate by on the Z axis

Protected methods

finalize

Added in API level 1

protected open fun finalize(): Unit

Exceptions
java.lang.Throwable	the Exception raised by this method