ArResolveAnchorOnRooftopFuture

Handle to an async operation launched by ArEarth_resolveAnchorOnRooftopAsync.

See the Rooftop anchors developer guide for more information.

Summary

Typedefs

ArResolveAnchorOnRooftopCallback)(void *context, ArAnchor *anchor, ArRooftopAnchorState rooftop_anchor_state) typedef
void(*
Callback definition for ArEarth_resolveAnchorOnRooftopAsync.
ArResolveAnchorOnRooftopFuture typedef
struct ArResolveAnchorOnRooftopFuture_
Handle to an asynchronous operation launched by ArEarth_resolveAnchorOnRooftopAsync.

Functions

ArResolveAnchorOnRooftopFuture_acquireResultAnchor(const ArSession *session, const ArResolveAnchorOnRooftopFuture *future, ArAnchor **out_anchor)
void
Gets the resolved Rooftop anchor.
ArResolveAnchorOnRooftopFuture_getResultRooftopAnchorState(const ArSession *session, const ArResolveAnchorOnRooftopFuture *future, ArRooftopAnchorState *out_rooftop_anchor_state)
void
Gets the result status of the resolving operation, if the operation is done.

Typedefs

ArResolveAnchorOnRooftopCallback

void(* ArResolveAnchorOnRooftopCallback)(void *context, ArAnchor *anchor, ArRooftopAnchorState rooftop_anchor_state)

Callback definition for ArEarth_resolveAnchorOnRooftopAsync.

The context argument will be the same as that passed to ArEarth_resolveAnchorOnRooftopAsync. The anchor argument will be the same as that returned by ArResolveAnchorOnRooftopFuture_acquireResultAnchor and must be released using ArAnchor_release. The rooftop_anchor_state argument will be the same as that returned by ArResolveAnchorOnRooftopFuture_getResultRooftopAnchorState.

It is a best practice to free context memory provided to ArEarth_resolveAnchorOnRooftopAsync at the end of the callback implementation.

ArResolveAnchorOnRooftopFuture

struct ArResolveAnchorOnRooftopFuture_ ArResolveAnchorOnRooftopFuture

Handle to an asynchronous operation launched by ArEarth_resolveAnchorOnRooftopAsync.

Release with ArFuture_release. (reference type, long-lived).

Functions

ArResolveAnchorOnRooftopFuture_acquireResultAnchor

void ArResolveAnchorOnRooftopFuture_acquireResultAnchor(
  const ArSession *session,
  const ArResolveAnchorOnRooftopFuture *future,
  ArAnchor **out_anchor
)

Gets the resolved Rooftop anchor.

If the operation isn't done yet or the operation failed, this will be NULL. The caller must release the anchor using ArAnchor_release.

Details
Parameters
session
The ARCore session.
future
The handle for the asynchronous operation.
out_anchor
The anchor.

ArResolveAnchorOnRooftopFuture_getResultRooftopAnchorState

void ArResolveAnchorOnRooftopFuture_getResultRooftopAnchorState(
  const ArSession *session,
  const ArResolveAnchorOnRooftopFuture *future,
  ArRooftopAnchorState *out_rooftop_anchor_state
)

Gets the result status of the resolving operation, if the operation is done.

Details
Parameters
session
The ARCore session.
future
The handle for the asynchronous operation.
out_rooftop_anchor_state
The result status.