mirror of https://github.com/SixLabors/ImageSharp
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
104 lines
3.8 KiB
104 lines
3.8 KiB
// Copyright (c) Six Labors.
|
|
// Licensed under the Six Labors Split License.
|
|
|
|
using System;
|
|
using System.Numerics;
|
|
using System.Runtime.CompilerServices;
|
|
|
|
namespace SixLabors.ImageSharp.ColorSpaces
|
|
{
|
|
/// <summary>
|
|
/// Represents a Hsl (hue, saturation, lightness) color.
|
|
/// </summary>
|
|
public readonly struct Hsl : IEquatable<Hsl>
|
|
{
|
|
private static readonly Vector3 Min = Vector3.Zero;
|
|
private static readonly Vector3 Max = new Vector3(360, 1, 1);
|
|
|
|
/// <summary>
|
|
/// Gets the hue component.
|
|
/// <remarks>A value ranging between 0 and 360.</remarks>
|
|
/// </summary>
|
|
public readonly float H;
|
|
|
|
/// <summary>
|
|
/// Gets the saturation component.
|
|
/// <remarks>A value ranging between 0 and 1.</remarks>
|
|
/// </summary>
|
|
public readonly float S;
|
|
|
|
/// <summary>
|
|
/// Gets the lightness component.
|
|
/// <remarks>A value ranging between 0 and 1.</remarks>
|
|
/// </summary>
|
|
public readonly float L;
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="Hsl"/> struct.
|
|
/// </summary>
|
|
/// <param name="h">The h hue component.</param>
|
|
/// <param name="s">The s saturation component.</param>
|
|
/// <param name="l">The l value (lightness) component.</param>
|
|
[MethodImpl(InliningOptions.ShortMethod)]
|
|
public Hsl(float h, float s, float l)
|
|
: this(new Vector3(h, s, l))
|
|
{
|
|
}
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="Hsl"/> struct.
|
|
/// </summary>
|
|
/// <param name="vector">The vector representing the h, s, l components.</param>
|
|
[MethodImpl(InliningOptions.ShortMethod)]
|
|
public Hsl(Vector3 vector)
|
|
{
|
|
vector = Vector3.Clamp(vector, Min, Max);
|
|
this.H = vector.X;
|
|
this.S = vector.Y;
|
|
this.L = vector.Z;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Compares two <see cref="Hsl"/> objects for equality.
|
|
/// </summary>
|
|
/// <param name="left">
|
|
/// The <see cref="Hsl"/> on the left side of the operand.
|
|
/// </param>
|
|
/// <param name="right">The <see cref="Hsl"/> on the right side of the operand.</param>
|
|
/// <returns>
|
|
/// True if the current left is equal to the <paramref name="right"/> parameter; otherwise, false.
|
|
/// </returns>
|
|
[MethodImpl(InliningOptions.ShortMethod)]
|
|
public static bool operator ==(Hsl left, Hsl right) => left.Equals(right);
|
|
|
|
/// <summary>
|
|
/// Compares two <see cref="Hsl"/> objects for inequality.
|
|
/// </summary>
|
|
/// <param name="left">The <see cref="Hsl"/> on the left side of the operand.</param>
|
|
/// <param name="right">The <see cref="Hsl"/> on the right side of the operand.</param>
|
|
/// <returns>
|
|
/// True if the current left is unequal to the <paramref name="right"/> parameter; otherwise, false.
|
|
/// </returns>
|
|
[MethodImpl(InliningOptions.ShortMethod)]
|
|
public static bool operator !=(Hsl left, Hsl right) => !left.Equals(right);
|
|
|
|
/// <inheritdoc/>
|
|
[MethodImpl(InliningOptions.ShortMethod)]
|
|
public override int GetHashCode() => HashCode.Combine(this.H, this.S, this.L);
|
|
|
|
/// <inheritdoc/>
|
|
public override string ToString() => FormattableString.Invariant($"Hsl({this.H:#0.##}, {this.S:#0.##}, {this.L:#0.##})");
|
|
|
|
/// <inheritdoc/>
|
|
public override bool Equals(object obj) => obj is Hsl other && this.Equals(other);
|
|
|
|
/// <inheritdoc/>
|
|
[MethodImpl(InliningOptions.ShortMethod)]
|
|
public bool Equals(Hsl other)
|
|
{
|
|
return this.H.Equals(other.H)
|
|
&& this.S.Equals(other.S)
|
|
&& this.L.Equals(other.L);
|
|
}
|
|
}
|
|
}
|
|
|