// ReSharper disable MemberCanBePrivate.Global // ReSharper disable UnusedMember.Global // ReSharper disable AutoPropertyCanBeMadeGetOnly.Global using System.Collections; using System.Collections.Generic; using System.Linq; namespace RGB.NET.Core { /// /// /// /// Represents a generic RGB-device. /// public abstract class AbstractRGBDevice : Placeable, IRGBDevice where TDeviceInfo : class, IRGBDeviceInfo { private RGBSurface? _surface; #region Properties & Fields RGBSurface? IRGBDevice.Surface { get => _surface; set { if (SetProperty(ref _surface, value)) { if (value == null) OnDetached(); else OnAttached(); } } } /// public abstract TDeviceInfo DeviceInfo { get; } /// IRGBDeviceInfo IRGBDevice.DeviceInfo => DeviceInfo; /// public IList ColorCorrections { get; } = new List(); /// /// Gets or sets if the device needs to be flushed on every update. /// protected bool RequiresFlush { get; set; } = false; /// /// Gets a dictionary containing all of the . /// protected Dictionary LedMapping { get; } = new(); #region Indexer /// Led? IRGBDevice.this[LedId ledId] => LedMapping.TryGetValue(ledId, out Led? led) ? led : null; /// Led? IRGBDevice.this[Point location] => LedMapping.Values.FirstOrDefault(x => x.Boundary.Contains(location)); /// IEnumerable IRGBDevice.this[Rectangle referenceRect, double minOverlayPercentage] => LedMapping.Values.Where(x => referenceRect.CalculateIntersectPercentage(x.Boundary) >= minOverlayPercentage); #endregion #endregion #region Methods /// public virtual void Update(bool flushLeds = false) { // Device-specific updates DeviceUpdate(); // Send LEDs to SDK List ledsToUpdate = GetLedsToUpdate(flushLeds).ToList(); foreach (Led ledToUpdate in ledsToUpdate) ledToUpdate.Update(); UpdateLeds(ledsToUpdate); } protected virtual IEnumerable GetLedsToUpdate(bool flushLeds) => ((RequiresFlush || flushLeds) ? LedMapping.Values : LedMapping.Values.Where(x => x.IsDirty)).Where(led => led.Color.A > 0); protected virtual IEnumerable<(object key, Color color)> GetUpdateData(IEnumerable leds) { if (ColorCorrections.Count > 0) { foreach (Led led in leds) { Color color = led.Color; object key = led.CustomData ?? led.Id; foreach (IColorCorrection colorCorrection in ColorCorrections) colorCorrection.ApplyTo(ref color); yield return (key, color); } } else { foreach (Led led in leds) { Color color = led.Color; object key = led.CustomData ?? led.Id; yield return (key, color); } } } /// public virtual void Dispose() { try { LedMapping.Clear(); } catch { /* this really shouldn't happen */ } } /// /// Performs device specific updates. /// protected virtual void DeviceUpdate() { } /// /// Sends all the updated to the device. /// protected abstract void UpdateLeds(IEnumerable ledsToUpdate); /// /// Initializes the with the specified id. /// /// The to initialize. /// The location of the to initialize. /// The size of the to initialize. /// The initialized led. public virtual Led? AddLed(LedId ledId, in Point location, in Size size, object? customData = null) { if ((ledId == LedId.Invalid) || LedMapping.ContainsKey(ledId)) return null; Led led = new(this, ledId, location, size, customData ?? GetLedCustomData(ledId)); LedMapping.Add(ledId, led); return led; } public virtual Led? RemoveLed(LedId ledId) { if (ledId == LedId.Invalid) return null; if (!LedMapping.TryGetValue(ledId, out Led? led)) return null; LedMapping.Remove(ledId); return led; } protected virtual object? GetLedCustomData(LedId ledId) => null; protected virtual void OnAttached() { if (Location == Point.Invalid) Location = new Point(0, 0); if (Size == Size.Invalid) { Rectangle ledRectangle = new(this.Select(x => x.Boundary)); Size = ledRectangle.Size + new Size(ledRectangle.Location.X, ledRectangle.Location.Y); } } protected virtual void OnDetached() { } #region Enumerator /// /// /// Returns an enumerator that iterates over all of the . /// /// An enumerator for all of the . public IEnumerator GetEnumerator() => LedMapping.Values.GetEnumerator(); /// /// /// Returns an enumerator that iterates over all of the . /// /// An enumerator for all of the . IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); #endregion #endregion } }