Configuration

Session configuration.

Summary

Enumerations

ArLightEstimationMode{
  AR_LIGHT_ESTIMATION_MODE_DISABLED = 0,
  AR_LIGHT_ESTIMATION_MODE_AMBIENT_INTENSITY = 1
}
enum
Select the behavior of the lighting estimation subsystem.
ArPlaneFindingMode{
  AR_PLANE_FINDING_MODE_DISABLED = 0,
  AR_PLANE_FINDING_MODE_HORIZONTAL = 1
}
enum
Select the behavior of the plane detection subsystem.
ArUpdateMode{
  AR_UPDATE_MODE_BLOCKING = 0,
  AR_UPDATE_MODE_LATEST_CAMERA_IMAGE = 1
}
enum
Selects the behavior of ArSession_update().

Typedefs

ArConfig typedef
struct ArConfig_
An opaque session configuration object (value type).

Functions

ArConfig_create(const ArSession *session, ArConfig **out_config)
void
Creates a new configuration object and initializes it to a sensible default configuration.
ArConfig_destroy(ArConfig *config)
void
Releases memory used by the provided configuration object.
ArConfig_getLightEstimationMode(const ArSession *session, const ArConfig *config, ArLightEstimationMode *light_estimation_mode)
void
Stores the currently configured lighting estimation mode into *light_estimation_mode.
ArConfig_getPlaneFindingMode(const ArSession *session, const ArConfig *config, ArPlaneFindingMode *plane_finding_mode)
void
Stores the currently configured plane finding mode into *plane_finding_mode.
ArConfig_getUpdateMode(const ArSession *session, const ArConfig *config, ArUpdateMode *update_mode)
void
Stores the currently configured behavior of ArSession_update() into *update_mode.
ArConfig_setLightEstimationMode(const ArSession *session, ArConfig *config, ArLightEstimationMode light_estimation_mode)
void
Sets the lighting estimation mode that should be used.
ArConfig_setPlaneFindingMode(const ArSession *session, ArConfig *config, ArPlaneFindingMode plane_finding_mode)
void
Sets the plane finding mode that should be used.
ArConfig_setUpdateMode(const ArSession *session, ArConfig *config, ArUpdateMode update_mode)
void
Sets the behavior of ArSession_update().

Enumerations

ArLightEstimationMode

 ArLightEstimationMode

Select the behavior of the lighting estimation subsystem.

Properties
AR_LIGHT_ESTIMATION_MODE_AMBIENT_INTENSITY

Lighting estimation is enabled, generating a single-value intensity estimate.

AR_LIGHT_ESTIMATION_MODE_DISABLED

Lighting estimation is disabled.

ArPlaneFindingMode

 ArPlaneFindingMode

Select the behavior of the plane detection subsystem.

Properties
AR_PLANE_FINDING_MODE_DISABLED

Plane detection is disabled.

AR_PLANE_FINDING_MODE_HORIZONTAL

Detection of only horizontal planes is enabled.

ArUpdateMode

 ArUpdateMode

Selects the behavior of ArSession_update().

Properties
AR_UPDATE_MODE_BLOCKING

update() will wait until a new camera image is available.

On most devices the camera is configured to capture 30 frames per second.

AR_UPDATE_MODE_LATEST_CAMERA_IMAGE

update() will return immediately without blocking.

If no new camera image is available, then update() will return the most recent ArFrame object.

Typedefs

ArConfig

struct ArConfig_ ArConfig

An opaque session configuration object (value type).

Create with ArConfig_create()
Release with ArConfig_destroy()

Functions

ArConfig_create

void ArConfig_create(
  const ArSession *session,
  ArConfig **out_config
)

Creates a new configuration object and initializes it to a sensible default configuration.

Plane detection and lighting estimation are enabled, and blocking update is selected. This configuration is guaranteed to be supported on all devices that support ARCore.

ArConfig_destroy

void ArConfig_destroy(
  ArConfig *config
)

Releases memory used by the provided configuration object.

ArConfig_getLightEstimationMode

void ArConfig_getLightEstimationMode(
  const ArSession *session,
  const ArConfig *config,
  ArLightEstimationMode *light_estimation_mode
)

Stores the currently configured lighting estimation mode into *light_estimation_mode.

ArConfig_getPlaneFindingMode

void ArConfig_getPlaneFindingMode(
  const ArSession *session,
  const ArConfig *config,
  ArPlaneFindingMode *plane_finding_mode
)

Stores the currently configured plane finding mode into *plane_finding_mode.

ArConfig_getUpdateMode

void ArConfig_getUpdateMode(
  const ArSession *session,
  const ArConfig *config,
  ArUpdateMode *update_mode
)

Stores the currently configured behavior of ArSession_update() into *update_mode.

ArConfig_setLightEstimationMode

void ArConfig_setLightEstimationMode(
  const ArSession *session,
  ArConfig *config,
  ArLightEstimationMode light_estimation_mode
)

Sets the lighting estimation mode that should be used.

See ArLightEstimationMode for available options.

ArConfig_setPlaneFindingMode

void ArConfig_setPlaneFindingMode(
  const ArSession *session,
  ArConfig *config,
  ArPlaneFindingMode plane_finding_mode
)

Sets the plane finding mode that should be used.

See ArPlaneFindingMode for available options.

ArConfig_setUpdateMode

void ArConfig_setUpdateMode(
  const ArSession *session,
  ArConfig *config,
  ArUpdateMode update_mode
)

Sets the behavior of ArSession_update().

See ArUpdateMode for available options.

Send feedback about...