Reworked rendering

RGB.NET.Presets/Decorators/FlashDecorator.cs

@@ -0,0 +1,172 @@
+// ReSharper disable MemberCanBePrivate.Global
+// ReSharper disable AutoPropertyCanBeMadeGetOnly.Global
+// ReSharper disable UnusedMember.Global
+
+using System;
+using RGB.NET.Core;
+
+namespace RGB.NET.Presets.Decorators
+{
+    /// <inheritdoc cref="AbstractUpdateAwareDecorator" />
+    /// <inheritdoc cref="IBrushDecorator" />
+    /// <summary>
+    /// Represents a decorator which allows to flash a brush by modifying his opacity.
+    /// </summary>
+    public class FlashDecorator : AbstractUpdateAwareDecorator, IBrushDecorator
+    {
+        #region Properties & Fields
+
+        /// <summary>
+        /// Gets or sets the attack-time (in seconds) of the decorator. (default: 0.2)<br />
+        /// This is close to a synthesizer envelope. (See <see href="http://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope" />  as reference)
+        /// </summary>
+        public double Attack { get; set; } = 0.2;
+
+        /// <summary>
+        /// Gets or sets the decay-time (in seconds) of the decorator. (default: 0)<br />
+        /// This is close to a synthesizer envelope. (See <see href="http://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope" /> as reference)
+        /// </summary>
+        public double Decay { get; set; } = 0;
+
+        /// <summary>
+        /// Gets or sets the sustain-time (in seconds) of the decorator. (default: 0.3)<br />
+        /// This is close to a synthesizer envelope. (See <see href="http://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope" /> as reference)<br />
+        /// Note that this value for naming reasons represents the time NOT the level.
+        /// </summary>
+        public double Sustain { get; set; } = 0.3;
+
+        /// <summary>
+        /// Gets or sets the release-time (in seconds) of the decorator. (default: 0.2)<br />
+        /// This is close to a synthesizer envelope. (See <see href="http://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope" /> as reference)
+        /// </summary>
+        public double Release { get; set; } = 0.2;
+
+        /// <summary>
+        /// Gets or sets the level to which the oppacity (percentage) should raise in the attack-cycle. (default: 1);
+        /// </summary>
+        public double AttackValue { get; set; } = 1;
+
+        /// <summary>
+        /// Gets or sets the level at which the oppacity (percentage) should stay in the sustain-cycle. (default: 1);
+        /// </summary>
+        public double SustainValue { get; set; } = 1;
+
+        /// <summary>
+        /// Gets or sets the level at which the oppacity (percentage) should stay in the pause-cycle. (default: 0);
+        /// </summary>
+        public double PauseValue { get; set; } = 0;
+
+        /// <summary>
+        /// Gets or sets the interval (in seconds) in which the decorator should repeat (if repetition is enabled). (default: 1)
+        /// </summary>
+        public double Interval { get; set; } = 1;
+
+        /// <summary>
+        /// Gets or sets the amount of repetitions the decorator should do until it's finished. Zero means infinite. (default: 0)
+        /// </summary>
+        public int Repetitions { get; set; } = 0;
+
+        private ADSRPhase _currentPhase;
+        private double _currentPhaseValue;
+        private int _repetitionCount;
+
+        private double _currentValue;
+
+        #endregion
+
+        #region Constructors
+
+        public FlashDecorator(RGBSurface surface, bool updateIfDisabled = false)
+            : base(surface, updateIfDisabled)
+        { }
+
+        #endregion
+
+        #region Methods
+
+        /// <inheritdoc />
+        public void ManipulateColor(in Rectangle rectangle, in RenderTarget renderTarget, ref Color color) => color = color.SetA(_currentValue);
+
+        /// <inheritdoc />
+        protected override void Update(double deltaTime)
+        {
+            _currentPhaseValue -= deltaTime;
+
+            // Using ifs instead of a switch allows to skip phases with time 0.
+            // ReSharper disable InvertIf
+
+            if (_currentPhase == ADSRPhase.Attack)
+                if (_currentPhaseValue > 0)
+                    _currentValue = PauseValue + (Math.Min(1, (Attack - _currentPhaseValue) / Attack) * (AttackValue - PauseValue));
+                else
+                {
+                    _currentPhaseValue = Decay;
+                    _currentPhase = ADSRPhase.Decay;
+                }
+
+            if (_currentPhase == ADSRPhase.Decay)
+                if (_currentPhaseValue > 0)
+                    _currentValue = SustainValue + (Math.Min(1, _currentPhaseValue / Decay) * (AttackValue - SustainValue));
+                else
+                {
+                    _currentPhaseValue = Sustain;
+                    _currentPhase = ADSRPhase.Sustain;
+                }
+
+            if (_currentPhase == ADSRPhase.Sustain)
+                if (_currentPhaseValue > 0)
+                    _currentValue = SustainValue;
+                else
+                {
+                    _currentPhaseValue = Release;
+                    _currentPhase = ADSRPhase.Release;
+                }
+
+            if (_currentPhase == ADSRPhase.Release)
+                if (_currentPhaseValue > 0)
+                    _currentValue = PauseValue + (Math.Min(1, _currentPhaseValue / Release) * (SustainValue - PauseValue));
+                else
+                {
+                    _currentPhaseValue = Interval;
+                    _currentPhase = ADSRPhase.Pause;
+                }
+
+            if (_currentPhase == ADSRPhase.Pause)
+                if (_currentPhaseValue > 0)
+                    _currentValue = PauseValue;
+                else
+                {
+                    if ((++_repetitionCount >= Repetitions) && (Repetitions > 0))
+                        Detach();
+                    _currentPhaseValue = Attack;
+                    _currentPhase = ADSRPhase.Attack;
+                }
+
+            // ReSharper restore InvertIf
+        }
+
+        /// <inheritdoc cref="AbstractUpdateAwareDecorator.OnAttached" />
+        /// <inheritdoc cref="IDecorator.OnAttached" />
+        public override void OnAttached(IDecoratable decoratable)
+        {
+            base.OnAttached(decoratable);
+
+            _currentPhase = ADSRPhase.Attack;
+            _currentPhaseValue = Attack;
+            _repetitionCount = 0;
+            _currentValue = 0;
+        }
+
+        #endregion
+
+        // ReSharper disable once InconsistentNaming
+        private enum ADSRPhase
+        {
+            Attack,
+            Decay,
+            Sustain,
+            Release,
+            Pause
+        }
+    }
+}

