ARCore is back at Google I/O on May 10! Register now.
Stay organized with collections Save and categorize content based on your preferences.

ArCameraIntrinsics

Provides information about the physical characteristics of the device camera.

Summary

Typedefs

ArCameraIntrinsics typedef
struct ArCameraIntrinsics_
The physical characteristics of a given camera.

Functions

ArCameraIntrinsics_create(const ArSession *session, ArCameraIntrinsics **out_camera_intrinsics)
void
Allocates a camera intrinstics object.
ArCameraIntrinsics_destroy(ArCameraIntrinsics *camera_intrinsics)
void
Releases the provided camera intrinsics object.
ArCameraIntrinsics_getFocalLength(const ArSession *session, const ArCameraIntrinsics *intrinsics, float *out_fx, float *out_fy)
void
Returns the camera's focal length in pixels.
ArCameraIntrinsics_getImageDimensions(const ArSession *session, const ArCameraIntrinsics *intrinsics, int32_t *out_width, int32_t *out_height)
void
Returns the image's width and height in pixels.
ArCameraIntrinsics_getPrincipalPoint(const ArSession *session, const ArCameraIntrinsics *intrinsics, float *out_cx, float *out_cy)
void
Returns the principal point in pixels.

Typedefs

ArCameraIntrinsics

struct ArCameraIntrinsics_ ArCameraIntrinsics

The physical characteristics of a given camera.

Functions

ArCameraIntrinsics_create

void ArCameraIntrinsics_create(
  const ArSession *session,
  ArCameraIntrinsics **out_camera_intrinsics
)

Allocates a camera intrinstics object.

Details
Parameters
session
The ARCore session
out_camera_intrinsics

ArCameraIntrinsics_destroy

void ArCameraIntrinsics_destroy(
  ArCameraIntrinsics *camera_intrinsics
)

Releases the provided camera intrinsics object.

ArCameraIntrinsics_getFocalLength

void ArCameraIntrinsics_getFocalLength(
  const ArSession *session,
  const ArCameraIntrinsics *intrinsics,
  float *out_fx,
  float *out_fy
)

Returns the camera's focal length in pixels.

The focal length is conventionally represented in pixels. For a detailed explanation, please see https://ksimek.github.io/2013/08/13/intrinsic. Pixels-to-meters conversion can use SENSOR_INFO_PHYSICAL_SIZE and SENSOR_INFO_PIXEL_ARRAY_SIZE in the Android Camera Characteristics API.

ArCameraIntrinsics_getImageDimensions

void ArCameraIntrinsics_getImageDimensions(
  const ArSession *session,
  const ArCameraIntrinsics *intrinsics,
  int32_t *out_width,
  int32_t *out_height
)

Returns the image's width and height in pixels.

ArCameraIntrinsics_getPrincipalPoint

void ArCameraIntrinsics_getPrincipalPoint(
  const ArSession *session,
  const ArCameraIntrinsics *intrinsics,
  float *out_cx,
  float *out_cy
)

Returns the principal point in pixels.