// ReSharper disable MemberCanBePrivate.Global // ReSharper disable UnusedMember.Global using System; using System.Collections; using System.Collections.Generic; using System.IO; using System.Linq; using RGB.NET.Core.Layout; namespace RGB.NET.Core { /// /// /// /// Represents a generic RGB-device /// public abstract class AbstractRGBDevice : AbstractBindable, IRGBDevice where TDeviceInfo : IRGBDeviceInfo { #region Properties & Fields /// public abstract TDeviceInfo DeviceInfo { get; } /// IRGBDeviceInfo IRGBDevice.DeviceInfo => DeviceInfo; private Size _size = Size.Invalid; /// public Size Size { get => _size; set => SetProperty(ref _size, value); } private Point _location = new Point(0, 0); /// public Point Location { get => _location; set => SetProperty(ref _location, value); } /// public DeviceUpdateMode UpdateMode { get; set; } = DeviceUpdateMode.Sync; /// /// Gets a dictionary containing all of the . /// protected Dictionary LedMapping { get; } = new Dictionary(); /// /// Gets a dictionary containing all associated with this . /// protected Dictionary SpecialDeviceParts { get; } = new Dictionary(); #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.LedRectangle.Contains(location)); /// IEnumerable IRGBDevice.this[Rectangle referenceRect, double minOverlayPercentage] => LedMapping.Values.Where(x => referenceRect.CalculateIntersectPercentage(x.LedRectangle) >= minOverlayPercentage); #endregion #endregion #region Methods /// public virtual void Update(bool render = true, bool flushLeds = false) { // Device-specific updates DeviceUpdate(); // Send LEDs to SDK IEnumerable ledsToUpdate = (flushLeds ? LedMapping.Values : LedMapping.Values.Where(x => x.IsDirty)).ToList(); foreach (Led ledToUpdate in ledsToUpdate) ledToUpdate.Update(); if (UpdateMode.HasFlag(DeviceUpdateMode.Sync)) UpdateLeds(ledsToUpdate); } /// public virtual void SyncBack() { } /// public virtual void Dispose() { SpecialDeviceParts.Clear(); LedMapping.Clear(); } /// /// 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 representing the position of the to initialize. /// protected virtual Led InitializeLed(LedId ledId, Rectangle ledRectangle) { if ((ledId == LedId.Invalid) || LedMapping.ContainsKey(ledId)) return null; Led led = new Led(this, ledId, ledRectangle, CreateLedCustomData(ledId)); LedMapping.Add(ledId, led); return led; } /// /// Applies the given layout. /// /// The file containing the layout. /// The name of the layout used to get the images of the leds. /// The path images for this device are collected in. /// If set to true a new led is initialized for every id in the layout if it doesn't already exist. protected virtual void ApplyLayoutFromFile(string layoutPath, string imageLayout, string imageBasePath, bool createMissingLeds = false) { DeviceLayout layout = DeviceLayout.Load(layoutPath); if (layout != null) { LedImageLayout ledImageLayout = layout.LedImageLayouts.FirstOrDefault(x => string.Equals(x.Layout, imageLayout, StringComparison.OrdinalIgnoreCase)); Size = new Size(layout.Width, layout.Height); if (layout.Leds != null) foreach (LedLayout layoutLed in layout.Leds) { if (Enum.TryParse(layoutLed.Id, true, out LedId ledId)) { if (!LedMapping.TryGetValue(ledId, out Led led) && createMissingLeds) led = InitializeLed(ledId, new Rectangle()); if (led != null) { led.LedRectangle.Location = new Point(layoutLed.X, layoutLed.Y); led.LedRectangle.Size = new Size(layoutLed.Width, layoutLed.Height); led.Shape = layoutLed.Shape; led.ShapeData = layoutLed.ShapeData; LedImage image = ledImageLayout?.LedImages.FirstOrDefault(x => x.Id == layoutLed.Id); led.Image = (!string.IsNullOrEmpty(image?.Image)) ? new Uri(Path.Combine(imageBasePath, image.Image), UriKind.Absolute) : new Uri(Path.Combine(imageBasePath, "Missing.png"), UriKind.Absolute); } } } } } /// /// Creates provider-specific data associated with this . /// /// The . protected virtual object CreateLedCustomData(LedId ledId) => null; /// public void AddSpecialDevicePart(T specialDevicePart) where T : class, IRGBDeviceSpecialPart => SpecialDeviceParts[typeof(T)] = specialDevicePart; /// public T GetSpecialDevicePart() where T : class, IRGBDeviceSpecialPart => SpecialDeviceParts.TryGetValue(typeof(T), out IRGBDeviceSpecialPart devicePart) ? (T)devicePart : default(T); #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 } }