ArResolveAnchorOnTerrainFuture
An asynchronous operation for resolving a terrain anchor launched by ArEarth_resolveAnchorOnTerrainAsync
.
See the Terrain anchors developer guide for more information.
Summary
Typedefs |
|
---|---|
ArResolveAnchorOnTerrainCallback)(void *context, ArAnchor *anchor, ArTerrainAnchorState terrain_anchor_state)
|
typedefvoid(*
Callback definition for ArEarth_resolveAnchorOnTerrainAsync . |
ArResolveAnchorOnTerrainFuture
|
typedefstruct ArResolveAnchorOnTerrainFuture_
Handle to an asynchronous operation launched by ArEarth_resolveAnchorOnTerrainAsync . |
Functions |
|
---|---|
ArResolveAnchorOnTerrainFuture_acquireResultAnchor(const ArSession *session, const ArResolveAnchorOnTerrainFuture *future, ArAnchor **out_anchor)
|
void
Gets the resolved Terrain anchor.
|
ArResolveAnchorOnTerrainFuture_getResultTerrainAnchorState(const ArSession *session, const ArResolveAnchorOnTerrainFuture *future, ArTerrainAnchorState *out_terrain_anchor_state)
|
void
Gets the result status of the resolving operation, if the operation is done.
|
Typedefs
ArResolveAnchorOnTerrainCallback
void(* ArResolveAnchorOnTerrainCallback)(void *context, ArAnchor *anchor, ArTerrainAnchorState terrain_anchor_state)
Callback definition for ArEarth_resolveAnchorOnTerrainAsync
.
The context
argument will be the same as that passed to ArEarth_resolveAnchorOnTerrainAsync
. The anchor
argument will be the same as that returned by ArResolveAnchorOnTerrainFuture_acquireResultAnchor
and must be released using ArAnchor_release
. The terrain_anchor_state
argument will be the same as that returned by ArResolveAnchorOnTerrainFuture_getResultTerrainAnchorState
.
It is a best practice to free context
memory provided to ArEarth_resolveAnchorOnTerrainAsync
at the end of the callback implementation.
ArResolveAnchorOnTerrainFuture
struct ArResolveAnchorOnTerrainFuture_ ArResolveAnchorOnTerrainFuture
Handle to an asynchronous operation launched by ArEarth_resolveAnchorOnTerrainAsync
.
Release with ArFuture_release
. (reference type, long-lived).
Functions
ArResolveAnchorOnTerrainFuture_acquireResultAnchor
void ArResolveAnchorOnTerrainFuture_acquireResultAnchor( const ArSession *session, const ArResolveAnchorOnTerrainFuture *future, ArAnchor **out_anchor )
Gets the resolved Terrain 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 |
|
ArResolveAnchorOnTerrainFuture_getResultTerrainAnchorState
void ArResolveAnchorOnTerrainFuture_getResultTerrainAnchorState( const ArSession *session, const ArResolveAnchorOnTerrainFuture *future, ArTerrainAnchorState *out_terrain_anchor_state )
Gets the result status of the resolving operation, if the operation is done.
Details | |||||||
---|---|---|---|---|---|---|---|
Parameters |
|