namespace Developpez.Dotnet.Drawing
{
    /// <summary>
    /// Représente une couleur dans l'espace colorimétrique HSV (teinte, saturation, valeur)
    /// </summary>
    public struct HsvColor
    {
        private readonly double _h;
        private readonly double _s;
        private readonly double _v;

        /// <summary>
        /// Initialise une nouvelle isntance de HsvColor
        /// </summary>
        /// <param name="h">Teinte (hue), valeur comprise entre 0° et 360°</param>
        /// <param name="s">Saturation, valeur comprise entre 0 et 1</param>
        /// <param name="v">Valeur, valeur comprise entre 0 et 1</param>
        public HsvColor(double h, double s, double v)
        {
            _h = h;
            _s = s;
            _v = v;
        }

        /// <summary>
        /// Obtient la teinte (hue) de cette couleur
        /// </summary>
        public double H
        {
            get { return _h; }
        }

        /// <summary>
        /// Obtient la saturation de cette couleur
        /// </summary>
        public double S
        {
            get { return _s; }
        }

        /// <summary>
        /// Obtient la valeur de cette couleur
        /// </summary>
        public double V
        {
            get { return _v; }
        }

        /// <summary>
        /// Convertit cette structure HsvColor en chaîne lisible par l'utilisateur.
        /// </summary>
        /// <returns>Chaîne composée des noms des composants HSV et de leurs valeurs.</returns>
        public override string ToString()
        {
            return string.Format("HsvColor [H={0}, S={1}, V={2}]", _h, _s, _v);
        }
    }
}