Google is committed to advancing racial equity for Black communities. See how.

ArCameraConfigFilter

Filters available camera configurations.

Summary

Enumerations

ArCameraConfigDepthSensorUsage{
  AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_REQUIRE_AND_USE = 0x0001,
  AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE = 0x0002
}
enum
Depth sensor usage.
ArCameraConfigTargetFps{
  AR_CAMERA_CONFIG_TARGET_FPS_30 = 0x0001,
  AR_CAMERA_CONFIG_TARGET_FPS_60 = 0x0002
}
enum
Target camera capture frame rates.

Typedefs

ArCameraConfigFilter typedef
struct ArCameraConfigFilter_
A camera config filter struct contains the filters that are desired by the application.

Functions

ArCameraConfigFilter_create(const ArSession *session, ArCameraConfigFilter **out_filter)
void
Creates a camera config filter object.
ArCameraConfigFilter_destroy(ArCameraConfigFilter *filter)
void
Releases memory used by the provided camera config filter object.
ArCameraConfigFilter_getDepthSensorUsage(const ArSession *session, ArCameraConfigFilter *filter, uint32_t *out_depth_sensor_usage)
void
Gets the desired depth sensor usages to allow.
ArCameraConfigFilter_getTargetFps(const ArSession *session, ArCameraConfigFilter *filter, uint32_t *out_fps_filters)
void
Gets the desired framerates to allow.
ArCameraConfigFilter_setDepthSensorUsage(const ArSession *session, ArCameraConfigFilter *filter, uint32_t depth_sensor_usage_filters)
void
Sets the desired depth sensor usages to allow.
ArCameraConfigFilter_setTargetFps(const ArSession *session, ArCameraConfigFilter *filter, const uint32_t fps_filters)
void
Sets the desired framerates to allow.

Enumerations

ArCameraConfigDepthSensorUsage

 ArCameraConfigDepthSensorUsage

Depth sensor usage.

Properties
AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_DO_NOT_USE

When used as a camera filter, via ArCameraConfigFilter_setDepthSensorUsage, filters for camera configs where a depth sensor is not present, or is present but will not be used by ARCore.

Most commonly used to filter camera configurations when the app requires exclusive access to the depth sensor outside of ARCore, for example to support 3D mesh reconstruction. Available on all ARCore supported devices.

When returned by ArCameraConfig_getDepthSensorUsage, indicates that the camera config will not use a depth sensor, even if it is present.

AR_CAMERA_CONFIG_DEPTH_SENSOR_USAGE_REQUIRE_AND_USE

When used as a camera filter, via ArCameraConfigFilter_setDepthSensorUsage, filters for camera configs that require a depth sensor to be present on the device, and that will be used by ARCore.

See the ARCore supported devices (https://developers.google.com/ar/discover/supported-devices) page for a list of devices that currently have supported depth sensors.

When returned by ArCameraConfig_getDepthSensorUsage, indicates that a depth sensor is present, and that the camera config will use the available depth sensor.

ArCameraConfigTargetFps

 ArCameraConfigTargetFps

Target camera capture frame rates.

The target frame rate represents the maximum or desired frame rate. Actual camera capture frame rates can be lower than the target frame rate under low light conditions in order to accommodate longer exposure times.

Properties
AR_CAMERA_CONFIG_TARGET_FPS_30

Target 30fps camera capture frame rate.

Available on all ARCore supported devices.

Used as a camera filter, via ArCameraConfigFilter_setTargetFps.

AR_CAMERA_CONFIG_TARGET_FPS_60

Target 60fps camera capture frame rate.

Increases power consumption and may increase app memory usage.

See the ARCore supported devices (https://developers.google.com/ar/discover/supported-devices) page for a list of devices that currently support 60fps.

Used as a camera filter, via ArCameraConfigFilter_setTargetFps.

Typedefs

ArCameraConfigFilter

struct ArCameraConfigFilter_ ArCameraConfigFilter

A camera config filter struct contains the filters that are desired by the application.

(value type).

Functions

ArCameraConfigFilter_create

void ArCameraConfigFilter_create(
  const ArSession *session,
  ArCameraConfigFilter **out_filter
)

Creates a camera config filter object.

Details
Parameters
session
The ARCore session
out_filter
A pointer to an ArCameraConfigFilter* to receive the address of the newly allocated ArCameraConfigFilter

ArCameraConfigFilter_destroy

void ArCameraConfigFilter_destroy(
  ArCameraConfigFilter *filter
)

Releases memory used by the provided camera config filter object.

Details
Parameters
filter
The filter to release memory for.

ArCameraConfigFilter_getDepthSensorUsage

void ArCameraConfigFilter_getDepthSensorUsage(
  const ArSession *session,
  ArCameraConfigFilter *filter,
  uint32_t *out_depth_sensor_usage
)

Gets the desired depth sensor usages to allow.

Details
Parameters
session
The ARCore session
filter
The filter object to query
out_depth_sensor_usage
To be filled in with the desired depth sensor usages allowed

ArCameraConfigFilter_getTargetFps

void ArCameraConfigFilter_getTargetFps(
  const ArSession *session,
  ArCameraConfigFilter *filter,
  uint32_t *out_fps_filters
)

Gets the desired framerates to allow.

Details
Parameters
session
The ARCore session
filter
The filter object to query
out_fps_filters
To be filled in with the desired framerates allowed

ArCameraConfigFilter_setDepthSensorUsage

void ArCameraConfigFilter_setDepthSensorUsage(
  const ArSession *session,
  ArCameraConfigFilter *filter,
  uint32_t depth_sensor_usage_filters
)

Sets the desired depth sensor usages to allow.

Details
Parameters
session
The ARCore session
filter
The filter object to change
depth_sensor_usage_filters
A 32bit integer representing multiple ArCameraConfigDepthSensorUsage values, bitwise-or'd together

ArCameraConfigFilter_setTargetFps

void ArCameraConfigFilter_setTargetFps(
  const ArSession *session,
  ArCameraConfigFilter *filter,
  const uint32_t fps_filters
)

Sets the desired framerates to allow.

Details
Parameters
session
The ARCore session
filter
The filter object to change
fps_filters
A 32bit integer representing multiple ArCameraConfigTargetFps values, bitwise-or'd together