API v6.0

Breaking changes for API v6.0

Here is a list of breaking changes that happened during the API v6.0 period when differing versions of Terminaux introduced breaking changes.

From 5.4.x to 6.0.x

Between the 5.4.x and 6.0.x version range, we've made the following breaking changes:

ConsoleFilterInfo class added

ConsoleFilter.cs

public static bool IsInFilter(string query, ConsoleFilterType type, ConsoleFilterSeverity severity, out (Regex? query, ConsoleFilterType type, ConsoleFilterSeverity severity, string justification) queryTuple)
public static bool IsInFilter(Regex query, ConsoleFilterType type, ConsoleFilterSeverity severity, out (Regex? query, ConsoleFilterType type, ConsoleFilterSeverity severity, string justification) queryTuple)
public static (Regex? query, ConsoleFilterType type, ConsoleFilterSeverity severity, string justification)[] GetFilteredQueries()

The ConsoleFilterInfo class has been added to Terminaux's console filtering feature that lists all filter info, including the filter type, the query to match, and so on. This is to make the above functions easier to use by simplifying a tuple to a class.

You'll have to change how your application uses these functions by changing the appropriate calls and references.

WideChar moved to Textify

WideChar.cs

public struct WideChar : IEquatable<WideChar>, IComparable<WideChar>

We've moved WideChar struct to the latest version of Textify that Terminaux now uses. This is to enable more applications using this structure for wide characters.

Just change the using clause to point to Textify.General.Structures.

Centered writers refactored

CenteredTextColor.cs

public static class CenteredTextColor
{
    public static void WriteCentered(int top, string Text, int leftMargin = 0, int rightMargin = 0, params object[] Vars) { }
    public static void WriteCenteredColor(int top, string Text, Color Color, int leftMargin = 0, int rightMargin = 0, params object[] Vars) { }
    (...)
}

CenteredFigletTextColor.cs

public static class CenteredFigletTextColor
{
    public static void WriteCenteredFiglet(int top, FigletFont FigletFont, string Text, int leftMargin = 0, int rightMargin = 0, params object[] Vars) { }
    public static void WriteCenteredFigletColor(int top, FigletFont FigletFont, string Text, Color Color, int leftMargin = 0, int rightMargin = 0, params object[] Vars) { }
    (...)
}

The above centered writers have been replaced by more flexible aligned writers that allow you to not only write text to the console at the center of the console, but you can also align it either to the left, to the middle, or to the right.

• CenteredTextColor -> AlignedTextColor

• CenteredFigletTextColor -> AlignedFigletTextColor

If you still want to write text at the center of the console, you can use the TextAlignment.Middle enumeration.

Shapes and IGeometricShape moved to CyclicWriters

IGeometricShape.cs

namespace Terminaux.Graphics

Shape source codes

namespace Terminaux.Graphics.Shapes

As part of the renderable cyclic writers that can be contained in a single Container instance, we've moved all the shapes and their interface, IGeometricShape, as both that interface and IStaticRenderable work similarly to each other. The shape feature and its interface was a prelude to the static renderable writers.

You just need to change the using clause to point to Terminaux.Writer.CyclicWriters.Shapes. You can still tell the difference between a static renderable and a geometric shape by examining the implemented interfaces, since we don't plan to remove the geometric shape interface.

Writer tools moved to CyclicWriters

namespace Terminaux.Writer.FancyWriters.Tools
// or
namespace Terminaux.Writer.MiscWriters.Tools

The following writer tools have been moved to the Terminaux.Writer.CyclicWriters.Renderer.Tools namespace to unify all the writer tools for consistency:

• AsciinemaRepresentation (newly introduced)

• BorderSettings

• CellOptions

• ChartElement

• FigletTextTools

• Keybinding

• PowerLineSegment

• PowerLineTools

• PredefinedBorders

• TextAlignment (newly introduced)

• TextSettings

• TextWriterTools

None of the above classes and enumerations are affected at the time of the move, but you'll have to change the using clause to point to the right namespace.

Wrapped writer removed

TextWriterWrappedColor.cs

public static class TextWriterWrappedColor

Due to new features being introduced with the introduction of the bounded text, we've decided to remove this writer. It'll be re-introduced in a better form in one of the Terminaux releases, and we promise you with new features.

