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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-14 UTC.
[null,null,["Last updated 2025-07-14 UTC."],[[["\u003cp\u003e\u003ccode\u003eArCameraIntrinsics\u003c/code\u003e provides access to the physical characteristics of the device camera, such as focal length, image dimensions, and principal point.\u003c/p\u003e\n"],["\u003cp\u003eYou can create and release \u003ccode\u003eArCameraIntrinsics\u003c/code\u003e objects using dedicated functions like \u003ccode\u003eArCameraIntrinsics_create\u003c/code\u003e and \u003ccode\u003eArCameraIntrinsics_destroy\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFunctions are available to retrieve specific camera properties, including focal length (\u003ccode\u003eArCameraIntrinsics_getFocalLength\u003c/code\u003e), image dimensions (\u003ccode\u003eArCameraIntrinsics_getImageDimensions\u003c/code\u003e), and principal point (\u003ccode\u003eArCameraIntrinsics_getPrincipalPoint\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eFocal length is represented in pixels and can be converted to meters using Android Camera Characteristics API parameters.\u003c/p\u003e\n"]]],[],null,["# ArCameraIntrinsics\n==================\n\nProvides information about the physical characteristics of the device camera.\n\nSummary\n-------\n\n| ### Typedefs ||\n|-------------------------------------------|--------------------------------------------------------------------------------------|\n| [ArCameraIntrinsics](#arcameraintrinsics) | typedef `struct ArCameraIntrinsics_` The physical characteristics of a given camera. |\n\n| ### Functions ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|\n| [ArCameraIntrinsics_create](#arcameraintrinsics_create)`(const `[ArSession](/ar/reference/c/group/ar-session#arsession)` *session, `[ArCameraIntrinsics](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics)` **out_camera_intrinsics)` | `void` Allocates a camera intrinstics object. |\n| [ArCameraIntrinsics_destroy](#arcameraintrinsics_destroy)`(`[ArCameraIntrinsics](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics)` *camera_intrinsics)` | `void` Releases the provided camera intrinsics object. |\n| [ArCameraIntrinsics_getFocalLength](#arcameraintrinsics_getfocallength)`(const `[ArSession](/ar/reference/c/group/ar-session#arsession)` *session, const `[ArCameraIntrinsics](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics)` *intrinsics, float *out_fx, float *out_fy)` | `void` Returns the camera's focal length in pixels. |\n| [ArCameraIntrinsics_getImageDimensions](#arcameraintrinsics_getimagedimensions)`(const `[ArSession](/ar/reference/c/group/ar-session#arsession)` *session, const `[ArCameraIntrinsics](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics)` *intrinsics, int32_t *out_width, int32_t *out_height)` | `void` Returns the image's width and height in pixels. |\n| [ArCameraIntrinsics_getPrincipalPoint](#arcameraintrinsics_getprincipalpoint)`(const `[ArSession](/ar/reference/c/group/ar-session#arsession)` *session, const `[ArCameraIntrinsics](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics)` *intrinsics, float *out_cx, float *out_cy)` | `void` Returns the principal point in pixels. |\n\nTypedefs\n--------\n\n### ArCameraIntrinsics\n\n```scdoc\nstruct ArCameraIntrinsics_ ArCameraIntrinsics\n``` \nThe physical characteristics of a given camera.\n\n\n- Allocate with: [ArCameraIntrinsics_create](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics_create)\n- Release with: [ArCameraIntrinsics_destroy](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics_destroy)\n\n\u003cbr /\u003e\n\nFunctions\n---------\n\n### ArCameraIntrinsics_create\n\n```gdscript\nvoid ArCameraIntrinsics_create(\n const ArSession *session,\n ArCameraIntrinsics **out_camera_intrinsics\n)\n``` \nAllocates a camera intrinstics object.\n\n\n| Details ||\n|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Parameters | |-------------------------|-----------------------------------------------------------------------------------------------| | `session` | The ARCore session | | `out_camera_intrinsics` | The [ArCameraIntrinsics](/ar/reference/c/group/ar-camera-intrinsics#arcameraintrinsics) data. | |\n\n### ArCameraIntrinsics_destroy\n\n```povray\nvoid ArCameraIntrinsics_destroy(\n ArCameraIntrinsics *camera_intrinsics\n)\n``` \nReleases the provided camera intrinsics object. \n\n### ArCameraIntrinsics_getFocalLength\n\n```gdscript\nvoid ArCameraIntrinsics_getFocalLength(\n const ArSession *session,\n const ArCameraIntrinsics *intrinsics,\n float *out_fx,\n float *out_fy\n)\n``` \nReturns the camera's focal length in pixels.\n\nThe focal length is conventionally represented in pixels. For a detailed explanation, please see \u003chttps://ksimek.github.io/2013/08/13/intrinsic\u003e. Pixels-to-meters conversion can use SENSOR_INFO_PHYSICAL_SIZE and SENSOR_INFO_PIXEL_ARRAY_SIZE in the Android Camera Characteristics API. \n\n### ArCameraIntrinsics_getImageDimensions\n\n```gdscript\nvoid ArCameraIntrinsics_getImageDimensions(\n const ArSession *session,\n const ArCameraIntrinsics *intrinsics,\n int32_t *out_width,\n int32_t *out_height\n)\n``` \nReturns the image's width and height in pixels. \n\n### ArCameraIntrinsics_getPrincipalPoint\n\n```gdscript\nvoid ArCameraIntrinsics_getPrincipalPoint(\n const ArSession *session,\n const ArCameraIntrinsics *intrinsics,\n float *out_cx,\n float *out_cy\n)\n``` \nReturns the principal point in pixels."]]
