1
0
mirror of https://github.com/DarthAffe/CUE.NET.git synced 2025-12-13 09:08:34 +00:00

Added even more xml-comments

This commit is contained in:
Darth Affe 2015-10-18 11:41:42 +02:00
parent 6de1087c1f
commit 5fc7abc9db
30 changed files with 639 additions and 17 deletions

View File

@ -99,6 +99,7 @@ namespace CUE.NET.Devices.Generic
/// <summary> /// <summary>
/// Checks if automatic updates should occur and starts/stops the update-loop if needed. /// Checks if automatic updates should occur and starts/stops the update-loop if needed.
/// </summary> /// </summary>
/// <exception cref="ArgumentOutOfRangeException">Thrown if the requested update-mode is not available.</exception>
protected async void CheckUpdateLoop() protected async void CheckUpdateLoop()
{ {
bool shouldRun; bool shouldRun;

View File

@ -24,7 +24,6 @@ namespace CUE.NET.Devices.Headset
/// </summary> /// </summary>
/// <param name="ledId">The ID of the LED to get.</param> /// <param name="ledId">The ID of the LED to get.</param>
/// <returns>The LED with the specified ID.</returns> /// <returns>The LED with the specified ID.</returns>
/// <exception cref="System.ArgumentNullException" accessor="get"><paramref name="ledId" /> is null.</exception>
public CorsairLed this[CorsairHeadsetLedId ledId] public CorsairLed this[CorsairHeadsetLedId ledId]
{ {
get get
@ -42,7 +41,7 @@ namespace CUE.NET.Devices.Headset
public CorsairHeadsetDeviceInfo HeadsetDeviceInfo { get; } public CorsairHeadsetDeviceInfo HeadsetDeviceInfo { get; }
/// <summary> /// <summary>
/// Indicates if the headset has an active effect to deal with. /// Gets a value indicating if the headset has an active effect to deal with or not.
/// </summary> /// </summary>
protected override bool HasEffect => false; protected override bool HasEffect => false;

View File

@ -30,6 +30,7 @@ namespace CUE.NET.Devices
/// </summary> /// </summary>
float UpdateFrequency { get; set; } float UpdateFrequency { get; set; }
// ReSharper disable once EventNeverSubscribedTo.Global
/// <summary> /// <summary>
/// Occurs when a catched exception is thrown inside the device. /// Occurs when a catched exception is thrown inside the device.
/// </summary> /// </summary>

View File

@ -2,6 +2,9 @@
namespace CUE.NET.Devices namespace CUE.NET.Devices
{ {
/// <summary>
/// Represents generic device information.
/// </summary>
public interface IDeviceInfo public interface IDeviceInfo
{ {
/// <summary> /// <summary>

View File

@ -3,17 +3,32 @@ using CUE.NET.Helper;
namespace CUE.NET.Devices.Keyboard.Brushes namespace CUE.NET.Devices.Keyboard.Brushes
{ {
/// <summary>
/// Represents a basic brush.
/// </summary>
public abstract class AbstractBrush : IBrush public abstract class AbstractBrush : IBrush
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the overall percentage brightness of the brush.
/// </summary>
public float Brightness { get; set; } public float Brightness { get; set; }
/// <summary>
/// Gets or sets the overall percentage opacity of the brush.
/// </summary>
public float Opacity { get; set; } public float Opacity { get; set; }
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="AbstractBrush"/> class.
/// </summary>
/// <param name="brightness">The overall percentage brightness of the brush. (default: 1f)</param>
/// <param name="opacity">The overall percentage opacity of the brush. (default: 1f)</param>
protected AbstractBrush(float brightness = 1f, float opacity = 1f) protected AbstractBrush(float brightness = 1f, float opacity = 1f)
{ {
this.Brightness = brightness; this.Brightness = brightness;
@ -24,8 +39,20 @@ namespace CUE.NET.Devices.Keyboard.Brushes
#region Methods #region Methods
/// <summary>
/// Gets the color at an specific point assuming the brush is drawn into the given rectangle.
/// </summary>
/// <param name="rectangle">The rectangle in which the brush should be drawn.</param>
/// <param name="point">The point from which the color should be taken.</param>
/// <returns>The color at the specified point.</returns>
public abstract Color GetColorAtPoint(RectangleF rectangle, PointF point); public abstract Color GetColorAtPoint(RectangleF rectangle, PointF point);
/// <summary>
/// Finalizes the color by appliing the overall brightness and opacity.<br/>
/// This method should always be the last call of a <see cref="GetColorAtPoint" /> implementation.
/// </summary>
/// <param name="color">The color to finalize.</param>
/// <returns>The finalized color.</returns>
protected virtual Color FinalizeColor(Color color) protected virtual Color FinalizeColor(Color color)
{ {
// Since we use HSV to calculate there is no way to make a color 'brighter' than 100% // Since we use HSV to calculate there is no way to make a color 'brighter' than 100%

View File

@ -6,19 +6,32 @@ using System.Linq;
namespace CUE.NET.Devices.Keyboard.Brushes.Gradient namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
{ {
/// <summary>
/// Represents a basic gradient.
/// </summary>
public abstract class AbstractGradient : IGradient public abstract class AbstractGradient : IGradient
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets a list of the stops used by this gradient.
/// </summary>
public IList<GradientStop> GradientStops { get; } = new List<GradientStop>(); public IList<GradientStop> GradientStops { get; } = new List<GradientStop>();
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="AbstractGradient"/> class.
/// </summary>
protected AbstractGradient() protected AbstractGradient()
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="AbstractGradient"/> class.
/// </summary>
/// <param name="gradientStops">The stops with which the gradient should be initialized.</param>
protected AbstractGradient(params GradientStop[] gradientStops) protected AbstractGradient(params GradientStop[] gradientStops)
{ {
foreach (GradientStop gradientStop in gradientStops) foreach (GradientStop gradientStop in gradientStops)
@ -29,6 +42,11 @@ namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
#region Methods #region Methods
/// <summary>
/// Clips the offset and ensures, that it is inside the bounds of the stop list.
/// </summary>
/// <param name="offset"></param>
/// <returns></returns>
protected float ClipOffset(float offset) protected float ClipOffset(float offset)
{ {
float max = GradientStops.Max(n => n.Offset); float max = GradientStops.Max(n => n.Offset);
@ -42,6 +60,11 @@ namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
return offset; return offset;
} }
/// <summary>
/// Gets the color of the gradient on the specified offset.
/// </summary>
/// <param name="offset">The percentage offset to take the color from.</param>
/// <returns>The color at the specific offset.</returns>
public abstract Color GetColor(float offset); public abstract Color GetColor(float offset);
#endregion #endregion

View File

@ -5,18 +5,32 @@ using System.Drawing;
namespace CUE.NET.Devices.Keyboard.Brushes.Gradient namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
{ {
/// <summary>
/// Represents a stop on a gradient.
/// </summary>
public class GradientStop public class GradientStop
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the percentage offset to place this stop. This should be inside the range of [0..1] but it's not necessary.
/// </summary>
public float Offset { get; set; } public float Offset { get; set; }
/// <summary>
/// Gets or sets the color of the stop.
/// </summary>
public Color Color { get; set; } public Color Color { get; set; }
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="GradientStop"/> class.
/// </summary>
/// <param name="offset">The percentage offset to place this stop.</param>
/// <param name="color">The color of the stop.</param>
public GradientStop(float offset, Color color) public GradientStop(float offset, Color color)
{ {
this.Offset = offset; this.Offset = offset;

View File

@ -2,8 +2,16 @@
namespace CUE.NET.Devices.Keyboard.Brushes.Gradient namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
{ {
/// <summary>
/// Represents a basic gradient.
/// </summary>
public interface IGradient public interface IGradient
{ {
/// <summary>
/// Gets the color of the gradient on the specified offset.
/// </summary>
/// <param name="offset">The percentage offset to take the color from.</param>
/// <returns>The color at the specific offset.</returns>
Color GetColor(float offset); Color GetColor(float offset);
} }
} }

View File

@ -3,13 +3,23 @@ using System.Linq;
namespace CUE.NET.Devices.Keyboard.Brushes.Gradient namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
{ {
/// <summary>
/// Represents a linear interpolated gradient with n stops.
/// </summary>
public class LinearGradient : AbstractGradient public class LinearGradient : AbstractGradient
{ {
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="LinearGradient"/> class.
/// </summary>
public LinearGradient() public LinearGradient()
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="LinearGradient"/> class.
/// </summary>
/// <param name="gradientStops">The stops with which the gradient should be initialized.</param>
public LinearGradient(params GradientStop[] gradientStops) public LinearGradient(params GradientStop[] gradientStops)
: base(gradientStops) : base(gradientStops)
{ } { }
@ -18,6 +28,11 @@ namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
#region Methods #region Methods
/// <summary>
/// Gets the linear interpolated color at the given offset.
/// </summary>
/// <param name="offset">The percentage offset to take the color from.</param>
/// <returns>The color at the specific offset.</returns>
public override Color GetColor(float offset) public override Color GetColor(float offset)
{ {
if (!GradientStops.Any()) return Color.Transparent; if (!GradientStops.Any()) return Color.Transparent;

View File

@ -5,17 +5,33 @@ using CUE.NET.Helper;
namespace CUE.NET.Devices.Keyboard.Brushes.Gradient namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
{ {
/// <summary>
/// Represents a rainbow gradient which circles through all color colors of the HUE-color-space.<br />
/// See <see cref="http://upload.wikimedia.org/wikipedia/commons/a/ad/HueScale.svg" /> as reference
/// </summary>
public class RainbowGradient : IGradient public class RainbowGradient : IGradient
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the hue (in degrees) to start from.
/// </summary>
public float StartHue { get; set; } public float StartHue { get; set; }
/// <summary>
/// Gets or sets the hue (in degrees) to end the with.
/// </summary>
public float EndHue { get; set; } public float EndHue { get; set; }
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="RainbowGradient"/> class.
/// </summary>
/// <param name="startHue">The hue (in degrees) to start from (default: 0)</param>
/// <param name="endHue">The hue (in degrees) to end with (default: 360)</param>
public RainbowGradient(float startHue = 0f, float endHue = 360f) public RainbowGradient(float startHue = 0f, float endHue = 360f)
{ {
this.StartHue = startHue; this.StartHue = startHue;
@ -28,6 +44,11 @@ namespace CUE.NET.Devices.Keyboard.Brushes.Gradient
#endregion #endregion
/// <summary>
/// Gets the color on the rainbow at the given offset.
/// </summary>
/// <param name="offset">The percentage offset to take the color from.</param>
/// <returns>The color at the specific offset.</returns>
public Color GetColor(float offset) public Color GetColor(float offset)
{ {
float range = EndHue - StartHue; float range = EndHue - StartHue;

View File

@ -2,11 +2,27 @@ using System.Drawing;
namespace CUE.NET.Devices.Keyboard.Brushes namespace CUE.NET.Devices.Keyboard.Brushes
{ {
/// <summary>
/// Represents a basic brush.
/// </summary>
public interface IBrush public interface IBrush
{ {
/// <summary>
/// Gets or sets the overall percentage brightness of the brush.
/// </summary>
float Brightness { get; set; } float Brightness { get; set; }
/// <summary>
/// Gets or sets the overall percentage opacity of the brush.
/// </summary>
float Opacity { get; set; } float Opacity { get; set; }
/// <summary>
/// Gets the color at an specific point assuming the brush is drawn into the given rectangle.
/// </summary>
/// <param name="rectangle">The rectangle in which the brush should be drawn.</param>
/// <param name="point">The point from which the color should be taken.</param>
/// <returns>The color at the specified point.</returns>
Color GetColorAtPoint(RectangleF rectangle, PointF point); Color GetColorAtPoint(RectangleF rectangle, PointF point);
} }
} }

View File

@ -9,26 +9,52 @@ using CUE.NET.Helper;
namespace CUE.NET.Devices.Keyboard.Brushes namespace CUE.NET.Devices.Keyboard.Brushes
{ {
/// <summary>
/// Represents a brush drawing a linear gradient.
/// </summary>
public class LinearGradientBrush : AbstractBrush public class LinearGradientBrush : AbstractBrush
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the start point (as percentage in the range [0..1]) of the gradient drawn by the brush. (default: 0f, 0.5f)
/// </summary>
public PointF StartPoint { get; set; } = new PointF(0f, 0.5f); public PointF StartPoint { get; set; } = new PointF(0f, 0.5f);
/// <summary>
/// Gets or sets the end point (as percentage in the range [0..1]) of the gradient drawn by the brush. (default: 1f, 0.5f)
/// </summary>
public PointF EndPoint { get; set; } = new PointF(1f, 0.5f); public PointF EndPoint { get; set; } = new PointF(1f, 0.5f);
/// <summary>
/// Gets or sets the gradient drawn by the brush. If null it will default to full transparent.
/// </summary>
public IGradient Gradient { get; set; } public IGradient Gradient { get; set; }
#endregion #endregion
#region Constructor #region Constructor
/// <summary>
/// Initializes a new instance of the <see cref="LinearGradientBrush"/> class.
/// </summary>
public LinearGradientBrush() public LinearGradientBrush()
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="LinearGradientBrush"/> class.
/// </summary>
/// <param name="gradient">The gradient drawn by the brush.</param>
public LinearGradientBrush(IGradient gradient) public LinearGradientBrush(IGradient gradient)
{ {
this.Gradient = gradient; this.Gradient = gradient;
} }
/// <summary>
/// Initializes a new instance of the <see cref="LinearGradientBrush"/> class.
/// </summary>
/// <param name="startPoint">The start point (as percentage in the range [0..1]).</param>
/// <param name="endPoint">The end point (as percentage in the range [0..1]).</param>
/// <param name="gradient">The gradient drawn by the brush.</param>
public LinearGradientBrush(PointF startPoint, PointF endPoint, IGradient gradient) public LinearGradientBrush(PointF startPoint, PointF endPoint, IGradient gradient)
{ {
this.StartPoint = startPoint; this.StartPoint = startPoint;
@ -40,6 +66,12 @@ namespace CUE.NET.Devices.Keyboard.Brushes
#region Methods #region Methods
/// <summary>
/// Gets the color at an specific point assuming the brush is drawn into the given rectangle.
/// </summary>
/// <param name="rectangle">The rectangle in which the brush should be drawn.</param>
/// <param name="point">The point from which the color should be taken.</param>
/// <returns>The color at the specified point.</returns>
public override Color GetColorAtPoint(RectangleF rectangle, PointF point) public override Color GetColorAtPoint(RectangleF rectangle, PointF point)
{ {
if (Gradient == null) return Color.Transparent; if (Gradient == null) return Color.Transparent;

View File

@ -8,25 +8,47 @@ using CUE.NET.Helper;
namespace CUE.NET.Devices.Keyboard.Brushes namespace CUE.NET.Devices.Keyboard.Brushes
{ {
/// <summary>
/// Represents a brush drawing a radial gradient around a center point.
/// </summary>
public class RadialGradientBrush : AbstractBrush public class RadialGradientBrush : AbstractBrush
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the center point (as percentage in the range [0..1]) around which the brush should be drawn.
/// </summary>
public PointF Center { get; set; } = new PointF(0.5f, 0.5f); public PointF Center { get; set; } = new PointF(0.5f, 0.5f);
/// <summary>
/// Gets or sets the gradient drawn by the brush. If null it will default to full transparent.
/// </summary>
public IGradient Gradient { get; set; } public IGradient Gradient { get; set; }
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="RadialGradientBrush"/> class.
/// </summary>
public RadialGradientBrush() public RadialGradientBrush()
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="RadialGradientBrush"/> class.
/// </summary>
/// <param name="gradient">The gradient drawn by the brush.</param>
public RadialGradientBrush(IGradient gradient) public RadialGradientBrush(IGradient gradient)
{ {
this.Gradient = gradient; this.Gradient = gradient;
} }
/// <summary>
/// Initializes a new instance of the <see cref="RadialGradientBrush"/> class.
/// </summary>
/// <param name="center">The center point (as percentage in the range [0..1]).</param>
/// <param name="gradient">The gradient drawn by the brush.</param>
public RadialGradientBrush(PointF center, IGradient gradient) public RadialGradientBrush(PointF center, IGradient gradient)
{ {
this.Center = center; this.Center = center;
@ -37,6 +59,12 @@ namespace CUE.NET.Devices.Keyboard.Brushes
#region Methods #region Methods
/// <summary>
/// Gets the color at an specific point assuming the brush is drawn into the given rectangle.
/// </summary>
/// <param name="rectangle">The rectangle in which the brush should be drawn.</param>
/// <param name="point">The point from which the color should be taken.</param>
/// <returns>The color at the specified point.</returns>
public override Color GetColorAtPoint(RectangleF rectangle, PointF point) public override Color GetColorAtPoint(RectangleF rectangle, PointF point)
{ {
PointF centerPoint = new PointF(rectangle.X + rectangle.Width * Center.X, rectangle.Y + rectangle.Height * Center.Y); PointF centerPoint = new PointF(rectangle.X + rectangle.Width * Center.X, rectangle.Y + rectangle.Height * Center.Y);

View File

@ -5,6 +5,10 @@ using CUE.NET.Helper;
namespace CUE.NET.Devices.Keyboard.Brushes namespace CUE.NET.Devices.Keyboard.Brushes
{ {
//TODO DarthAffe 30.09.2015: Like this the brush seems kinda useless. Think about making it cool. //TODO DarthAffe 30.09.2015: Like this the brush seems kinda useless. Think about making it cool.
/// <summary>
/// Represents a brush drawing random colors.
/// </summary>
public class RandomColorBrush : AbstractBrush public class RandomColorBrush : AbstractBrush
{ {
#region Properties & Fields #region Properties & Fields
@ -15,6 +19,12 @@ namespace CUE.NET.Devices.Keyboard.Brushes
#region Methods #region Methods
/// <summary>
/// Gets a random color.
/// </summary>
/// <param name="rectangle">This value isn't used.</param>
/// <param name="point">This value isn't used.</param>
/// <returns>A random color.</returns>
public override Color GetColorAtPoint(RectangleF rectangle, PointF point) public override Color GetColorAtPoint(RectangleF rectangle, PointF point)
{ {
return FinalizeColor(ColorHelper.ColorFromHSV((float)_random.NextDouble() * 360f, 1, 1)); return FinalizeColor(ColorHelper.ColorFromHSV((float)_random.NextDouble() * 360f, 1, 1));

View File

@ -1,19 +1,30 @@
// ReSharper disable MemberCanBePrivate.Global // ReSharper disable MemberCanBePrivate.Global
// ReSharper disable AutoPropertyCanBeMadeGetOnly.Global
using System.Drawing; using System.Drawing;
namespace CUE.NET.Devices.Keyboard.Brushes namespace CUE.NET.Devices.Keyboard.Brushes
{ {
/// <summary>
/// Represents a brush drawing only a single color.
/// </summary>
public class SolidColorBrush : AbstractBrush public class SolidColorBrush : AbstractBrush
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the color drawn by the brush.
/// </summary>
public Color Color { get; set; } public Color Color { get; set; }
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="SolidColorBrush"/> class.
/// </summary>
/// <param name="color">The color drawn by the brush.</param>
public SolidColorBrush(Color color) public SolidColorBrush(Color color)
{ {
this.Color = color; this.Color = color;
@ -23,6 +34,12 @@ namespace CUE.NET.Devices.Keyboard.Brushes
#region Methods #region Methods
/// <summary>
/// Returns the <see cref="Color" /> of the brush.
/// </summary>
/// <param name="rectangle">This value isn't used.</param>
/// <param name="point">This value isn't used.</param>
/// <returns>The <see cref="Color" /> of the brush.</returns>
public override Color GetColorAtPoint(RectangleF rectangle, PointF point) public override Color GetColorAtPoint(RectangleF rectangle, PointF point)
{ {
return FinalizeColor(Color); return FinalizeColor(Color);

View File

@ -19,12 +19,20 @@ using CUE.NET.Native;
namespace CUE.NET.Devices.Keyboard namespace CUE.NET.Devices.Keyboard
{ {
/// <summary>
/// Represents the SDK for a corsair keyboard.
/// </summary>
public class CorsairKeyboard : AbstractCueDevice, IEnumerable<CorsairKey>, IKeyGroup public class CorsairKeyboard : AbstractCueDevice, IEnumerable<CorsairKey>, IKeyGroup
{ {
#region Properties & Fields #region Properties & Fields
#region Indexer #region Indexer
/// <summary>
/// Gets the <see cref="CorsairKey" /> with the specified ID.
/// </summary>
/// <param name="keyId">The ID of the key to get.</param>
/// <returns>The key with the specified ID or null if no key is found.</returns>
public CorsairKey this[CorsairKeyboardKeyId keyId] public CorsairKey this[CorsairKeyboardKeyId keyId]
{ {
get get
@ -34,10 +42,35 @@ namespace CUE.NET.Devices.Keyboard
} }
} }
public CorsairKey this[char key] => this[_CUESDK.CorsairGetLedIdForKeyName(key)]; /// <summary>
/// Gets the <see cref="CorsairKey" /> representing the given character by calling the SDK-method 'CorsairGetLedIdForKeyName'.<br />
/// Note that this currently only works for letters.
/// </summary>
/// <param name="key">The character of the key.</param>
/// <returns>The key representing the given character or null if no key is found.</returns>
public CorsairKey this[char key]
{
get
{
CorsairKeyboardKeyId keyId = _CUESDK.CorsairGetLedIdForKeyName(key);
CorsairKey cKey;
return _keys.TryGetValue(keyId, out cKey) ? cKey : null;
}
}
/// <summary>
/// Gets the <see cref="CorsairKey" /> at the given physical location.
/// </summary>
/// <param name="location">The point to get the key from.</param>
/// <returns>The key at the given point or null if no key is found.</returns>
public CorsairKey this[PointF location] => _keys.Values.FirstOrDefault(x => x.KeyRectangle.Contains(location)); public CorsairKey this[PointF location] => _keys.Values.FirstOrDefault(x => x.KeyRectangle.Contains(location));
/// <summary>
/// Gets a list of <see cref="CorsairKey" /> inside the given rectangle.
/// </summary>
/// <param name="referenceRect">The rectangle to check.</param>
/// <param name="minOverlayPercentage">The minimal percentage overlay a key must have with the <see cref="Rectangle" /> to be taken into the list.</param>
/// <returns></returns>
public IEnumerable<CorsairKey> this[RectangleF referenceRect, float minOverlayPercentage = 0.5f] => _keys.Values.Where(x => RectangleHelper.CalculateIntersectPercentage(x.KeyRectangle, referenceRect) >= minOverlayPercentage); public IEnumerable<CorsairKey> this[RectangleF referenceRect, float minOverlayPercentage = 0.5f] => _keys.Values.Where(x => RectangleHelper.CalculateIntersectPercentage(x.KeyRectangle, referenceRect) >= minOverlayPercentage);
#endregion #endregion
@ -46,13 +79,36 @@ namespace CUE.NET.Devices.Keyboard
private readonly LinkedList<EffectTimeContainer> _effects = new LinkedList<EffectTimeContainer>(); private readonly LinkedList<EffectTimeContainer> _effects = new LinkedList<EffectTimeContainer>();
private Dictionary<CorsairKeyboardKeyId, CorsairKey> _keys = new Dictionary<CorsairKeyboardKeyId, CorsairKey>(); private Dictionary<CorsairKeyboardKeyId, CorsairKey> _keys = new Dictionary<CorsairKeyboardKeyId, CorsairKey>();
/// <summary>
/// Gets a read-only collection containing the keys of the keyboard.
/// </summary>
public IEnumerable<CorsairKey> Keys => new ReadOnlyCollection<CorsairKey>(_keys.Values.ToList()); public IEnumerable<CorsairKey> Keys => new ReadOnlyCollection<CorsairKey>(_keys.Values.ToList());
/// <summary>
/// Gets specific information provided by CUE for the keyboard.
/// </summary>
public CorsairKeyboardDeviceInfo KeyboardDeviceInfo { get; } public CorsairKeyboardDeviceInfo KeyboardDeviceInfo { get; }
/// <summary>
/// Gets the rectangle containing all keys of the keyboard.
/// </summary>
public RectangleF KeyboardRectangle { get; private set; } public RectangleF KeyboardRectangle { get; private set; }
/// <summary>
/// Gets or sets the background brush of the keyboard.
/// </summary>
public IBrush Brush { get; set; } public IBrush Brush { get; set; }
/// <summary>
/// Gets or sets the z-index of the background brush of the keyboard.<br />
/// This value has absolutely no effect.
/// </summary>
public int ZIndex { get; set; } = 0; public int ZIndex { get; set; } = 0;
/// <summary>
/// Gets a value indicating if the keyboard has an active effect to deal with or not.
/// </summary>
protected override bool HasEffect protected override bool HasEffect
{ {
get get
@ -66,6 +122,10 @@ namespace CUE.NET.Devices.Keyboard
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="CorsairKeyboard"/> class.
/// </summary>
/// <param name="info">The specific information provided by CUE for the keyboard</param>
internal CorsairKeyboard(CorsairKeyboardDeviceInfo info) internal CorsairKeyboard(CorsairKeyboardDeviceInfo info)
: base(info) : base(info)
{ {
@ -81,6 +141,10 @@ namespace CUE.NET.Devices.Keyboard
#region Update #region Update
/// <summary>
/// Updates all groups and effects and perform an update for all dirty keys, or all keys if flushLeds is set to true.
/// </summary>
/// <param name="flushLeds">Specifies whether all keys (including clean ones) should be updated.</param>
public override void Update(bool flushLeds = false) public override void Update(bool flushLeds = false)
{ {
UpdateKeyGroups(); UpdateKeyGroups();
@ -153,6 +217,11 @@ namespace CUE.NET.Devices.Keyboard
#endregion #endregion
/// <summary>
/// Attaches the given keygroup.
/// </summary>
/// <param name="keyGroup">The keygroup to attach.</param>
/// <returns><c>true</c> if the keygroup could be attached; otherwise, <c>false</c>.</returns>
public bool AttachKeyGroup(IKeyGroup keyGroup) public bool AttachKeyGroup(IKeyGroup keyGroup)
{ {
lock (_keyGroups) lock (_keyGroups)
@ -164,6 +233,11 @@ namespace CUE.NET.Devices.Keyboard
} }
} }
/// <summary>
/// Detaches the given keygroup.
/// </summary>
/// <param name="keyGroup">The keygroup to detached.</param>
/// <returns><c>true</c> if the keygroup could be detached; otherwise, <c>false</c>.</returns>
public bool DetachKeyGroup(IKeyGroup keyGroup) public bool DetachKeyGroup(IKeyGroup keyGroup)
{ {
lock (_keyGroups) lock (_keyGroups)
@ -178,6 +252,11 @@ namespace CUE.NET.Devices.Keyboard
} }
} }
/// <summary>
/// Attaches the given effect.
/// </summary>
/// <param name="effect">The effect to attach.</param>
/// <returns><c>true</c> if the effect could be attached; otherwise, <c>false</c>.</returns>
public bool AttachEffect(IEffect effect) public bool AttachEffect(IEffect effect)
{ {
bool retVal = false; bool retVal = false;
@ -195,6 +274,11 @@ namespace CUE.NET.Devices.Keyboard
return retVal; return retVal;
} }
/// <summary>
/// Detaches the given effect.
/// </summary>
/// <param name="effect">The effect to detached.</param>
/// <returns><c>true</c> if the effect could be detached; otherwise, <c>false</c>.</returns>
public bool DetachEffect(IEffect effect) public bool DetachEffect(IEffect effect)
{ {
bool retVal = false; bool retVal = false;
@ -233,6 +317,10 @@ namespace CUE.NET.Devices.Keyboard
#region IEnumerable #region IEnumerable
/// <summary>
/// Returns an enumerator that iterates over all keys of the keyboard.
/// </summary>
/// <returns>An enumerator for all keys of the keyboard.</returns>
public IEnumerator<CorsairKey> GetEnumerator() public IEnumerator<CorsairKey> GetEnumerator()
{ {
return _keys.Values.GetEnumerator(); return _keys.Values.GetEnumerator();

View File

@ -7,17 +7,20 @@ using CUE.NET.Native;
namespace CUE.NET.Devices.Keyboard namespace CUE.NET.Devices.Keyboard
{ {
/// <summary>
/// Represents specific information for a CUE keyboard.
/// </summary>
public class CorsairKeyboardDeviceInfo : GenericDeviceInfo public class CorsairKeyboardDeviceInfo : GenericDeviceInfo
{ {
#region Properties & Fields #region Properties & Fields
/// <summary> /// <summary>
/// Physical layout of the keyboard. /// Gets the physical layout of the keyboard.
/// </summary> /// </summary>
public CorsairPhysicalKeyboardLayout PhysicalLayout { get; private set; } public CorsairPhysicalKeyboardLayout PhysicalLayout { get; private set; }
/// <summary> /// <summary>
/// Logical layout of the keyboard as set in CUE settings. /// Gets the logical layout of the keyboard as set in CUE settings.
/// </summary> /// </summary>
public CorsairLogicalKeyboardLayout LogicalLayout { get; private set; } public CorsairLogicalKeyboardLayout LogicalLayout { get; private set; }

View File

@ -7,32 +7,61 @@ using CUE.NET.Devices.Keyboard.Keys;
namespace CUE.NET.Devices.Keyboard.Effects namespace CUE.NET.Devices.Keyboard.Effects
{ {
/// <summary>
/// Represents a basic effect.
/// </summary>
public abstract class AbstractEffect : IEffect public abstract class AbstractEffect : IEffect
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the list of keys to which the effect applies.
/// </summary>
public IEnumerable<CorsairKey> KeyList { get; protected set; } public IEnumerable<CorsairKey> KeyList { get; protected set; }
/// <summary>
/// Gets the brush which is drawn by the effect.
/// </summary>
public abstract IBrush EffectBrush { get; } public abstract IBrush EffectBrush { get; }
/// <summary>
/// Gets or sets the z-index of the brush to allow ordering them before drawing. (lowest first) (default: 0)
/// </summary>
public int ZIndex { get; set; } = 0; public int ZIndex { get; set; } = 0;
/// <summary>
/// Gets or sets if this effect has finished all of his work.
/// </summary>
public bool IsDone { get; protected set; } public bool IsDone { get; protected set; }
#endregion #endregion
#region Methods #region Methods
/// <summary>
/// Sets the list of keys to which the effect applies.
/// </summary>
/// <param name="keyGroup"></param>
public void SetTarget(IKeyGroup keyGroup) public void SetTarget(IKeyGroup keyGroup)
{ {
KeyList = keyGroup.Keys.ToList(); KeyList = keyGroup.Keys.ToList();
} }
/// <summary>
/// Updates the effect.
/// </summary>
/// <param name="deltaTime">The elapsed time (in seconds) since the last update.</param>
public abstract void Update(float deltaTime); public abstract void Update(float deltaTime);
/// <summary>
/// Hook which is called when the effect is attached to a keyboard.
/// </summary>
public virtual void OnAttach() public virtual void OnAttach()
{ } { }
/// <summary>
/// Hook which is called when the effect is detached from a keyboard.
/// </summary>
public virtual void OnDetach() public virtual void OnDetach()
{ } { }

View File

@ -3,20 +3,37 @@
namespace CUE.NET.Devices.Keyboard.Effects namespace CUE.NET.Devices.Keyboard.Effects
{ {
/// <summary>
/// Represents a wrapped effect with additional time information.
/// </summary>
internal class EffectTimeContainer internal class EffectTimeContainer
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the wrapped effect.
/// </summary>
internal IEffect Effect { get; set; } internal IEffect Effect { get; set; }
/// <summary>
/// Gets or sets the tick-count from the last time the effect was updated.
/// </summary>
internal long TicksAtLastUpdate { get; set; } internal long TicksAtLastUpdate { get; set; }
/// <summary>
/// Gets the z-index of the effect.
/// </summary>
internal int ZIndex => Effect?.ZIndex ?? 0; internal int ZIndex => Effect?.ZIndex ?? 0;
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="EffectTimeContainer"/> class.
/// </summary>
/// <param name="effect">The wrapped effect.</param>
/// <param name="ticksAtLastUpdate">The tick-count from the last time the effect was updated.</param>
internal EffectTimeContainer(IEffect effect, long ticksAtLastUpdate) internal EffectTimeContainer(IEffect effect, long ticksAtLastUpdate)
{ {
this.Effect = effect; this.Effect = effect;

View File

@ -7,23 +7,61 @@ using CUE.NET.Devices.Keyboard.Brushes;
namespace CUE.NET.Devices.Keyboard.Effects namespace CUE.NET.Devices.Keyboard.Effects
{ {
/// <summary>
/// Represents an effect which allows to flash an brush by modifying his opacity.
/// </summary>
public class FlashEffect : AbstractEffect public class FlashEffect : AbstractEffect
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets the brush which is drawn by the effect.
/// </summary>
public override IBrush EffectBrush { get; } public override IBrush EffectBrush { get; }
// Settings are close to a synthesizer envelope (sustain is different for consequent naming): https://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope /// <summary>
/// Gets or sets the attack-time (in seconds) of the effect. (default: 0.2f)<br />
/// This is close to a synthesizer envelope. (See <see cref="http://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope" /> as reference)
/// </summary>
public float Attack { get; set; } = 0.2f; public float Attack { get; set; } = 0.2f;
/// <summary>
/// Gets or sets the decay-time (in seconds) of the effect. (default: 0f)<br />
/// This is close to a synthesizer envelope. (See <see cref="http://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope" /> as reference)
/// </summary>
public float Decay { get; set; } = 0f; public float Decay { get; set; } = 0f;
/// <summary>
/// Gets or sets the sustain-time (in seconds) of the effect. (default: 0.3f)<br />
/// This is close to a synthesizer envelope. (See <see cref="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 float Sustain { get; set; } = 0.3f; public float Sustain { get; set; } = 0.3f;
/// <summary>
/// Gets or sets the release-time (in seconds) of the effect. (default: 0.2f)<br />
/// This is close to a synthesizer envelope. (See <see cref="http://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope" /> as reference)
/// </summary>
public float Release { get; set; } = 0.2f; public float Release { get; set; } = 0.2f;
public float SustainValue { get; set; } = 1f; /// <summary>
/// Gets or sets the level to which the oppacity (percentage) should raise in the attack-cycle. (default: 1f);
/// </summary>
public float AttackValue { get; set; } = 1f; public float AttackValue { get; set; } = 1f;
/// <summary>
/// Gets or sets the level at which the oppacity (percentage) should stay in the sustain-cycle. (default: 1f);
/// </summary>
public float SustainValue { get; set; } = 1f;
/// <summary>
/// Gets or sets the interval (in seconds) in which the effect should repeat (if repetition is enabled). (default: 1f)
/// </summary>
public float Interval { get; set; } = 1f; public float Interval { get; set; } = 1f;
/// <summary>
/// Gets or sets the amount of repetitions the effect should do until it's finished. Zero means infinite. (default: 0f)
/// </summary>
public int Repetitions { get; set; } = 0; public int Repetitions { get; set; } = 0;
private ADSRPhase _currentPhase; private ADSRPhase _currentPhase;
@ -34,10 +72,18 @@ namespace CUE.NET.Devices.Keyboard.Effects
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="FlashEffect"/> class.
/// </summary>
/// <param name="flashColor">The color from which a <see cref="SolidColorBrush" /> should be created and used by this effect.</param>
public FlashEffect(Color flashColor) public FlashEffect(Color flashColor)
: this(new SolidColorBrush(flashColor)) : this(new SolidColorBrush(flashColor))
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="FlashEffect"/> class.
/// </summary>
/// <param name="effectBrush">The brush which should be used by this effect,</param>
public FlashEffect(IBrush effectBrush) public FlashEffect(IBrush effectBrush)
{ {
this.EffectBrush = effectBrush; this.EffectBrush = effectBrush;
@ -47,6 +93,10 @@ namespace CUE.NET.Devices.Keyboard.Effects
#region Methods #region Methods
/// <summary>
/// Updates the effect.
/// </summary>
/// <param name="deltaTime">The elapsed time (in seconds) since the last update.</param>
public override void Update(float deltaTime) public override void Update(float deltaTime)
{ {
_currentPhaseValue -= deltaTime; _currentPhaseValue -= deltaTime;
@ -101,6 +151,9 @@ namespace CUE.NET.Devices.Keyboard.Effects
} }
} }
/// <summary>
/// Resets the effect.
/// </summary>
public override void OnAttach() public override void OnAttach()
{ {
base.OnAttach(); base.OnAttach();

View File

@ -4,26 +4,51 @@ using CUE.NET.Devices.Keyboard.Keys;
namespace CUE.NET.Devices.Keyboard.Effects namespace CUE.NET.Devices.Keyboard.Effects
{ {
/// <summary>
/// Represents a basic effect.
/// </summary>
public interface IEffect public interface IEffect
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the list of keys to which the effect applies.
/// </summary>
IEnumerable<CorsairKey> KeyList { get; } IEnumerable<CorsairKey> KeyList { get; }
/// <summary>
/// Gets the brush which is drawn by the effect.
/// </summary>
IBrush EffectBrush { get; } IBrush EffectBrush { get; }
/// <summary>
/// Gets or sets the z-index of the effect to allow ordering them before drawing. (lowest first) (default: 0)
/// </summary>
int ZIndex { get; set; } int ZIndex { get; set; }
/// <summary>
/// Gets or sets if this effect has finished all of his work.
/// </summary>
bool IsDone { get; } bool IsDone { get; }
#endregion #endregion
#region Methods #region Methods
/// <summary>
/// Updates the effect.
/// </summary>
/// <param name="deltaTime">The elapsed time (in seconds) since the last update.</param>
void Update(float deltaTime); void Update(float deltaTime);
/// <summary>
/// Hook which is called when the effect is attached to a keyboard.
/// </summary>
void OnAttach(); void OnAttach();
/// <summary>
/// Hook which is called when the effect is detached from a keyboard.
/// </summary>
void OnDetach(); void OnDetach();
#endregion #endregion

View File

@ -3,6 +3,9 @@
namespace CUE.NET.Devices.Keyboard.Enums namespace CUE.NET.Devices.Keyboard.Enums
{ {
/// <summary>
/// Contains list of all LEDs available for corsair keyboards.
/// </summary>
public enum CorsairKeyboardKeyId public enum CorsairKeyboardKeyId
{ {
Invalid = 0, Invalid = 0,

View File

@ -6,8 +6,16 @@ using CUE.NET.Devices.Keyboard.Keys;
namespace CUE.NET.Devices.Keyboard.Extensions namespace CUE.NET.Devices.Keyboard.Extensions
{ {
/// <summary>
/// Offers some extensions and helper-methods for keygroup related things.
/// </summary>
public static class KeyGroupExtension public static class KeyGroupExtension
{ {
/// <summary>
/// Converts the given <see cref="BaseKeyGroup" /> to a <see cref="ListKeyGroup" />.
/// </summary>
/// <param name="keyGroup">The <see cref="BaseKeyGroup" /> to convert.</param>
/// <returns>The converted <see cref="ListKeyGroup" />.</returns>
public static ListKeyGroup ToSimpleKeyGroup(this BaseKeyGroup keyGroup) public static ListKeyGroup ToSimpleKeyGroup(this BaseKeyGroup keyGroup)
{ {
ListKeyGroup simpleKeyGroup = keyGroup as ListKeyGroup; ListKeyGroup simpleKeyGroup = keyGroup as ListKeyGroup;
@ -19,6 +27,12 @@ namespace CUE.NET.Devices.Keyboard.Extensions
return simpleKeyGroup; return simpleKeyGroup;
} }
/// <summary>
/// Returns a new <see cref="ListKeyGroup" /> which contains all keys from the given keygroup excluding the specified ones.
/// </summary>
/// <param name="keyGroup">The base keygroup.</param>
/// <param name="keyIds">The ids of the keys to exclude.</param>
/// <returns>The new <see cref="ListKeyGroup" />.</returns>
public static ListKeyGroup Exclude(this BaseKeyGroup keyGroup, params CorsairKeyboardKeyId[] keyIds) public static ListKeyGroup Exclude(this BaseKeyGroup keyGroup, params CorsairKeyboardKeyId[] keyIds)
{ {
ListKeyGroup simpleKeyGroup = keyGroup.ToSimpleKeyGroup(); ListKeyGroup simpleKeyGroup = keyGroup.ToSimpleKeyGroup();
@ -27,6 +41,12 @@ namespace CUE.NET.Devices.Keyboard.Extensions
return simpleKeyGroup; return simpleKeyGroup;
} }
/// <summary>
/// Returns a new <see cref="ListKeyGroup" /> which contains all keys from the given keygroup excluding the specified ones.
/// </summary>
/// <param name="keyGroup">The base keygroup.</param>
/// <param name="keyIds">The keys to exclude.</param>
/// <returns>The new <see cref="ListKeyGroup" />.</returns>
public static ListKeyGroup Exclude(this BaseKeyGroup keyGroup, params CorsairKey[] keyIds) public static ListKeyGroup Exclude(this BaseKeyGroup keyGroup, params CorsairKey[] keyIds)
{ {
ListKeyGroup simpleKeyGroup = keyGroup.ToSimpleKeyGroup(); ListKeyGroup simpleKeyGroup = keyGroup.ToSimpleKeyGroup();
@ -36,11 +56,21 @@ namespace CUE.NET.Devices.Keyboard.Extensions
} }
// ReSharper disable once UnusedMethodReturnValue.Global // ReSharper disable once UnusedMethodReturnValue.Global
/// <summary>
/// Attaches the given keygroup to the keyboard.
/// </summary>
/// <param name="keyGroup">The keygroup to attach.</param>
/// <returns><c>true</c> if the keygroup could be attached; otherwise, <c>false</c>.</returns>
public static bool Attach(this BaseKeyGroup keyGroup) public static bool Attach(this BaseKeyGroup keyGroup)
{ {
return keyGroup.Keyboard?.AttachKeyGroup(keyGroup) ?? false; return keyGroup.Keyboard?.AttachKeyGroup(keyGroup) ?? false;
} }
/// <summary>
/// Detaches the given keygroup from the keyboard.
/// </summary>
/// <param name="keyGroup">The keygroup to attach.</param>
/// <returns><c>true</c> if the keygroup could be detached; otherwise, <c>false</c>.</returns>
public static bool Detach(this BaseKeyGroup keyGroup) public static bool Detach(this BaseKeyGroup keyGroup)
{ {
return keyGroup.Keyboard?.DetachKeyGroup(keyGroup) ?? false; return keyGroup.Keyboard?.DetachKeyGroup(keyGroup) ?? false;

View File

@ -5,22 +5,42 @@ using CUE.NET.Devices.Keyboard.Extensions;
namespace CUE.NET.Devices.Keyboard.Keys namespace CUE.NET.Devices.Keyboard.Keys
{ {
/// <summary>
/// Represents a basic keygroup.
/// </summary>
public abstract class BaseKeyGroup : IKeyGroup public abstract class BaseKeyGroup : IKeyGroup
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets the keyboard this keygroup belongs to.
/// </summary>
internal CorsairKeyboard Keyboard { get; } internal CorsairKeyboard Keyboard { get; }
/// <summary>
/// Gets a read-only collection containing the keys from this group.
/// </summary>
public IEnumerable<CorsairKey> Keys => new ReadOnlyCollection<CorsairKey>(GetGroupKeys()); public IEnumerable<CorsairKey> Keys => new ReadOnlyCollection<CorsairKey>(GetGroupKeys());
/// <summary>
/// Gets or sets the brush which should be drawn over this group.
/// </summary>
public IBrush Brush { get; set; } public IBrush Brush { get; set; }
/// <summary>
/// Gets or sets the z-index of this keygroup to allow ordering them before drawing. (lowest first) (default: 0)
/// </summary>
public int ZIndex { get; set; } = 0; public int ZIndex { get; set; } = 0;
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="BaseKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="autoAttach">Specifies whether this group should be automatically attached or not.</param>
protected BaseKeyGroup(CorsairKeyboard keyboard, bool autoAttach = true) protected BaseKeyGroup(CorsairKeyboard keyboard, bool autoAttach = true)
{ {
this.Keyboard = keyboard; this.Keyboard = keyboard;
@ -29,6 +49,10 @@ namespace CUE.NET.Devices.Keyboard.Keys
this.Attach(); this.Attach();
} }
/// <summary>
/// Gets a list containing the keys from this group.
/// </summary>
/// <returns>The list containing the keys.</returns>
protected abstract IList<CorsairKey> GetGroupKeys(); protected abstract IList<CorsairKey> GetGroupKeys();
#endregion #endregion

View File

@ -7,18 +7,38 @@ using CUE.NET.Devices.Keyboard.Enums;
namespace CUE.NET.Devices.Keyboard.Keys namespace CUE.NET.Devices.Keyboard.Keys
{ {
/// <summary>
/// Represents a key of a corsair keyboard.
/// </summary>
public class CorsairKey public class CorsairKey
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets the key-ID of the key.
/// </summary>
public CorsairKeyboardKeyId KeyId { get; } public CorsairKeyboardKeyId KeyId { get; }
/// <summary>
/// Gets the LED of the key.
/// </summary>
public CorsairLed Led { get; } public CorsairLed Led { get; }
/// <summary>
/// Gets a rectangle representing the physical location of the key.
/// </summary>
public RectangleF KeyRectangle { get; } public RectangleF KeyRectangle { get; }
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="CorsairKey"/> class.
/// </summary>
/// <param name="keyId">The key-ID of the key.</param>
/// <param name="led">The LED of the key.</param>
/// <param name="keyRectangle">The rectangle representing the physical location of the key.</param>
internal CorsairKey(CorsairKeyboardKeyId keyId, CorsairLed led, RectangleF keyRectangle) internal CorsairKey(CorsairKeyboardKeyId keyId, CorsairLed led, RectangleF keyRectangle)
{ {
this.KeyId = keyId; this.KeyId = keyId;
@ -27,9 +47,5 @@ namespace CUE.NET.Devices.Keyboard.Keys
} }
#endregion #endregion
#region Methods
#endregion
} }
} }

View File

@ -5,10 +5,19 @@ namespace CUE.NET.Devices.Keyboard.Keys
{ {
public interface IKeyGroup public interface IKeyGroup
{ {
/// <summary>
/// Gets a read-only collection containing the keys from this group.
/// </summary>
IEnumerable<CorsairKey> Keys { get; } IEnumerable<CorsairKey> Keys { get; }
/// <summary>
/// Gets or sets the brush which should be drawn over this group.
/// </summary>
IBrush Brush { get; set; } IBrush Brush { get; set; }
/// <summary>
/// Gets or sets the z-index of this keygroup to allow ordering them before drawing. (lowest first) (default: 0)
/// </summary>
int ZIndex { get; set; } int ZIndex { get; set; }
} }
} }

View File

@ -5,34 +5,67 @@ using CUE.NET.Devices.Keyboard.Enums;
namespace CUE.NET.Devices.Keyboard.Keys namespace CUE.NET.Devices.Keyboard.Keys
{ {
/// <summary>
/// Represents a keygroup containing arbitrary keys.
/// </summary>
public class ListKeyGroup : BaseKeyGroup public class ListKeyGroup : BaseKeyGroup
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets the list containing the keys of this keygroup.
/// </summary>
protected IList<CorsairKey> GroupKeys { get; } = new List<CorsairKey>(); protected IList<CorsairKey> GroupKeys { get; } = new List<CorsairKey>();
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="ListKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="autoAttach">Specifies whether this keygroup should be automatically attached or not.</param>
public ListKeyGroup(CorsairKeyboard keyboard, bool autoAttach = true) public ListKeyGroup(CorsairKeyboard keyboard, bool autoAttach = true)
: base(keyboard, autoAttach) : base(keyboard, autoAttach)
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="ListKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="keys">The initial keys of this keygroup.</param>
public ListKeyGroup(CorsairKeyboard keyboard, params CorsairKey[] keys) public ListKeyGroup(CorsairKeyboard keyboard, params CorsairKey[] keys)
: this(keyboard, true, keys) : this(keyboard, true, keys)
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="ListKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="autoAttach">Specifies whether this keygroup should be automatically attached or not.</param>
/// <param name="keys">The initial keys of this keygroup.</param>
public ListKeyGroup(CorsairKeyboard keyboard, bool autoAttach, params CorsairKey[] keys) public ListKeyGroup(CorsairKeyboard keyboard, bool autoAttach, params CorsairKey[] keys)
: base(keyboard, autoAttach) : base(keyboard, autoAttach)
{ {
AddKey(keys); AddKey(keys);
} }
/// <summary>
/// Initializes a new instance of the <see cref="ListKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="keys">The IDs of the initial keys of this keygroup.</param>
public ListKeyGroup(CorsairKeyboard keyboard, params CorsairKeyboardKeyId[] keys) public ListKeyGroup(CorsairKeyboard keyboard, params CorsairKeyboardKeyId[] keys)
: this(keyboard, true, keys) : this(keyboard, true, keys)
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="ListKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="autoAttach">Specifies whether this keygroup should be automatically attached or not.</param>
/// <param name="keys">The IDs of the initial keys of this keygroup.</param>
public ListKeyGroup(CorsairKeyboard keyboard, bool autoAttach, params CorsairKeyboardKeyId[] keys) public ListKeyGroup(CorsairKeyboard keyboard, bool autoAttach, params CorsairKeyboardKeyId[] keys)
: base(keyboard, autoAttach) : base(keyboard, autoAttach)
{ {
@ -43,6 +76,10 @@ namespace CUE.NET.Devices.Keyboard.Keys
#region Methods #region Methods
/// <summary>
/// Adds the given key(s) to the keygroup.
/// </summary>
/// <param name="keys">The key(s) to add.</param>
public void AddKey(params CorsairKey[] keys) public void AddKey(params CorsairKey[] keys)
{ {
if (keys != null) if (keys != null)
@ -52,6 +89,10 @@ namespace CUE.NET.Devices.Keyboard.Keys
} }
/// <summary>
/// Adds the given key(s) to the keygroup.
/// </summary>
/// <param name="keyIds">The ID(s) of the key(s) to add.</param>
public void AddKey(params CorsairKeyboardKeyId[] keyIds) public void AddKey(params CorsairKeyboardKeyId[] keyIds)
{ {
if (keyIds != null) if (keyIds != null)
@ -59,6 +100,10 @@ namespace CUE.NET.Devices.Keyboard.Keys
AddKey(Keyboard[keyId]); AddKey(Keyboard[keyId]);
} }
/// <summary>
/// Removes the given key(s) from the keygroup.
/// </summary>
/// <param name="keys">The key(s) to remove.</param>
public void RemoveKey(params CorsairKey[] keys) public void RemoveKey(params CorsairKey[] keys)
{ {
if (keys != null) if (keys != null)
@ -67,6 +112,10 @@ namespace CUE.NET.Devices.Keyboard.Keys
GroupKeys.Remove(key); GroupKeys.Remove(key);
} }
/// <summary>
/// Removes the given key(s) from the keygroup.
/// </summary>
/// <param name="keyIds">The ID(s) of the key(s) to remove.</param>
public void RemoveKey(params CorsairKeyboardKeyId[] keyIds) public void RemoveKey(params CorsairKeyboardKeyId[] keyIds)
{ {
if (keyIds != null) if (keyIds != null)
@ -74,16 +123,30 @@ namespace CUE.NET.Devices.Keyboard.Keys
RemoveKey(Keyboard[keyId]); RemoveKey(Keyboard[keyId]);
} }
/// <summary>
/// Checks if a given key is contained by this keygroup.
/// </summary>
/// <param name="key">The key which should be checked.</param>
/// <returns><c>true</c> if the key is contained by this keygroup; otherwise, <c>false</c>.</returns>
public bool ContainsKey(CorsairKey key) public bool ContainsKey(CorsairKey key)
{ {
return key != null && GroupKeys.Contains(key); return key != null && GroupKeys.Contains(key);
} }
/// <summary>
/// Checks if a given key is contained by this keygroup.
/// </summary>
/// <param name="keyId">The ID of the key which should be checked.</param>
/// <returns><c>true</c> if the key is contained by this keygroup; otherwise, <c>false</c>.</returns>
public bool ContainsKey(CorsairKeyboardKeyId keyId) public bool ContainsKey(CorsairKeyboardKeyId keyId)
{ {
return ContainsKey(Keyboard[keyId]); return ContainsKey(Keyboard[keyId]);
} }
/// <summary>
/// Merges the keys from the given keygroup in this keygroup.
/// </summary>
/// <param name="groupToMerge">The keygroup to merge.</param>
public void MergeKeys(IKeyGroup groupToMerge) public void MergeKeys(IKeyGroup groupToMerge)
{ {
foreach (CorsairKey key in groupToMerge.Keys) foreach (CorsairKey key in groupToMerge.Keys)
@ -91,7 +154,10 @@ namespace CUE.NET.Devices.Keyboard.Keys
GroupKeys.Add(key); GroupKeys.Add(key);
} }
/// <summary>
/// Gets a list containing the keys from this group.
/// </summary>
/// <returns>The list containing the keys.</returns>
protected override IList<CorsairKey> GetGroupKeys() protected override IList<CorsairKey> GetGroupKeys()
{ {
return GroupKeys; return GroupKeys;

View File

@ -9,29 +9,70 @@ using CUE.NET.Helper;
namespace CUE.NET.Devices.Keyboard.Keys namespace CUE.NET.Devices.Keyboard.Keys
{ {
/// <summary>
/// Represents a keygroup containing keys which physically lay inside a rectangle.
/// </summary>
public class RectangleKeyGroup : BaseKeyGroup public class RectangleKeyGroup : BaseKeyGroup
{ {
#region Properties & Fields #region Properties & Fields
/// <summary>
/// Gets or sets the rectangle the keys should be taken from.
/// </summary>
public RectangleF Rectangle { get; set; } public RectangleF Rectangle { get; set; }
/// <summary>
/// Gets or sets the minimal percentage overlay a key must have with the <see cref="Rectangle" /> to be taken into the keygroup.
/// </summary>
public float MinOverlayPercentage { get; set; } public float MinOverlayPercentage { get; set; }
#endregion #endregion
#region Constructors #region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="RectangleKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="fromKey">They ID of the first key to calculate the rectangle of this keygroup from.</param>
/// <param name="toKey">They ID of the second key to calculate the rectangle of this keygroup from.</param>
/// <param name="minOverlayPercentage">(optional) The minimal percentage overlay a key must have with the <see cref="Rectangle" /> to be taken into the keygroup. (default: 0.5f)</param>
/// <param name="autoAttach">(optional) Specifies whether this group should be automatically attached or not. (default: true)</param>
public RectangleKeyGroup(CorsairKeyboard keyboard, CorsairKeyboardKeyId fromKey, CorsairKeyboardKeyId toKey, float minOverlayPercentage = 0.5f, bool autoAttach = true) public RectangleKeyGroup(CorsairKeyboard keyboard, CorsairKeyboardKeyId fromKey, CorsairKeyboardKeyId toKey, float minOverlayPercentage = 0.5f, bool autoAttach = true)
: this(keyboard, keyboard[fromKey], keyboard[toKey], minOverlayPercentage, autoAttach) : this(keyboard, keyboard[fromKey], keyboard[toKey], minOverlayPercentage, autoAttach)
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="RectangleKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="fromKey">They first key to calculate the rectangle of this keygroup from.</param>
/// <param name="toKey">They second key to calculate the rectangle of this keygroup from.</param>
/// <param name="minOverlayPercentage">(optional) The minimal percentage overlay a key must have with the <see cref="Rectangle" /> to be taken into the keygroup. (default: 0.5f)</param>
/// <param name="autoAttach">(optional) Specifies whether this group should be automatically attached or not. (default: true)</param>
public RectangleKeyGroup(CorsairKeyboard keyboard, CorsairKey fromKey, CorsairKey toKey, float minOverlayPercentage = 0.5f, bool autoAttach = true) public RectangleKeyGroup(CorsairKeyboard keyboard, CorsairKey fromKey, CorsairKey toKey, float minOverlayPercentage = 0.5f, bool autoAttach = true)
: this(keyboard, RectangleHelper.CreateRectangleFromRectangles(fromKey.KeyRectangle, toKey.KeyRectangle), minOverlayPercentage, autoAttach) : this(keyboard, RectangleHelper.CreateRectangleFromRectangles(fromKey.KeyRectangle, toKey.KeyRectangle), minOverlayPercentage, autoAttach)
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="RectangleKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="fromPoint">They first point to calculate the rectangle of this keygroup from.</param>
/// <param name="toPoint">They second point to calculate the rectangle of this keygroup from.</param>
/// <param name="minOverlayPercentage">(optional) The minimal percentage overlay a key must have with the <see cref="Rectangle" /> to be taken into the keygroup. (default: 0.5f)</param>
/// <param name="autoAttach">(optional) Specifies whether this group should be automatically attached or not. (default: true)</param>
public RectangleKeyGroup(CorsairKeyboard keyboard, PointF fromPoint, PointF toPoint, float minOverlayPercentage = 0.5f, bool autoAttach = true) public RectangleKeyGroup(CorsairKeyboard keyboard, PointF fromPoint, PointF toPoint, float minOverlayPercentage = 0.5f, bool autoAttach = true)
: this(keyboard, RectangleHelper.CreateRectangleFromPoints(fromPoint, toPoint), minOverlayPercentage, autoAttach) : this(keyboard, RectangleHelper.CreateRectangleFromPoints(fromPoint, toPoint), minOverlayPercentage, autoAttach)
{ } { }
/// <summary>
/// Initializes a new instance of the <see cref="RectangleKeyGroup"/> class.
/// </summary>
/// <param name="keyboard">The keyboard this keygroup belongs to.</param>
/// <param name="rectangle">The rectangle of this keygroup.</param>
/// <param name="minOverlayPercentage">(optional) The minimal percentage overlay a key must have with the <see cref="Rectangle" /> to be taken into the keygroup. (default: 0.5f)</param>
/// <param name="autoAttach">(optional) Specifies whether this group should be automatically attached or not. (default: true)</param>
public RectangleKeyGroup(CorsairKeyboard keyboard, RectangleF rectangle, float minOverlayPercentage = 0.5f, bool autoAttach = true) public RectangleKeyGroup(CorsairKeyboard keyboard, RectangleF rectangle, float minOverlayPercentage = 0.5f, bool autoAttach = true)
: base(keyboard, autoAttach) : base(keyboard, autoAttach)
{ {
@ -43,6 +84,10 @@ namespace CUE.NET.Devices.Keyboard.Keys
#region Methods #region Methods
/// <summary>
/// Gets a list containing the keys from this group.
/// </summary>
/// <returns>The list containing the keys.</returns>
protected override IList<CorsairKey> GetGroupKeys() protected override IList<CorsairKey> GetGroupKeys()
{ {
return Keyboard.Where(x => RectangleHelper.CalculateIntersectPercentage(x.KeyRectangle, Rectangle) >= MinOverlayPercentage).ToList(); return Keyboard.Where(x => RectangleHelper.CalculateIntersectPercentage(x.KeyRectangle, Rectangle) >= MinOverlayPercentage).ToList();

View File

@ -26,7 +26,6 @@ namespace CUE.NET.Devices.Mouse
/// </summary> /// </summary>
/// <param name="ledId">The ID of the LED to get.</param> /// <param name="ledId">The ID of the LED to get.</param>
/// <returns>The LED with the specified ID.</returns> /// <returns>The LED with the specified ID.</returns>
/// <exception cref="System.ArgumentNullException" accessor="get"><paramref name="ledId" /> is null.</exception>
public CorsairLed this[CorsairMouseLedId ledId] public CorsairLed this[CorsairMouseLedId ledId]
{ {
get get
@ -44,7 +43,7 @@ namespace CUE.NET.Devices.Mouse
public CorsairMouseDeviceInfo MouseDeviceInfo { get; } public CorsairMouseDeviceInfo MouseDeviceInfo { get; }
/// <summary> /// <summary>
/// Indicates if the mouse has an active effect to deal with. /// Gets a value indicating if the mouse has an active effect to deal with or not.
/// </summary> /// </summary>
protected override bool HasEffect => false; protected override bool HasEffect => false;

View File

@ -15,7 +15,7 @@ namespace CUE.NET.Devices.Mouse
#region Properties & Fields #region Properties & Fields
/// <summary> /// <summary>
/// Physical layout of the mouse. /// Gets the physical layout of the mouse.
/// </summary> /// </summary>
public CorsairPhysicalMouseLayout PhysicalLayout { get; private set; } public CorsairPhysicalMouseLayout PhysicalLayout { get; private set; }