/// <summary>
/// Creates or updates the <see cref="CloudSpatialAnchor"/> returned by
/// <see cref="CloudAnchor"/> to reflect the same data as the native anchor.
/// </summary>
/// <param name="anchor">
/// The native anchor to convert to a cloud anchor.
/// </param>
/// <returns>
/// A Task that yields the <see cref="CloudSpatialAnchor"/>.
/// </returns>
/// <exception cref="System.ArgumentNullException">
/// Thrown if <paramref name="anchor"/> is <see langword = "null" />.
/// </exception>
/// <remarks>
/// This method is async because ARKit needs to process at least one
/// frame before any requested anchor is fully created. This method
/// will return only after any underlying native processes are
/// complete.
/// </remarks>
static public CloudSpatialAnchor ToCloud(this NativeAnchor anchor)
{
// Validate
if (anchor == null)
{
throw new ArgumentNullException(nameof(anchor));
}
// Get the native pointer
IntPtr ptr = anchor.GetPointer();
// Create the cloud version
CloudSpatialAnchor cloudAnchor = new CloudSpatialAnchor();
// Set the local pointer
cloudAnchor.LocalAnchor = ptr;
// Done!
return(cloudAnchor);
}