As a result, the ListWriterColor no longer supports wrapping, as we've removed the Wrap parameter. As Nitrocid KS extensively uses this feature, especially for wrapping commands, this means that Terminaux 6.x series higher than 6.0 will be used in the next few versions of Nitrocid KS.

Please be patient while we're working on a re-write of the wrapped writer in a future 6.x version of Terminaux.

KeybindingsWriter refactored

KeybindingsWriter.cs

public static void ShowKeybindingInfoboxPlain(Keybinding[] keybindings, params object[] vars)
public static void ShowKeybindingInfoboxPlain(Keybinding[] keybindings, BorderSettings settings, params object[] vars)
public static void ShowKeybindingInfobox(Keybinding[] keybindings, params object[] vars)
public static void ShowKeybindingInfoboxColor(Keybinding[] keybindings, Color InfoBoxColor, params object[] vars)
public static void ShowKeybindingInfoboxColorBack(Keybinding[] keybindings, Color InfoBoxColor, Color BackgroundColor, params object[] vars)
public static void ShowKeybindingInfobox(Keybinding[] keybindings, BorderSettings settings, params object[] vars)
public static void ShowKeybindingInfoboxColor(Keybinding[] keybindings, BorderSettings settings, Color InfoBoxColor, params object[] vars)
public static void ShowKeybindingInfoboxColorBack(Keybinding[] keybindings, BorderSettings settings, Color InfoBoxColor, Color BackgroundColor, params object[] vars)
public static void ShowKeybindingInfoboxPlain(string title, Keybinding[] keybindings, params object[] vars)
public static void ShowKeybindingInfoboxPlain(string title, Keybinding[] keybindings, BorderSettings settings, params object[] vars)
public static void ShowKeybindingInfobox(string title, Keybinding[] keybindings, params object[] vars)
public static void ShowKeybindingInfoboxColor(string title, Keybinding[] keybindings, Color InfoBoxTitledColor, params object[] vars)
public static void ShowKeybindingInfoboxColorBack(string title, Keybinding[] keybindings, Color InfoBoxTitledColor, Color BackgroundColor, params object[] vars)
public static void ShowKeybindingInfobox(string title, Keybinding[] keybindings, BorderSettings settings, params object[] vars)
public static void ShowKeybindingInfoboxColor(string title, Keybinding[] keybindings, BorderSettings settings, Color InfoBoxTitledColor, params object[] vars)
public static void ShowKeybindingInfoboxColorBack(string title, Keybinding[] keybindings, BorderSettings settings, Color InfoBoxTitledColor, Color BackgroundColor, params object[] vars)
public static string RenderKeybindingHelpText(Keybinding[] keybindings)

We have moved the KeybindingsWriter functionality to its own cyclic writer class. Also, we've moved the above functions to the KeybindingTools static class.

If you use these functions, consider using the KeybindingTools class.

Slow writers moved to ConsoleWriters

TextWriter[Where]SlowColor.cs

namespace Terminaux.Writer.DynamicWriters

These dynamic writers have been moved to the normal console writers namespace, because we're cleaning up the writer base in versions between Terminaux 6.0 and a future major release of this library.

Just change the using clause to point to Terminaux.Writer.ConsoleWriters.

Filled property removed from IGeometricShape

IGeometricShape.cs

bool Filled { get; }

We have removed the above property from the geometric shape interface, because there are shapes, such as arcs, that can't have this property due to high flexibility.

If you want to continue using this property, implement it in individual geometric shape classes. You won't be able to call it from a general interface variable, so you'll have to cast it to a class that has this property first.

Changed how shapes render

Due to the new canvas class being used to render a shape, you'll notice that the shapes will appear stretched. This is due to the width not being treated as a multiple of two when creating shape instances due to canvases defaulting to full width. The following shapes are affected based on width:

• Ellipsis

• Parallelogram

• Rectangle

• Square

• Line

• Triangle

• Trapezoid

Divide the width by two as in below example (adapt this to your shape instance):

-var ellipsis = new Ellipsis(40, 20, 4, 2, true, ConsoleColors.Red);
-var ellipsis2 = new Ellipsis(20, 20, 46, 2, false, ConsoleColors.Aqua);
+var ellipsis = new Ellipsis(20, 20, 4, 2, true, ConsoleColors.Red);
+var ellipsis2 = new Ellipsis(10, 20, 46, 2, false, ConsoleColors.Aqua);