OrientationHelper

Utility class to determine the orientation of the camera sensor respect to current device orientation. Determining such orientation is useful for Augmented Reality applications, where a pinhole camera needs to be estimated taking into account such orientation.

See also

Properties

Link copied to clipboard
const val ORIENTATION_0_DEGREES: Int = 0

Orientation corresponding to 0 degrees.

Link copied to clipboard
const val ORIENTATION_180_DEGREES: Int = 180

Orientation corresponding to 180 degrees.

Link copied to clipboard
const val ORIENTATION_270_DEGREES: Int = 270

Orientation corresponding to 270 degrees.

Link copied to clipboard
const val ORIENTATION_90_DEGREES: Int = 90

Orientation corresponding to 90 degrees.

Functions

Link copied to clipboard
fun fromViewCoordinatesCamera(orientation: CameraToDisplayOrientation, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(rotation: Rotation2D?, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(context: Context, cameraId: String, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(orientation: CameraToDisplayOrientation, input: PinholeCamera, result: PinholeCamera)
fun fromViewCoordinatesCamera(orientation: CameraToDisplayOrientation, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(rotation: Rotation2D?, input: PinholeCamera, result: PinholeCamera)
fun fromViewCoordinatesCamera(rotation: Rotation2D?, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, input: PinholeCamera, result: PinholeCamera)
fun fromViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(context: Context, cameraId: String, input: PinholeCamera, result: PinholeCamera)
fun fromViewCoordinatesCamera(context: Context, cameraId: String, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun fromViewCoordinatesCamera(orientation: CameraToDisplayOrientation, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)
fun fromViewCoordinatesCamera(rotation: Rotation2D?, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)
fun fromViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)
fun fromViewCoordinatesCamera(context: Context, cameraId: String, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)

Converts camera from Android view coordinates to OpenGL coordinates.

Link copied to clipboard
fun fromViewCoordinatesRotation(context: Context, characteristics: CameraCharacteristics): Rotation2D
fun fromViewCoordinatesRotation(context: Context, cameraId: String): Rotation2D
fun fromViewCoordinatesRotation(context: Context, characteristics: CameraCharacteristics, result: Rotation2D)
fun fromViewCoordinatesRotation(context: Context, cameraId: String, result: Rotation2D)

Creates the rotation required to convert from Android view coordinates to OpenGL coordinates.

Link copied to clipboard
fun fromViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, pivot: Point2D): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(rotation: Rotation2D?, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(rotation: Rotation2D?, pivot: Point2D): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, pivot: Point2D): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(context: Context, cameraId: String, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(context: Context, cameraId: String, pivot: Point2D): ProjectiveTransformation2D
fun fromViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun fromViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, pivot: Point2D, result: ProjectiveTransformation2D)
fun fromViewCoordinatesTransformation(rotation: Rotation2D?, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun fromViewCoordinatesTransformation(rotation: Rotation2D?, pivot: Point2D, result: ProjectiveTransformation2D)
fun fromViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun fromViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, pivot: Point2D, result: ProjectiveTransformation2D)
fun fromViewCoordinatesTransformation(context: Context, cameraId: String, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun fromViewCoordinatesTransformation(context: Context, cameraId: String, pivot: Point2D, result: ProjectiveTransformation2D)

Creates 2D transformation to convert 2D point coordinates from Android view coordinates to OpenGL coordinates.

Link copied to clipboard

Gets orientation of camera sensor. Camera sensor orientation is computed in terms of device orientation.

Link copied to clipboard

Gets clockwise orientation of camera sensor respect to display orientation.

Link copied to clipboard
fun toViewCoordinatesCamera(orientation: CameraToDisplayOrientation, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(rotation: Rotation2D?, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(context: Context, cameraId: String, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(orientation: CameraToDisplayOrientation, input: PinholeCamera, result: PinholeCamera)
fun toViewCoordinatesCamera(orientation: CameraToDisplayOrientation, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(rotation: Rotation2D?, input: PinholeCamera, result: PinholeCamera)
fun toViewCoordinatesCamera(rotation: Rotation2D?, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, input: PinholeCamera, result: PinholeCamera)
fun toViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(context: Context, cameraId: String, input: PinholeCamera, result: PinholeCamera)
fun toViewCoordinatesCamera(context: Context, cameraId: String, pivot: Point2D, input: PinholeCamera): PinholeCamera
fun toViewCoordinatesCamera(orientation: CameraToDisplayOrientation, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)
fun toViewCoordinatesCamera(rotation: Rotation2D?, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)
fun toViewCoordinatesCamera(context: Context, characteristics: CameraCharacteristics, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)
fun toViewCoordinatesCamera(context: Context, cameraId: String, pivot: Point2D, input: PinholeCamera, result: PinholeCamera)

Converts camera from OpenGL coordinates to Android view coordinates.

Link copied to clipboard
fun toViewCoordinatesRotation(context: Context, characteristics: CameraCharacteristics): Rotation2D
fun toViewCoordinatesRotation(context: Context, cameraId: String): Rotation2D
fun toViewCoordinatesRotation(context: Context, characteristics: CameraCharacteristics, result: Rotation2D)
fun toViewCoordinatesRotation(context: Context, cameraId: String, result: Rotation2D)

Creates the rotation required to convert from OpenGL coordinates to Android view coordinates.

Link copied to clipboard
fun toViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, pivot: Point2D): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(rotation: Rotation2D?, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(rotation: Rotation2D?, pivot: Point2D): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, pivot: Point2D): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(context: Context, cameraId: String, intrinsicParameters: PinholeCameraIntrinsicParameters): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(context: Context, cameraId: String, pivot: Point2D): ProjectiveTransformation2D
fun toViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun toViewCoordinatesTransformation(orientation: CameraToDisplayOrientation, pivot: Point2D, result: ProjectiveTransformation2D)
fun toViewCoordinatesTransformation(rotation: Rotation2D?, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun toViewCoordinatesTransformation(rotation: Rotation2D?, pivot: Point2D, result: ProjectiveTransformation2D)
fun toViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun toViewCoordinatesTransformation(context: Context, characteristics: CameraCharacteristics, pivot: Point2D, result: ProjectiveTransformation2D)
fun toViewCoordinatesTransformation(context: Context, cameraId: String, intrinsicParameters: PinholeCameraIntrinsicParameters, result: ProjectiveTransformation2D)
fun toViewCoordinatesTransformation(context: Context, cameraId: String, pivot: Point2D, result: ProjectiveTransformation2D)

Creates 2D transformation to convert 2D point coordinates from OpenGL coordinates to Android view coordinates.

Link copied to clipboard
fun transformCamera(transformation: ProjectiveTransformation2D, input: PinholeCamera): PinholeCamera
fun transformCamera(transformation: ProjectiveTransformation2D, input: PinholeCamera, result: PinholeCamera)

Transforms camera using provided 2D transformation.