RGB.NET.Presets/Decorators/IGradientDecorator.cs

@@ -0,0 +1,11 @@
+using RGB.NET.Core;
+
+namespace RGB.NET.Presets.Decorators
+{
+    /// <inheritdoc />
+    /// <summary>
+    /// Represents a basic decorator decorating a <see cref="T:RGB.NET.Presets.Gradients.IGradient" />.
+    /// </summary>
+    public interface IGradientDecorator : IDecorator
+    { }
+}

RGB.NET.Presets/Decorators/MoveGradientDecorator.cs

@@ -0,0 +1,73 @@
+using RGB.NET.Core;
+using RGB.NET.Presets.Textures.Gradients;
+
+namespace RGB.NET.Presets.Decorators
+{
+    /// <inheritdoc cref="AbstractUpdateAwareDecorator" />
+    /// <inheritdoc cref="IGradientDecorator" />
+    /// <summary>
+    /// Represents a decorator which allows to move an <see cref="T:RGB.NET.Presets.Gradients.IGradient" /> by modifying his offset.
+    /// </summary>
+    public class MoveGradientDecorator : AbstractUpdateAwareDecorator, IGradientDecorator
+    {
+        #region Properties & Fields
+        // ReSharper disable AutoPropertyCanBeMadeGetOnly.Global
+        // ReSharper disable MemberCanBePrivate.Global
+
+        /// <summary>
+        /// Gets or sets the direction the <see cref="IGradient"/> is moved.
+        /// True leads to an offset-increment (normaly moving to the right), false to an offset-decrement (normaly moving to the left).
+        /// </summary>
+        public bool Direction { get; set; }
+
+        /// <summary>
+        /// Gets or sets the speed of the movement in units per second.
+        /// The meaning of units differs for the different <see cref="IGradient"/>, but 360 units will always be one complete cycle:
+        ///   <see cref="LinearGradient"/>: 360 unit = 1 offset.
+        ///   <see cref="RainbowGradient"/>: 1 unit = 1 degree.
+        /// </summary>
+        public double Speed { get; set; }
+
+        // ReSharper restore MemberCanBePrivate.Global
+        // ReSharper restore AutoPropertyCanBeMadeGetOnly.Global
+        #endregion
+
+        #region Constructors
+
+        /// <inheritdoc />
+        /// <summary>
+        /// Initializes a new instance of the <see cref="T:RGB.NET.Presets.Decorators.MoveGradientDecorator" /> class.
+        /// </summary>
+        /// <param name="speed">The speed of the movement in units per second.
+        /// The meaning of units differs for the different <see cref="T:RGB.NET.Presets.Gradients.IGradient" />  but 360 units will always be one complete cycle:
+        ///   <see cref="T:RGB.NET.Presets.Gradients.LinearGradient" />: 360 unit = 1 offset.
+        ///   <see cref="T:RGB.NET.Presets.Gradients.RainbowGradient" />: 1 unit = 1 degree.</param>
+        /// <param name="direction">The direction the <see cref="T:RGB.NET.Presets.Gradients.IGradient" /> is moved.
+        /// True leads to an offset-increment (normaly moving to the right), false to an offset-decrement (normaly moving to the left).</param>
+        public MoveGradientDecorator(RGBSurface surface, double speed = 180.0, bool direction = true)
+            : base(surface)
+        {
+            this.Speed = speed;
+            this.Direction = direction;
+        }
+
+        #endregion
+
+        #region Methods
+
+        /// <inheritdoc />
+        protected override void Update(double deltaTime)
+        {
+            double movement = Speed * deltaTime;
+
+            if (!Direction)
+                movement = -movement;
+
+            foreach (IDecoratable decoratedObject in DecoratedObjects)
+                if (decoratedObject is IGradient gradient)
+                    gradient.Move(movement);
+        }
+
+        #endregion
+    }
+}