ARPointCloudChangedEventArgs.cs 4.74 KB
using System;
using System.Collections.Generic;

namespace UnityEngine.XR.ARFoundation
{
    /// <summary>
    /// Event arguments for the <see cref="ARPointCloudManager.pointCloudsChanged"/> event.
    /// </summary>
    public struct ARPointCloudChangedEventArgs : IEquatable<ARPointCloudChangedEventArgs>
    {
        /// <summary>
        /// The list of <see cref="ARPointCloud"/>s added since the last event.
        /// </summary>
        public List<ARPointCloud> added { get; private set; }

        /// <summary>
        /// The list of <see cref="ARPointCloud"/>s udpated since the last event.
        /// </summary>
        public List<ARPointCloud> updated { get; private set; }

        /// <summary>
        /// The list of <see cref="ARPointCloud"/>s removed since the last event.
        /// </summary>
        public List<ARPointCloud> removed { get; private set; }

        /// <summary>
        /// Constructs an <see cref="ARPointCloudChangedEventArgs"/>.
        /// </summary>
        /// <param name="added">The list of <see cref="ARPointCloud"/>s added since the last event.</param>
        /// <param name="updated">The list of <see cref="ARPointCloud"/>s updated since the last event.</param>
        /// <param name="removed">The list of <see cref="ARPointCloud"/>s removed since the last event.</param>
        public ARPointCloudChangedEventArgs(
            List<ARPointCloud> added,
            List<ARPointCloud> updated,
            List<ARPointCloud> removed)
        {
            this.added = added;
            this.updated = updated;
            this.removed = removed;
        }

        /// <summary>
        /// Generates a hash suitable for use with containers like `HashSet` and `Dictionary`.
        /// </summary>
        /// <returns>A hash code generated from this object's fields.</returns>
        public override int GetHashCode() => HashCode.Combine(
            HashCode.ReferenceHash(added),
            HashCode.ReferenceHash(updated),
            HashCode.ReferenceHash(removed));

        /// <summary>
        /// Tests for equality.
        /// </summary>
        /// <param name="obj">The `object` to compare against.</param>
        /// <returns>`True` if <paramref name="obj"/> is of type <see cref="ARPointCloudChangedEventArgs"/> and
        /// <see cref="Equals(ARPointCloudChangedEventArgs)"/> also returns `true`; otherwise `false`.</returns>
        public override bool Equals(object obj)
        {
            if (!(obj is ARPointCloudChangedEventArgs))
                return false;
             return Equals((ARPointCloudChangedEventArgs)obj);
        }

        /// <summary>
        /// Generates a string representation of this <see cref="ARPointCloudChangedEventArgs"/>.
        /// </summary>
        /// <returns>A string representation of this <see cref="ARPointCloudChangedEventArgs"/>.</returns>
        public override string ToString()
        {
            return string.Format("Added: {0}, Updated: {1}, Removed: {2}",
                added == null ? 0 : added.Count,
                updated == null ? 0 : updated.Count,
                removed == null ? 0 : removed.Count);
        }

        /// <summary>
        /// Tests for equality.
        /// </summary>
        /// <param name="other">The other <see cref="ARPointCloudChangedEventArgs"/> to compare against.</param>
        /// <returns>`True` if every field in <paramref name="other"/> is equal to this <see cref="ARPointCloudChangedEventArgs"/>, otherwise false.</returns>
        public bool Equals(ARPointCloudChangedEventArgs other)
        {
            return
                (added == other.added) &&
                (updated == other.updated) &&
                (removed == other.removed);
        }

        /// <summary>
        /// Tests for equality. Same as <see cref="Equals(ARPointCloudChangedEventArgs)"/>.
        /// </summary>
        /// <param name="lhs">The left-hand side of the comparison.</param>
        /// <param name="rhs">The right-hand side of the comparison.</param>
        /// <returns>`True` if <paramref name="lhs"/> is equal to <paramref name="rhs"/>, otherwise `false`.</returns>
        public static bool operator ==(ARPointCloudChangedEventArgs lhs, ARPointCloudChangedEventArgs rhs) => lhs.Equals(rhs);

         /// <summary>
         /// Tests for inequality. Same as `!`<see cref="Equals(ARPointCloudChangedEventArgs)"/>.
         /// </summary>
         /// <param name="lhs">The left-hand side of the comparison.</param>
         /// <param name="rhs">The right-hand side of the comparison.</param>
         /// <returns>`True` if <paramref name="lhs"/> is not equal to <paramref name="rhs"/>, otherwise `false`.</returns>
        public static bool operator !=(ARPointCloudChangedEventArgs lhs, ARPointCloudChangedEventArgs rhs) => !lhs.Equals(rhs);
    }
}