Camera
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 |
Gets the x location of the camera. |
| open Float |
Gets the y location of the camera. |
| open Float |
Gets the z location of the camera. |
| open Unit |
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 |
Applies a rotation transform around all three axis. |
| open Unit |
Applies a rotation transform around the X axis. |
| open Unit |
Applies a rotation transform around the Y axis. |
| open Unit |
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 |
Applies a translation transform on all three axis. |
| Protected methods | |
|---|---|
| open Unit |
finalize() |
Public constructors
Public methods
applyToCanvas
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 |
getLocationX
open fun getLocationX(): Float
Gets the x location of the camera.
See Also
getLocationY
open fun getLocationY(): Float
Gets the y location of the camera.
See Also
getLocationZ
open fun getLocationZ(): Float
Gets the z location of the camera.
See Also
getMatrix
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 |
rotate
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 |
rotateX
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 |
rotateY
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 |
rotateZ
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 |
save
open fun save(): Unit
Saves the camera state. Each save should be balanced with a call to restore().
See Also
setLocation
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
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
protected open fun finalize(): Unit
| Exceptions | |
|---|---|
java.lang.Throwable |
the Exception raised by this method |