CameraIntrinsics

public class CameraIntrinsics

Provides information about the physical characteristics of the device camera, for the camera image (CPU) or texture (GPU). The CameraIntrinsics is a long-lived object, and the properties of CameraIntrinsics may be updated every time Session.update() is called.

Public Methods

float[]	getFocalLength() Returns the camera's focal length in pixels.
void	getFocalLength(float[] focalLength, int offset) Returns the camera's focal length in pixels.
void	getImageDimensions(int[] dimensions, int offset) Returns the camera's image dimensions.
int[]	getImageDimensions() Returns a int[2] containing the image dimensions.
float[]	getPrincipalPoint() Returns a float[2] containing the principal point.
void	getPrincipalPoint(float[] principalPoint, int offset) Returns the camera's principal point.

Inherited Methods

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public float[] getFocalLength ()

getFocalLength

public float[] getFocalLength()

Returns the camera's focal length in pixels.

The focal length is conventionally represented in pixels. For a detailed explanation, please see Disecting the Camera Matrix, Part 3: The Intrinsic Matrix. Pixels-to-meters conversion can use SENSOR_INFO_PHYSICAL_SIZE and SENSOR_INFO_PIXEL_ARRAY_SIZE in the Android Characteristics API.

Returns

• a float[2] containing the focal length. The order of values is {fx, fy}.

public void getFocalLength (float[] focalLength, int offset)

getFocalLength

public void getFocalLength(
  float[] focalLength,
  int offset
)

Returns the camera's focal length in pixels.

The focal length is conventionally represented in pixels. For a detailed explanation, please see Disecting the Camera Matrix, Part 3: The Intrinsic Matrix. Pixels-to-meters conversion can use SENSOR_INFO_PHYSICAL_SIZE and SENSOR_INFO_PIXEL_ARRAY_SIZE in the Android Characteristics API.

Parameters

focalLength	storage for at least 2 floats representing the focal length. The order of values is {fx, fy}.
offset	the offset in focalLength at which to begin writing the focal length values.

public void getImageDimensions (int[] dimensions, int offset)

getImageDimensions

public void getImageDimensions(
  int[] dimensions,
  int offset
)

Returns the camera's image dimensions. The order of values is {width, height}.

Parameters

dimensions	storage for at least 2 ints representing the image's width and height.
offset	the offset in dimensions at which to begin writing the image dimension's values.

public int[] getImageDimensions ()

getImageDimensions

public int[] getImageDimensions()

Returns a int[2] containing the image dimensions. The order of values is {width, height}.

public float[] getPrincipalPoint ()

getPrincipalPoint

public float[] getPrincipalPoint()

Returns a float[2] containing the principal point. The order of values is {cx, cy}.

public void getPrincipalPoint (float[] principalPoint, int offset)

getPrincipalPoint

public void getPrincipalPoint(
  float[] principalPoint,
  int offset
)

Returns the camera's principal point. The order of values is {cx, cy}.

Parameters

principalPoint	storage for at least 2 floats representing the principal point.
offset	the offset in principalPoint at which to begin writing the principal point's values.