RGB.NET/RGB.NET.Core/Groups/ListLedGroup.cs

// ReSharper disable MemberCanBePrivate.Global
// ReSharper disable UnusedMember.Global

using System.Collections.Generic;

namespace RGB.NET.Core;

/// <inheritdoc />
/// <summary>
/// Represents a ledgroup containing arbitrary <see cref="T:RGB.NET.Core.Led" />.
/// </summary>
public class ListLedGroup : AbstractLedGroup
{
    #region Properties & Fields

    /// <summary>
    /// Gets the list containing the <see cref="Led"/> of this <see cref="ListLedGroup"/>.
    /// </summary>
    protected IList<Led> GroupLeds { get; } = new List<Led>();

    #endregion

    #region Constructors

    /// <inheritdoc />
    /// <summary>
    /// Initializes a new instance of the <see cref="T:RGB.NET.Groups.ListLedGroup" /> class.
    /// </summary>
    /// <param name="surface">Specifies the surface to attach this group to or <c>null</c> if the group should not be attached on creation.</param>
    public ListLedGroup(RGBSurface? surface)
        : base(surface)
    { }

    /// <inheritdoc />
    /// <summary>
    /// Initializes a new instance of the <see cref="T:RGB.NET.Groups.ListLedGroup" /> class.
    /// </summary>
    /// <param name="surface">Specifies the surface to attach this group to or <c>null</c> if the group should not be attached on creation.</param>
    /// <param name="leds">The initial <see cref="T:RGB.NET.Core.Led" /> of this <see cref="T:RGB.NET.Groups.ListLedGroup" />.</param>
    public ListLedGroup(RGBSurface? surface, IEnumerable<Led> leds)
        : base(surface)
    {
        AddLeds(leds);
    }

    /// <inheritdoc />
    /// <summary>
    /// Initializes a new instance of the <see cref="T:RGB.NET.Groups.ListLedGroup" /> class.
    /// </summary>
    /// <param name="surface">Specifies the surface to attach this group to or <c>null</c> if the group should not be attached on creation.</param>
    /// <param name="leds">The initial <see cref="T:RGB.NET.Core.Led" /> of this <see cref="T:RGB.NET.Groups.ListLedGroup" />.</param>
    public ListLedGroup(RGBSurface? surface, params Led[] leds)
        : base(surface)
    {
        AddLeds(leds);
    }

    #endregion

    #region Methods

    /// <summary>
    /// Adds the specified LED(s) to this <see cref="ListLedGroup"/>.
    /// </summary>
    /// <param name="leds">The LED(s) to add.</param>
    public void AddLed(params Led[] leds) => AddLeds(leds);

    /// <summary>
    /// Adds the specified <see cref="Led"/> to this <see cref="ListLedGroup"/>.
    /// </summary>
    /// <param name="leds">The <see cref="Led"/> to add.</param>
    public void AddLeds(IEnumerable<Led> leds)
    {
        lock (GroupLeds)
            foreach (Led led in leds)
                if (!ContainsLed(led))
                    GroupLeds.Add(led);
    }

    /// <summary>
    /// Removes the specified LED(s) from this <see cref="ListLedGroup"/>.
    /// </summary>
    /// <param name="leds">The LED(s) to remove.</param>
    public void RemoveLed(params Led[] leds) => RemoveLeds(leds);

    /// <summary>
    /// Removes the specified <see cref="Led"/> from this <see cref="ListLedGroup"/>.
    /// </summary>
    /// <param name="leds">The <see cref="Led"/> to remove.</param>
    public void RemoveLeds(IEnumerable<Led> leds)
    {
        lock (GroupLeds)
            foreach (Led led in leds)
                GroupLeds.Remove(led);
    }

    /// <summary>
    /// Checks if a specified LED is contained by this ledgroup.
    /// </summary>
    /// <param name="led">The LED which should be checked.</param>
    /// <returns><c>true</c> if the LED is contained by this ledgroup; otherwise, <c>false</c>.</returns>
    public bool ContainsLed(Led led)
    {
        lock (GroupLeds)
            return GroupLeds.Contains(led);
    }

    /// <summary>
    /// Merges the <see cref="Led"/> from the specified ledgroup in this ledgroup. 
    /// </summary>
    /// <param name="groupToMerge">The ledgroup to merge.</param>
    public void MergeLeds(ILedGroup groupToMerge)
    {
        lock (GroupLeds)
            foreach (Led led in groupToMerge)
                if (!GroupLeds.Contains(led))
                    GroupLeds.Add(led);
    }

    /// <inheritdoc />
    /// <summary>
    /// Gets a list containing the <see cref="T:RGB.NET.Core.Led" /> from this group.
    /// </summary>
    /// <returns>The list containing the <see cref="T:RGB.NET.Core.Led" />.</returns>
    protected override IEnumerable<Led> GetLeds()
    {
        lock (GroupLeds)
            return new List<Led>(GroupLeds);
    }

    #endregion
}