58 lines
2.6 KiB
C#
58 lines
2.6 KiB
C#
namespace Syntriax.Engine.Core;
|
|
|
|
/// <summary>
|
|
/// Represents a line equation in the form y = mx + b.
|
|
/// </summary>
|
|
/// <param name="slope">The slope of the line.</param>
|
|
/// <param name="offsetY">The y-intercept of the line.</param>
|
|
/// <remarks>
|
|
/// Initializes a new instance of the <see cref="Line2DEquation"/> struct with the specified slope and y-intercept.
|
|
/// </remarks>
|
|
[System.Diagnostics.DebuggerDisplay("y = {Slope}x + {OffsetY}")]
|
|
public readonly struct Line2DEquation(float slope, float offsetY)
|
|
{
|
|
/// <summary>
|
|
/// The slope of the line equation.
|
|
/// </summary>
|
|
public readonly float Slope = slope;
|
|
|
|
/// <summary>
|
|
/// The y-intercept of the line equation.
|
|
/// </summary>
|
|
public readonly float OffsetY = offsetY;
|
|
|
|
/// <summary>
|
|
/// Resolves the y-coordinate for a given x-coordinate using the line equation.
|
|
/// </summary>
|
|
/// <param name="lineEquation">The line equation to resolve.</param>
|
|
/// <param name="x">The x-coordinate for which to resolve the y-coordinate.</param>
|
|
/// <returns>The y-coordinate resolved using the line equation.</returns>
|
|
public static float Resolve(Line2DEquation lineEquation, float x) => lineEquation.Slope * x + lineEquation.OffsetY; // y = mx + b
|
|
|
|
/// <summary>
|
|
/// Checks if two line equations are approximately equal.
|
|
/// </summary>
|
|
/// <param name="left">The first line equation to compare.</param>
|
|
/// <param name="right">The second line equation to compare.</param>
|
|
/// <param name="epsilon">The epsilon range.</param>
|
|
/// <returns>True if the line equations are approximately equal; otherwise, false.</returns>
|
|
public static bool ApproximatelyEquals(Line2DEquation left, Line2DEquation right, float epsilon = float.Epsilon)
|
|
=> left.Slope.ApproximatelyEquals(right.Slope, epsilon) && left.OffsetY.ApproximatelyEquals(right.OffsetY, epsilon);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Provides extension methods for the LineEquation struct.
|
|
/// </summary>
|
|
public static class Line2DEquationExtensions
|
|
{
|
|
/// <summary>
|
|
/// Resolves the y-coordinate for a given x-coordinate using the line equation.
|
|
/// </summary>
|
|
/// <param name="lineEquation">The line equation to resolve.</param>
|
|
/// <param name="x">The x-coordinate for which to resolve the y-coordinate.</param>
|
|
/// <returns>The y-coordinate resolved using the line equation.</returns>
|
|
public static float Resolve(this Line2DEquation lineEquation, float x) => Line2DEquation.Resolve(lineEquation, x);
|
|
|
|
public static bool ApproximatelyEquals(this Line2DEquation left, Line2DEquation right, float epsilon = float.Epsilon) => Line2DEquation.ApproximatelyEquals(left, right, epsilon);
|
|
}
|