www.pudn.com > PeakMeterCS.zip > PeakMeterCtrl.cs
///////////////////////////////////////////////////////////////////////////////
// Copyright (c) 2008 Ernest Laurentin (elaurentin@netzero.net)
//
// This software is provided 'as-is', without any express or implied
// warranty. In no event will the authors be held liable for any damages
// arising from the use of this software.
//
// Permission is granted to anyone to use this software for any purpose,
// including commercial applications, and to alter it and redistribute it
// freely, subject to the following restrictions:
//
// 1. The origin of this software must not be misrepresented; you must not
// claim that you wrote the original software. If you use this software
// in a product, an acknowledgment in the product documentation would be
// appreciated but is not required.
//
// 2. Altered source versions must be plainly marked as such, and must not be
// misrepresented as being the original software.
//
// 3. This notice may not be removed or altered from any source distribution.
///////////////////////////////////////////////////////////////////////////////
using System;
using System.ComponentModel;
using System.Drawing;
using System.Windows.Forms;
using System.Threading;
namespace Ernzo.WinForms.Controls
{
public enum PeakMeterStyle
{
PMS_Horizontal = 0,
PMS_Vertical = 1
}
internal struct PeakMeterData
{
public int Value;
public int Falloff;
public int Speed;
}
[ToolboxBitmap(typeof(PeakMeterCtrl), "pmicon.bmp")]
public partial class PeakMeterCtrl : Control
{
private const byte DarkenByDefault = 40;
private const byte LightenByDefault = 150;
private const int MinRangeDefault = 60;
private const int MedRangeDefault = 80;
private const int MaxRangeDefault = 100;
private const int FalloffFast = 1;
private const int FalloffNormal = 10;
private const int FalloffSlow = 100;
private const int FalloffDefault = 10;
private const int DecrementPercent = 10;
private const int BandsMin = 1;
private const int BandsMax = 1000;
private const int BandsDefault = 8;
private const int LEDMin = 1;
private const int LEDMax = 1000;
private const int LEDDefault = 8;
private const int cxyMargin = 1;
private int _AnimDelay;
private int _MinRangeValue;
private int _MedRangeValue;
private int _MaxRangeValue;
private PeakMeterData[] _meterData;
private System.Threading.Timer _animationTimer;
public PeakMeterCtrl()
{
InitializeComponent();
InitDefault();
this.SetStyle(ControlStyles.OptimizedDoubleBuffer, true);
this.SetStyle(ControlStyles.UserPaint, true);
//this.SetStyle(ControlStyles.AllPaintingInWmPaint, true);
}
private void InitDefault()
{
_AnimDelay = Timeout.Infinite;
_MinRangeValue = MinRangeDefault; // [0,60[
_MedRangeValue = MedRangeDefault; // [60,80[
_MaxRangeValue = MaxRangeDefault; // [80,100[
_meterData = null;
_animationTimer = null;
_ShowGrid = true;
_ColoredGrid = false;
_GridColor = Color.Gainsboro;
_ColorNormal = Color.Green;
_ColorMedium = Color.Yellow;
_ColorHigh = Color.Red;
_ColorNormalBack = LightenColor(_ColorNormal, LightenByDefault);
_ColorMediumBack = LightenColor(_ColorMedium, LightenByDefault);
_ColorHighBack = LightenColor(_ColorHigh, LightenByDefault);
_BandsCount = BandsDefault;
_LEDCount = LEDDefault;
_FalloffSpeed = FalloffNormal;
_FalloffEffect = false;
_FalloffColor = DarkenColor(_GridColor, DarkenByDefault);
}
#region Control properties
private PeakMeterStyle _PmsMeterStyle;
[Category("Appearance"), DefaultValue(PeakMeterStyle.PMS_Horizontal)]
public PeakMeterStyle MeterStyle
{
get { return _PmsMeterStyle; }
set { _PmsMeterStyle = value; Refresh(); }
}
private bool _ShowGrid;
[Category("Appearance"), DefaultValue(false)]
public bool ShowGrid
{
get { return _ShowGrid; }
set { _ShowGrid = value; Refresh(); }
}
private bool _ColoredGrid;
[Category("Appearance"), DefaultValue(true)]
public bool ColoredGrid
{
get { return _ColoredGrid; }
set { _ColoredGrid = value; Refresh(); }
}
private Color _GridColor;
[Category("Appearance")]
public Color GridColor
{
get { return _GridColor; }
set { _GridColor = value; Refresh(); }
}
private Color _ColorNormal;
[Category("Appearance")]
public Color ColorNormal
{
get { return _ColorNormal; }
set { _ColorNormal = value; Refresh(); }
}
private Color _ColorMedium;
[Category("Appearance")]
public Color ColorMedium
{
get { return _ColorMedium; }
set { _ColorMedium = value; Refresh(); }
}
private Color _ColorHigh;
[Category("Appearance")]
public Color ColorHigh
{
get { return _ColorHigh; }
set { _ColorHigh = value; Refresh(); }
}
private Color _ColorNormalBack;
[Category("Appearance")]
public Color ColorNormalBack
{
get { return _ColorNormalBack; }
set { _ColorNormalBack = value; Refresh(); }
}
private Color _ColorMediumBack;
[Category("Appearance")]
public Color ColorMediumBack
{
get { return _ColorMediumBack; }
set { _ColorMediumBack = value; Refresh(); }
}
private Color _ColorHighBack;
[Category("Appearance")]
public Color ColorHighBack
{
get { return _ColorHighBack; }
set { _ColorHighBack = value; Refresh(); }
}
private int _BandsCount;
[Category("Appearance"), DefaultValue(BandsDefault)]
public int BandsCount
{
get { return _BandsCount; }
set {
if (value >= BandsMin && value <= BandsMax)
{
_BandsCount = value;
ResetControl();
Refresh();
}
}
}
private int _LEDCount;
[Category("Appearance"), DefaultValue(LEDDefault)]
public int LEDCount
{
get { return _LEDCount; }
set {
if (value >= LEDMin && value <= LEDMax)
{
_LEDCount = value;
Refresh();
}
}
}
private int _FalloffSpeed;
[Category("Falloff Effect"), DefaultValue(FalloffDefault)]
public int FalloffSpeed
{
get { return _FalloffSpeed; }
set { _FalloffSpeed = value; }
}
private bool _FalloffEffect;
[Category("Falloff Effect"), DefaultValue(true)]
public bool FalloffEffect
{
get { return _FalloffEffect; }
set { _FalloffEffect = value; }
}
private Color _FalloffColor;
[Category("Falloff Effect")]
public Color FalloffColor
{
get { return _FalloffColor; }
set { _FalloffColor = value; }
}
#endregion
[Browsable(false)]
public bool IsActive
{
get { return (_animationTimer != null); }
}
#region Control Methods
///
/// Start animation
///
///
///
/// Stop Animation
///
///
/// Set number of LED bands
///
/// Number of bands
/// Number of LED per bands
void SetMeterBands(int BandsCount, int LEDCount)
{
if (BandsCount < BandsMin || BandsCount > BandsMax)
throw new ArgumentOutOfRangeException();
if (LEDCount < LEDMin || LEDCount > LEDMax)
throw new ArgumentOutOfRangeException();
_BandsCount = BandsCount;
_LEDCount = LEDCount;
ResetControl();
Refresh();
}
///
/// Set range info
///
/// Min Range
/// Medium Range
/// High Range
void SetRange(int minRangeVal, int medRangeVal, int maxRangeVal)
{
if (maxRangeVal <= medRangeVal || medRangeVal < minRangeVal )
throw new ArgumentOutOfRangeException();
_MinRangeValue = minRangeVal;
_MedRangeValue = medRangeVal;
_MaxRangeValue = maxRangeVal;
ResetControl();
Refresh();
}
///
/// Set meter band value
///
/// Array value for the bands
/// Starting offset position
/// Number of values to set
///
/// Make a color darker
///
/// Color to darken
/// Value to decrease by
protected virtual Color DarkenColor(Color color, byte darkenBy)
{
byte red = (byte)(color.R > darkenBy ? (color.R - darkenBy) : 0);
byte green = (byte)(color.G > darkenBy ? (color.G - darkenBy) : 0);
byte blue = (byte)(color.B > darkenBy ? (color.B - darkenBy) : 0);
return Color.FromArgb(red, green, blue);
}
///
/// Make a color lighter
///
///
///
///