Struct ArConfig

Represents the configuration for an ArSession.

Namespace: UnityEngine.XR.ARCore
Syntax
public struct ArConfig : IEquatable<ArConfig>, IDisposable
Remarks

This is an opaque object that represents a native ArConfig.

Constructors

ArConfig(ArSession)

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

Declaration
public ArConfig(ArSession session)
Parameters
Type Name Description
ArSession session

A non-null ArSession.
Remarks

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.

When you no longer need the ArConfig, you should destroy it by calling Dispose(). If you do not dispose it, ARCore will leak memory.

Properties

IsNull

(Read Only) Indicates whether this ArConfig is Null.

Declaration
public readonly bool IsNull { get; }
Property Value
Type Description
Boolean

Null

Represents a null ArConfig, i.e., one whose underlying native pointer is null.

Declaration
public static readonly ArConfig Null { get; }
Property Value
Type Description
ArConfig

Methods

AsIntPtr()

Gets the underlying native pointer for this ArConfig.

Declaration
public IntPtr AsIntPtr()
Returns
Type Description
IntPtr

Returns the underlying native pointer for this ArConfig.

Dispose()

Destroys this ArConfig and sets the underlying native pointer to null.

Declaration
public void Dispose()
Remarks

You should only dispose an ArConfig if you explicitly created it, e.g., by calling ArConfig(ArSession). If you convert an existing config from an IntPtr (e.g., by calling FromIntPtr(IntPtr)), then you should not dispose it.

Equals(Object)

Tests for equality.

Declaration
public override bool Equals(object obj)
Parameters
Type Name Description
Object obj

An Object to compare against.
Returns
Type Description
Boolean

Returns true if obj is an ArConfig and it compares equal to this one using Equals(ArConfig).
Overrides

Equals(ArConfig)

Tests for equality.

Declaration
public bool Equals(ArConfig other)
Parameters
Type Name Description
ArConfig other

The ArConfig to compare against.
Returns
Type Description
Boolean

Returns true if the underlying native pointers are the same. Returns false otherwise.
Remarks

Two ArConfigs are considered equal if their underlying pointers are equal.

FromIntPtr(IntPtr)

Create a ArConfig from an existing native pointer. The native pointer must point to an existing ArConfig.

Declaration
public static ArConfig FromIntPtr(IntPtr value)
Parameters
Type Name Description
IntPtr value

A pointer to an existing native ArConfig.
Returns
Type Description
ArConfig

Returns an ArConfig whose underlying native pointer is value.

GetHashCode()

Generates a hash code suitable for use with a HashSet or Dictionary

Declaration
public override int GetHashCode()
Returns
Type Description
Int32

Returns a hash code for this ArConfig.
Overrides

Operators

Equality(ArConfig, ArConfig)

Tests for equality. Same as Equals(ArConfig).

Declaration
public static bool operator ==(ArConfig lhs, ArConfig rhs)
Parameters
Type Name Description
ArConfig lhs

The ArConfig to compare with rhs.
ArConfig rhs

The ArConfig to compare with lhs.
Returns
Type Description
Boolean

Returns true if lhs is equal to rhs using Equals(ArConfig). Returns false otherwise.

Explicit(ArConfig to IntPtr)

Casts an ArConfig to its underlying native pointer.

Declaration
public static explicit operator IntPtr(ArConfig config)
Parameters
Type Name Description
ArConfig config

The ArConfig to cast.
Returns
Type Description
IntPtr

Returns the underlying native pointer for config

Inequality(ArConfig, ArConfig)

Tests for inequality. Same as the negation of Equals(ArConfig).

Declaration
public static bool operator !=(ArConfig lhs, ArConfig rhs)
Parameters
Type Name Description
ArConfig lhs

The ArConfig to compare with rhs.
ArConfig rhs

The ArConfig to compare with lhs.
Returns
Type Description
Boolean

Returns false if lhs is equal to rhs using Equals(ArConfig). Returns true otherwise.

See Also