mirror of
https://github.com/gui-cs/Terminal.Gui.git
synced 2025-12-26 15:57:56 +01:00
* Initial plan * Delete AnsiColorNameResolver and MultiStandardColorNameResolver, add legacy 16-color names to StandardColor Co-authored-by: tig <585482+tig@users.noreply.github.com> * Refactor and enhance tests for Color, Region, and Lines Refactored `Color` struct by removing unused methods and simplifying logic. Updated namespaces for better organization. Enhanced test coverage for `Color`, `Region`, and `LineCanvas` with new test cases, parameterized tests, and edge case handling. Added `StraightLineExtensionsTests`, `StraightLineTests`, and `RegionClassTests` to validate behavior under various scenarios. Improved `MergeRectangles` stability and addressed crash patterns. Removed legacy features and unused code. Enhanced documentation and optimized performance in key methods. * Improve Color struct and StandardColors functionality Enhanced the Color struct to fully support the alpha channel for rendering intent while maintaining semantic color identity. Updated TryNameColor to ignore alpha when matching colors, ensuring transparency does not affect color resolution. Expanded XML documentation to clarify alpha channel usage and future alpha blending support. Improved drawing documentation to explain the lifecycle, deferred rendering, and color support, including 24-bit true color and legacy 16-color compatibility. Added a new section on transparency and its role in rendering. Revised StandardColors implementation to use modern C# features and ensure consistent ARGB mapping. Added comprehensive tests for StandardColors and Color, covering alpha handling, color parsing, thread safety, and aliased color resolution. Removed outdated tests relying on legacy behavior. Enhanced code readability, maintainability, and test coverage to ensure correctness and backward compatibility. * Code cleanup * Code cleanup * Fix warnings. Code cleanup * Add comprehensive unit tests for ColorStrings class Introduced a new test class `ColorStringsTests` under the `DrawingTests.ColorTests` namespace to validate the functionality of the `ColorStrings` class. Key changes include: - Added tests for `GetColorName` to verify behavior for standard and non-standard colors, ignoring alpha channels, and handling known colors. - Added tests for `GetStandardColorNames` to ensure the method returns a non-empty, alphabetically sorted collection containing all `StandardColor` enum values. - Implemented tests for `TryParseStandardColorName` to validate case-insensitive parsing, hex color support, handling invalid input, and `ReadOnlySpan<char>` compatibility. - Added tests for `TryParseNamedColor` to verify parsing of named and hex colors, handling of aliases, and `ReadOnlySpan<char>` support. - Added round-trip tests to ensure consistency between `GetColorName`, `TryParseNamedColor`, `GetStandardColorNames`, and `TryParseStandardColorName`. These tests ensure robust validation of color parsing and naming functionality. --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: tig <585482+tig@users.noreply.github.com> Co-authored-by: Tig <tig@users.noreply.github.com>
480 lines
15 KiB
C#
480 lines
15 KiB
C#
using UnitTests;
|
|
using Xunit.Abstractions;
|
|
|
|
namespace UnitTests.Parallelizable.Drawing.Lines;
|
|
|
|
public class StraightLineExtensionsTests (ITestOutputHelper output)
|
|
{
|
|
[Fact]
|
|
public void LineCanvasIntegrationTest ()
|
|
{
|
|
var lc = new LineCanvas ();
|
|
lc.AddLine (Point.Empty, 10, Orientation.Horizontal, LineStyle.Single);
|
|
lc.AddLine (new (9, 0), 5, Orientation.Vertical, LineStyle.Single);
|
|
lc.AddLine (new (9, 4), -10, Orientation.Horizontal, LineStyle.Single);
|
|
lc.AddLine (new (0, 4), -5, Orientation.Vertical, LineStyle.Single);
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌────────┐
|
|
│ │
|
|
│ │
|
|
│ │
|
|
└────────┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
IReadOnlyCollection<StraightLine> origLines = lc.Lines;
|
|
|
|
lc = new (origLines.Exclude (Point.Empty, 10, Orientation.Horizontal));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
│ │
|
|
│ │
|
|
│ │
|
|
└────────┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (new (0, 1), 10, Orientation.Horizontal));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌────────┐
|
|
|
|
│ │
|
|
│ │
|
|
└────────┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (new (0, 2), 10, Orientation.Horizontal));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌────────┐
|
|
│ │
|
|
|
|
│ │
|
|
└────────┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (new (0, 3), 10, Orientation.Horizontal));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌────────┐
|
|
│ │
|
|
│ │
|
|
|
|
└────────┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (new (0, 4), 10, Orientation.Horizontal));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌────────┐
|
|
│ │
|
|
│ │
|
|
│ │",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (Point.Empty, 10, Orientation.Vertical));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
────────┐
|
|
│
|
|
│
|
|
│
|
|
────────┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (new (1, 0), 10, Orientation.Vertical));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌ ───────┐
|
|
│ │
|
|
│ │
|
|
│ │
|
|
└ ───────┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (new (8, 0), 10, Orientation.Vertical));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌─────── ┐
|
|
│ │
|
|
│ │
|
|
│ │
|
|
└─────── ┘",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
|
|
lc = new (origLines.Exclude (new (9, 0), 10, Orientation.Vertical));
|
|
|
|
OutputAssert.AssertEqual (
|
|
output,
|
|
@"
|
|
┌────────
|
|
│
|
|
│
|
|
│
|
|
└────────",
|
|
$"{Environment.NewLine}{lc}"
|
|
);
|
|
}
|
|
|
|
#region Parallel Tests
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_HorizontalLines_LeftOnly ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=3 to x=103
|
|
.Exclude (new (3, 2), 100, Orientation.Horizontal)
|
|
.ToArray ();
|
|
|
|
// x=1 to x=2
|
|
StraightLine afterLine = Assert.Single (after);
|
|
Assert.Equal (l1.Start, afterLine.Start);
|
|
Assert.Equal (2, afterLine.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_HorizontalLines_RightOnly ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=0 to x=2
|
|
.Exclude (new (0, 2), 3, Orientation.Horizontal)
|
|
.ToArray ();
|
|
|
|
// x=3 to x=10
|
|
StraightLine afterLine = Assert.Single (after);
|
|
Assert.Equal (3, afterLine.Start.X);
|
|
Assert.Equal (2, afterLine.Start.Y);
|
|
Assert.Equal (8, afterLine.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_HorizontalLines_HorizontalSplit ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=4 to x=5
|
|
.Exclude (new (4, 2), 2, Orientation.Horizontal)
|
|
.ToArray ();
|
|
|
|
// x=1 to x=3,
|
|
// x=6 to x=10
|
|
Assert.Equal (2, after.Length);
|
|
StraightLine afterLeft = after [0];
|
|
StraightLine afterRight = after [1];
|
|
|
|
Assert.Equal (1, afterLeft.Start.X);
|
|
Assert.Equal (2, afterLeft.Start.Y);
|
|
Assert.Equal (3, afterLeft.Length);
|
|
|
|
Assert.Equal (6, afterRight.Start.X);
|
|
Assert.Equal (2, afterRight.Start.Y);
|
|
Assert.Equal (5, afterRight.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_HorizontalLines_CoverCompletely ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=4 to x=5
|
|
.Exclude (new (1, 2), 10, Orientation.Horizontal)
|
|
.ToArray ();
|
|
Assert.Empty (after);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_VerticalLines_TopOnly ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=3 to y=103
|
|
.Exclude (new (2, 3), 100, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// y=1 to y=2
|
|
StraightLine afterLine = Assert.Single (after);
|
|
Assert.Equal (l1.Start, afterLine.Start);
|
|
Assert.Equal (2, afterLine.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_HorizontalLines_BottomOnly ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=0 to y=2
|
|
.Exclude (new (2, 0), 3, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// y=3 to y=10
|
|
StraightLine afterLine = Assert.Single (after);
|
|
Assert.Equal (3, afterLine.Start.Y);
|
|
Assert.Equal (2, afterLine.Start.X);
|
|
Assert.Equal (8, afterLine.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_VerticalLines_VerticalSplit ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=4 to y=5
|
|
.Exclude (new (2, 4), 2, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// y=1 to y=3,
|
|
// y=6 to y=10
|
|
Assert.Equal (2, after.Length);
|
|
StraightLine afterLeft = after [0];
|
|
StraightLine afterRight = after [1];
|
|
|
|
Assert.Equal (1, afterLeft.Start.Y);
|
|
Assert.Equal (2, afterLeft.Start.X);
|
|
Assert.Equal (3, afterLeft.Length);
|
|
|
|
Assert.Equal (6, afterRight.Start.Y);
|
|
Assert.Equal (2, afterRight.Start.X);
|
|
Assert.Equal (5, afterRight.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludeParallel_VerticalLines_CoverCompletely ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=4 to y=5
|
|
.Exclude (new (2, 1), 10, Orientation.Vertical)
|
|
.ToArray ();
|
|
Assert.Empty (after);
|
|
}
|
|
|
|
#endregion
|
|
|
|
#region Perpendicular Intersection Tests
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_HorizontalLine_VerticalExclusion_Splits ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=3 y=0-10
|
|
.Exclude (new (3, 0), 10, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// x=1 to x=2,
|
|
// x=4 to x=10
|
|
Assert.Equal (2, after.Length);
|
|
StraightLine afterLeft = after [0];
|
|
StraightLine afterRight = after [1];
|
|
|
|
Assert.Equal (1, afterLeft.Start.X);
|
|
Assert.Equal (2, afterLeft.Start.Y);
|
|
Assert.Equal (2, afterLeft.Length);
|
|
|
|
Assert.Equal (4, afterRight.Start.X);
|
|
Assert.Equal (2, afterRight.Start.Y);
|
|
Assert.Equal (7, afterRight.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_HorizontalLine_VerticalExclusion_ClipLeft ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=1 y=0-10
|
|
.Exclude (new (1, 0), 10, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// x=2 to x=10,
|
|
StraightLine lineAfter = Assert.Single (after);
|
|
|
|
Assert.Equal (2, lineAfter.Start.X);
|
|
Assert.Equal (2, lineAfter.Start.Y);
|
|
Assert.Equal (9, lineAfter.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_HorizontalLine_VerticalExclusion_ClipRight ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=10 y=0-10
|
|
.Exclude (new (10, 0), 10, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// x=1 to x=9,
|
|
StraightLine lineAfter = Assert.Single (after);
|
|
|
|
Assert.Equal (1, lineAfter.Start.X);
|
|
Assert.Equal (2, lineAfter.Start.Y);
|
|
Assert.Equal (9, lineAfter.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_HorizontalLine_VerticalExclusion_MissLeft ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=0 y=0-10
|
|
.Exclude (Point.Empty, 10, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// Exclusion line is too far to the left so hits nothing
|
|
Assert.Same (Assert.Single (after), l1);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_HorizontalLine_VerticalExclusion_MissRight ()
|
|
{
|
|
// x=1 to x=10
|
|
var l1 = new StraightLine (new (1, 2), 10, Orientation.Horizontal, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude x=11 y=0-10
|
|
.Exclude (new (11, 0), 10, Orientation.Vertical)
|
|
.ToArray ();
|
|
|
|
// Exclusion line is too far to the right so hits nothing
|
|
Assert.Same (Assert.Single (after), l1);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_VerticalLine_HorizontalExclusion_ClipTop ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=1 x=0-10
|
|
.Exclude (new (0, 1), 10, Orientation.Horizontal)
|
|
.ToArray ();
|
|
|
|
// y=2 to y=10,
|
|
StraightLine lineAfter = Assert.Single (after);
|
|
|
|
Assert.Equal (2, lineAfter.Start.Y);
|
|
Assert.Equal (2, lineAfter.Start.X);
|
|
Assert.Equal (9, lineAfter.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_VerticalLine_HorizontalExclusion_ClipBottom ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=10 x=0-10
|
|
.Exclude (new (0, 10), 10, Orientation.Horizontal)
|
|
.ToArray ();
|
|
|
|
// y=1 to y=9,
|
|
StraightLine lineAfter = Assert.Single (after);
|
|
|
|
Assert.Equal (1, lineAfter.Start.Y);
|
|
Assert.Equal (2, lineAfter.Start.X);
|
|
Assert.Equal (9, lineAfter.Length);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_VerticalLine_HorizontalExclusion_MissTop ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=0 x=0-10
|
|
.Exclude (Point.Empty, 10, Orientation.Horizontal)
|
|
.ToArray ();
|
|
|
|
// Exclusion line is too far above so hits nothing
|
|
Assert.Same (Assert.Single (after), l1);
|
|
}
|
|
|
|
[Fact]
|
|
public void TestExcludePerpendicular_VerticalLine_HorizontalExclusion_MissBottom ()
|
|
{
|
|
// y=1 to y=10
|
|
var l1 = new StraightLine (new (2, 1), 10, Orientation.Vertical, LineStyle.Single);
|
|
|
|
StraightLine [] after = new [] { l1 }
|
|
|
|
// exclude y=11 x=0-10
|
|
.Exclude (new (0, 11), 10, Orientation.Horizontal)
|
|
.ToArray ();
|
|
|
|
// Exclusion line is too far to the right so hits nothing
|
|
Assert.Same (Assert.Single (after), l1);
|
|
}
|
|
|
|
#endregion Perpendicular Intersection Tests
|
|
}
|