|
@@ -1,37 +1,75 @@
|
|
|
|
|
+using System.Collections.Concurrent;
|
|
|
|
|
+
|
|
|
namespace Terminal.Gui.Drivers;
|
|
namespace Terminal.Gui.Drivers;
|
|
|
|
|
|
|
|
/// <summary>Base interface for Terminal.Gui Driver implementations.</summary>
|
|
/// <summary>Base interface for Terminal.Gui Driver implementations.</summary>
|
|
|
/// <remarks>
|
|
/// <remarks>
|
|
|
/// There are currently four implementations: UnixDriver, WindowsDriver, DotNetDriver, and FakeDriver
|
|
/// There are currently four implementations: UnixDriver, WindowsDriver, DotNetDriver, and FakeDriver
|
|
|
/// </remarks>
|
|
/// </remarks>
|
|
|
-public interface IDriver
|
|
|
|
|
|
|
+public interface IDriver : IDisposable
|
|
|
{
|
|
{
|
|
|
|
|
+ #region Driver Lifecycle
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>Initializes the driver</summary>
|
|
|
|
|
+ void Init ();
|
|
|
|
|
+
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// Gets the name of the driver implementation.
|
|
|
|
|
|
|
+ /// INTERNAL: Updates the terminal with the current output buffer. Should not be used by applications. Drawing occurs
|
|
|
|
|
+ /// once each Application main loop iteration.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- string? GetName ();
|
|
|
|
|
|
|
+ void Refresh ();
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// Class responsible for processing native driver input objects
|
|
|
|
|
- /// e.g. <see cref="ConsoleKeyInfo"/> into <see cref="Key"/> events
|
|
|
|
|
- /// and detecting and processing ansi escape sequences.
|
|
|
|
|
|
|
+ /// Gets the name of the driver implementation.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- IInputProcessor InputProcessor { get; }
|
|
|
|
|
|
|
+ string? GetName ();
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>Returns the name of the driver and relevant library version information.</summary>
|
|
|
|
|
+ /// <returns></returns>
|
|
|
|
|
+ string GetVersionInfo ();
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>Suspends the application (e.g. on Linux via SIGTSTP) and upon resume, resets the console driver.</summary>
|
|
|
|
|
+ /// <remarks>This is only implemented in UnixDriver.</remarks>
|
|
|
|
|
+ void Suspend ();
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// Describes the desired screen state. Data source for <see cref="IOutput"/>.
|
|
|
|
|
|
|
+ /// Gets whether the driver has detected the console requires legacy console API (Windows Console API without ANSI/VT
|
|
|
|
|
+ /// support).
|
|
|
|
|
+ /// Returns <see langword="true"/> for legacy consoles that don't support modern ANSI escape sequences (e.g. Windows
|
|
|
|
|
+ /// conhost);
|
|
|
|
|
+ /// <see langword="false"/> for modern terminals with ANSI/VT support.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- IOutputBuffer OutputBuffer { get; }
|
|
|
|
|
|
|
+ /// <remarks>
|
|
|
|
|
+ /// <para>
|
|
|
|
|
+ /// This property indicates whether the terminal supports modern ANSI escape sequences for input/output.
|
|
|
|
|
+ /// On Windows, this maps to whether Virtual Terminal processing is enabled.
|
|
|
|
|
+ /// On Unix-like systems, this is typically <see langword="false"/> as they support ANSI by default.
|
|
|
|
|
+ /// </para>
|
|
|
|
|
+ /// <para>
|
|
|
|
|
+ /// When <see langword="true"/>, the driver must use legacy Windows Console API functions
|
|
|
|
|
+ /// (e.g., WriteConsoleW, SetConsoleTextAttribute) instead of ANSI escape sequences.
|
|
|
|
|
+ /// </para>
|
|
|
|
|
+ /// </remarks>
|
|
|
|
|
+ bool IsLegacyConsole { get; internal set; }
|
|
|
|
|
+
|
|
|
|
|
+ #endregion Driver Lifecycle
|
|
|
|
|
+
|
|
|
|
|
+ #region Driver Components
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// Interface for classes responsible for reporting the current
|
|
|
|
|
- /// size of the terminal window.
|
|
|
|
|
|
|
+ /// Class responsible for processing native driver input objects
|
|
|
|
|
+ /// e.g. <see cref="ConsoleKeyInfo"/> into <see cref="Key"/> events
|
|
|
|
|
+ /// and detecting and processing ansi escape sequences.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- ISizeMonitor SizeMonitor { get; }
|
|
|
|
|
|
|
+ IInputProcessor InputProcessor { get; }
|
|
|
|
|
|
|
|
/// <summary>Get the operating system clipboard.</summary>
|
|
/// <summary>Get the operating system clipboard.</summary>
|
|
|
IClipboard? Clipboard { get; }
|
|
IClipboard? Clipboard { get; }
|
|
|
|
|
|
|
|
|
|
+ #endregion Driver Components
|
|
|
|
|
+
|
|
|
|
|
+ #region Screen and Display
|
|
|
|
|
+
|
|
|
/// <summary>Gets the location and size of the terminal screen.</summary>
|
|
/// <summary>Gets the location and size of the terminal screen.</summary>
|
|
|
Rectangle Screen { get; }
|
|
Rectangle Screen { get; }
|
|
|
|
|
|
|
@@ -43,49 +81,32 @@ public interface IDriver
|
|
|
void SetScreenSize (int width, int height);
|
|
void SetScreenSize (int width, int height);
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// Gets or sets the clip rectangle that <see cref="AddRune(Rune)"/> and <see cref="AddStr(string)"/> are subject
|
|
|
|
|
- /// to.
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- /// <value>The rectangle describing the of <see cref="Clip"/> region.</value>
|
|
|
|
|
- Region? Clip { get; set; }
|
|
|
|
|
-
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Gets the column last set by <see cref="Move"/>. <see cref="Col"/> and <see cref="Row"/> are used by
|
|
|
|
|
- /// <see cref="AddRune(Rune)"/> and <see cref="AddStr"/> to determine where to add content.
|
|
|
|
|
|
|
+ /// The event fired when the screen changes (size, position, etc.).
|
|
|
|
|
+ /// <see cref="Screen"/> is the source of truth for screen dimensions.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- int Col { get; }
|
|
|
|
|
|
|
+ event EventHandler<SizeChangedEventArgs>? SizeChanged;
|
|
|
|
|
|
|
|
/// <summary>The number of columns visible in the terminal.</summary>
|
|
/// <summary>The number of columns visible in the terminal.</summary>
|
|
|
int Cols { get; set; }
|
|
int Cols { get; set; }
|
|
|
|
|
|
|
|
- // BUGBUG: This should not be publicly settable.
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Gets or sets the contents of the application output. The driver outputs this buffer to the terminal.
|
|
|
|
|
- /// <remarks>The format of the array is rows, columns. The first index is the row, the second index is the column.</remarks>
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- Cell [,]? Contents { get; set; }
|
|
|
|
|
|
|
+ /// <summary>The number of rows visible in the terminal.</summary>
|
|
|
|
|
+ int Rows { get; set; }
|
|
|
|
|
|
|
|
/// <summary>The leftmost column in the terminal.</summary>
|
|
/// <summary>The leftmost column in the terminal.</summary>
|
|
|
int Left { get; set; }
|
|
int Left { get; set; }
|
|
|
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Gets the row last set by <see cref="Move"/>. <see cref="Col"/> and <see cref="Row"/> are used by
|
|
|
|
|
- /// <see cref="AddRune(Rune)"/> and <see cref="AddStr"/> to determine where to add content.
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- int Row { get; }
|
|
|
|
|
-
|
|
|
|
|
- /// <summary>The number of rows visible in the terminal.</summary>
|
|
|
|
|
- int Rows { get; set; }
|
|
|
|
|
-
|
|
|
|
|
/// <summary>The topmost row in the terminal.</summary>
|
|
/// <summary>The topmost row in the terminal.</summary>
|
|
|
int Top { get; set; }
|
|
int Top { get; set; }
|
|
|
|
|
|
|
|
|
|
+ #endregion Screen and Display
|
|
|
|
|
+
|
|
|
|
|
+ #region Color Support
|
|
|
|
|
+
|
|
|
/// <summary>Gets whether the <see cref="IDriver"/> supports TrueColor output.</summary>
|
|
/// <summary>Gets whether the <see cref="IDriver"/> supports TrueColor output.</summary>
|
|
|
bool SupportsTrueColor { get; }
|
|
bool SupportsTrueColor { get; }
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
/// Gets or sets whether the <see cref="IDriver"/> should use 16 colors instead of the default TrueColors.
|
|
/// Gets or sets whether the <see cref="IDriver"/> should use 16 colors instead of the default TrueColors.
|
|
|
- /// See <see cref="Application.Force16Colors"/> to change this setting via <see cref="ConfigurationManager"/>.
|
|
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
/// <remarks>
|
|
/// <remarks>
|
|
|
/// <para>
|
|
/// <para>
|
|
@@ -93,8 +114,51 @@ public interface IDriver
|
|
|
/// <see langword="false"/>, indicating that the <see cref="IDriver"/> cannot support TrueColor.
|
|
/// <see langword="false"/>, indicating that the <see cref="IDriver"/> cannot support TrueColor.
|
|
|
/// </para>
|
|
/// </para>
|
|
|
/// </remarks>
|
|
/// </remarks>
|
|
|
|
|
+ /// <seealso cref="Driver.Force16Colors"/>
|
|
|
bool Force16Colors { get; set; }
|
|
bool Force16Colors { get; set; }
|
|
|
|
|
|
|
|
|
|
+ #endregion Color Support
|
|
|
|
|
+
|
|
|
|
|
+ #region Content Buffer
|
|
|
|
|
+
|
|
|
|
|
+ // BUGBUG: This should not be publicly settable.
|
|
|
|
|
+ /// <summary>
|
|
|
|
|
+ /// Gets or sets the contents of the application output. The driver outputs this buffer to the terminal.
|
|
|
|
|
+ /// <remarks>The format of the array is rows, columns. The first index is the row, the second index is the column.</remarks>
|
|
|
|
|
+ /// </summary>
|
|
|
|
|
+ Cell [,]? Contents { get; set; }
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>
|
|
|
|
|
+ /// Gets or sets the clip rectangle that <see cref="AddRune(Rune)"/> and <see cref="AddStr(string)"/> are subject
|
|
|
|
|
+ /// to.
|
|
|
|
|
+ /// </summary>
|
|
|
|
|
+ /// <value>The rectangle describing the of <see cref="Clip"/> region.</value>
|
|
|
|
|
+ Region? Clip { get; set; }
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>Clears the <see cref="IDriver.Contents"/> of the driver.</summary>
|
|
|
|
|
+ void ClearContents ();
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>
|
|
|
|
|
+ /// Fills the specified rectangle with the specified rune, using <see cref="IDriver.CurrentAttribute"/>
|
|
|
|
|
+ /// </summary>
|
|
|
|
|
+ event EventHandler<EventArgs> ClearedContents;
|
|
|
|
|
+
|
|
|
|
|
+ #endregion Content Buffer
|
|
|
|
|
+
|
|
|
|
|
+ #region Drawing and Rendering
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>
|
|
|
|
|
+ /// Gets the column last set by <see cref="Move"/>. <see cref="Col"/> and <see cref="Row"/> are used by
|
|
|
|
|
+ /// <see cref="AddRune(Rune)"/> and <see cref="AddStr"/> to determine where to add content.
|
|
|
|
|
+ /// </summary>
|
|
|
|
|
+ int Col { get; }
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>
|
|
|
|
|
+ /// Gets the row last set by <see cref="Move"/>. <see cref="Col"/> and <see cref="Row"/> are used by
|
|
|
|
|
+ /// <see cref="AddRune(Rune)"/> and <see cref="AddStr"/> to determine where to add content.
|
|
|
|
|
+ /// </summary>
|
|
|
|
|
+ int Row { get; }
|
|
|
|
|
+
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
/// The <see cref="System.Attribute"/> that will be used for the next <see cref="AddRune(Rune)"/> or
|
|
/// The <see cref="System.Attribute"/> that will be used for the next <see cref="AddRune(Rune)"/> or
|
|
|
/// <see cref="AddStr"/>
|
|
/// <see cref="AddStr"/>
|
|
@@ -102,15 +166,23 @@ public interface IDriver
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
Attribute CurrentAttribute { get; set; }
|
|
Attribute CurrentAttribute { get; set; }
|
|
|
|
|
|
|
|
- /// <summary>Returns the name of the driver and relevant library version information.</summary>
|
|
|
|
|
- /// <returns></returns>
|
|
|
|
|
- string GetVersionInfo ();
|
|
|
|
|
-
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// Provide proper writing to send escape sequence recognized by the <see cref="IDriver"/>.
|
|
|
|
|
|
|
+ /// Updates <see cref="IDriver.Col"/> and <see cref="IDriver.Row"/> to the specified column and row in
|
|
|
|
|
+ /// <see cref="IDriver.Contents"/>.
|
|
|
|
|
+ /// Used by <see cref="IDriver.AddRune(System.Text.Rune)"/> and <see cref="IDriver.AddStr"/> to determine
|
|
|
|
|
+ /// where to add content.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- /// <param name="ansi"></param>
|
|
|
|
|
- void WriteRaw (string ansi);
|
|
|
|
|
|
|
+ /// <remarks>
|
|
|
|
|
+ /// <para>This does not move the cursor on the screen, it only updates the internal state of the driver.</para>
|
|
|
|
|
+ /// <para>
|
|
|
|
|
+ /// If <paramref name="col"/> or <paramref name="row"/> are negative or beyond <see cref="IDriver.Cols"/>
|
|
|
|
|
+ /// and
|
|
|
|
|
+ /// <see cref="IDriver.Rows"/>, the method still sets those properties.
|
|
|
|
|
+ /// </para>
|
|
|
|
|
+ /// </remarks>
|
|
|
|
|
+ /// <param name="col">Column to move to.</param>
|
|
|
|
|
+ /// <param name="row">Row to move to.</param>
|
|
|
|
|
+ void Move (int col, int row);
|
|
|
|
|
|
|
|
/// <summary>Tests if the specified rune is supported by the driver.</summary>
|
|
/// <summary>Tests if the specified rune is supported by the driver.</summary>
|
|
|
/// <param name="rune"></param>
|
|
/// <param name="rune"></param>
|
|
@@ -131,24 +203,6 @@ public interface IDriver
|
|
|
/// </returns>
|
|
/// </returns>
|
|
|
bool IsValidLocation (string text, int col, int row);
|
|
bool IsValidLocation (string text, int col, int row);
|
|
|
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Updates <see cref="IDriver.Col"/> and <see cref="IDriver.Row"/> to the specified column and row in
|
|
|
|
|
- /// <see cref="IDriver.Contents"/>.
|
|
|
|
|
- /// Used by <see cref="IDriver.AddRune(System.Text.Rune)"/> and <see cref="IDriver.AddStr"/> to determine
|
|
|
|
|
- /// where to add content.
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- /// <remarks>
|
|
|
|
|
- /// <para>This does not move the cursor on the screen, it only updates the internal state of the driver.</para>
|
|
|
|
|
- /// <para>
|
|
|
|
|
- /// If <paramref name="col"/> or <paramref name="row"/> are negative or beyond <see cref="IDriver.Cols"/>
|
|
|
|
|
- /// and
|
|
|
|
|
- /// <see cref="IDriver.Rows"/>, the method still sets those properties.
|
|
|
|
|
- /// </para>
|
|
|
|
|
- /// </remarks>
|
|
|
|
|
- /// <param name="col">Column to move to.</param>
|
|
|
|
|
- /// <param name="row">Row to move to.</param>
|
|
|
|
|
- void Move (int col, int row);
|
|
|
|
|
-
|
|
|
|
|
/// <summary>Adds the specified rune to the display at the current cursor position.</summary>
|
|
/// <summary>Adds the specified rune to the display at the current cursor position.</summary>
|
|
|
/// <remarks>
|
|
/// <remarks>
|
|
|
/// <para>
|
|
/// <para>
|
|
@@ -189,14 +243,6 @@ public interface IDriver
|
|
|
/// <param name="str">String.</param>
|
|
/// <param name="str">String.</param>
|
|
|
void AddStr (string str);
|
|
void AddStr (string str);
|
|
|
|
|
|
|
|
- /// <summary>Clears the <see cref="IDriver.Contents"/> of the driver.</summary>
|
|
|
|
|
- void ClearContents ();
|
|
|
|
|
-
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Fills the specified rectangle with the specified rune, using <see cref="IDriver.CurrentAttribute"/>
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- event EventHandler<EventArgs> ClearedContents;
|
|
|
|
|
-
|
|
|
|
|
/// <summary>Fills the specified rectangle with the specified rune, using <see cref="IDriver.CurrentAttribute"/></summary>
|
|
/// <summary>Fills the specified rectangle with the specified rune, using <see cref="IDriver.CurrentAttribute"/></summary>
|
|
|
/// <remarks>
|
|
/// <remarks>
|
|
|
/// The value of <see cref="IDriver.Clip"/> is honored. Any parts of the rectangle not in the clip will not be
|
|
/// The value of <see cref="IDriver.Clip"/> is honored. Any parts of the rectangle not in the clip will not be
|
|
@@ -214,31 +260,43 @@ public interface IDriver
|
|
|
/// <param name="c"></param>
|
|
/// <param name="c"></param>
|
|
|
void FillRect (Rectangle rect, char c);
|
|
void FillRect (Rectangle rect, char c);
|
|
|
|
|
|
|
|
- /// <summary>Gets the terminal cursor visibility.</summary>
|
|
|
|
|
- /// <param name="visibility">The current <see cref="CursorVisibility"/></param>
|
|
|
|
|
- /// <returns><see langword="true"/> upon success</returns>
|
|
|
|
|
- bool GetCursorVisibility (out CursorVisibility visibility);
|
|
|
|
|
|
|
+ /// <summary>Selects the specified attribute as the attribute to use for future calls to AddRune and AddString.</summary>
|
|
|
|
|
+ /// <remarks>Implementations should call <c>base.SetAttribute(c)</c>.</remarks>
|
|
|
|
|
+ /// <param name="c">C.</param>
|
|
|
|
|
+ Attribute SetAttribute (Attribute c);
|
|
|
|
|
+
|
|
|
|
|
+ /// <summary>Gets the current <see cref="Attribute"/>.</summary>
|
|
|
|
|
+ /// <returns>The current attribute.</returns>
|
|
|
|
|
+ Attribute GetAttribute ();
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// INTERNAL: Updates the terminal with the current output buffer. Should not be used by applications. Drawing occurs
|
|
|
|
|
- /// once each Application main loop iteration.
|
|
|
|
|
|
|
+ /// Provide proper writing to send escape sequence recognized by the <see cref="IDriver"/>.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- void Refresh ();
|
|
|
|
|
|
|
+ /// <param name="ansi"></param>
|
|
|
|
|
+ void WriteRaw (string ansi);
|
|
|
|
|
|
|
|
- /// <summary>Sets the terminal cursor visibility.</summary>
|
|
|
|
|
- /// <param name="visibility">The wished <see cref="CursorVisibility"/></param>
|
|
|
|
|
- /// <returns><see langword="true"/> upon success</returns>
|
|
|
|
|
- bool SetCursorVisibility (CursorVisibility visibility);
|
|
|
|
|
|
|
+ /// <summary>
|
|
|
|
|
+ /// Gets the queue of sixel images to write out to screen when updating.
|
|
|
|
|
+ /// If the terminal does not support Sixel, adding to this queue has no effect.
|
|
|
|
|
+ /// </summary>
|
|
|
|
|
+ ConcurrentQueue<SixelToRender> GetSixels ();
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
- /// The event fired when the screen changes (size, position, etc.).
|
|
|
|
|
- /// <see cref="Screen"/> is the source of truth for screen dimensions.
|
|
|
|
|
|
|
+ /// Gets a string representation of <see cref="Contents"/>.
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
- event EventHandler<SizeChangedEventArgs>? SizeChanged;
|
|
|
|
|
|
|
+ /// <returns></returns>
|
|
|
|
|
+ public string ToString ();
|
|
|
|
|
|
|
|
- /// <summary>Suspends the application (e.g. on Linux via SIGTSTP) and upon resume, resets the console driver.</summary>
|
|
|
|
|
- /// <remarks>This is only implemented in UnixDriver.</remarks>
|
|
|
|
|
- void Suspend ();
|
|
|
|
|
|
|
+ /// <summary>
|
|
|
|
|
+ /// Gets an ANSI escape sequence representation of <see cref="Contents"/>. This is the
|
|
|
|
|
+ /// same output as would be written to the terminal to recreate the current screen contents.
|
|
|
|
|
+ /// </summary>
|
|
|
|
|
+ /// <returns></returns>
|
|
|
|
|
+ public string ToAnsi ();
|
|
|
|
|
+
|
|
|
|
|
+ #endregion Drawing and Rendering
|
|
|
|
|
+
|
|
|
|
|
+ #region Cursor
|
|
|
|
|
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
/// Sets the position of the terminal cursor to <see cref="IDriver.Col"/> and
|
|
/// Sets the position of the terminal cursor to <see cref="IDriver.Col"/> and
|
|
@@ -246,20 +304,19 @@ public interface IDriver
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
void UpdateCursor ();
|
|
void UpdateCursor ();
|
|
|
|
|
|
|
|
- /// <summary>Initializes the driver</summary>
|
|
|
|
|
- void Init ();
|
|
|
|
|
|
|
+ /// <summary>Gets the terminal cursor visibility.</summary>
|
|
|
|
|
+ /// <param name="visibility">The current <see cref="CursorVisibility"/></param>
|
|
|
|
|
+ /// <returns><see langword="true"/> upon success</returns>
|
|
|
|
|
+ bool GetCursorVisibility (out CursorVisibility visibility);
|
|
|
|
|
|
|
|
- /// <summary>Ends the execution of the console driver.</summary>
|
|
|
|
|
- void End ();
|
|
|
|
|
|
|
+ /// <summary>Sets the terminal cursor visibility.</summary>
|
|
|
|
|
+ /// <param name="visibility">The wished <see cref="CursorVisibility"/></param>
|
|
|
|
|
+ /// <returns><see langword="true"/> upon success</returns>
|
|
|
|
|
+ bool SetCursorVisibility (CursorVisibility visibility);
|
|
|
|
|
|
|
|
- /// <summary>Selects the specified attribute as the attribute to use for future calls to AddRune and AddString.</summary>
|
|
|
|
|
- /// <remarks>Implementations should call <c>base.SetAttribute(c)</c>.</remarks>
|
|
|
|
|
- /// <param name="c">C.</param>
|
|
|
|
|
- Attribute SetAttribute (Attribute c);
|
|
|
|
|
|
|
+ #endregion Cursor
|
|
|
|
|
|
|
|
- /// <summary>Gets the current <see cref="Attribute"/>.</summary>
|
|
|
|
|
- /// <returns>The current attribute.</returns>
|
|
|
|
|
- Attribute GetAttribute ();
|
|
|
|
|
|
|
+ #region Input Events
|
|
|
|
|
|
|
|
/// <summary>Event fired when a mouse event occurs.</summary>
|
|
/// <summary>Event fired when a mouse event occurs.</summary>
|
|
|
event EventHandler<MouseEventArgs>? MouseEvent;
|
|
event EventHandler<MouseEventArgs>? MouseEvent;
|
|
@@ -281,28 +338,15 @@ public interface IDriver
|
|
|
/// <param name="key"></param>
|
|
/// <param name="key"></param>
|
|
|
void EnqueueKeyEvent (Key key);
|
|
void EnqueueKeyEvent (Key key);
|
|
|
|
|
|
|
|
|
|
+ #endregion Input Events
|
|
|
|
|
+
|
|
|
|
|
+ #region ANSI Escape Sequences
|
|
|
|
|
+
|
|
|
/// <summary>
|
|
/// <summary>
|
|
|
/// Queues the given <paramref name="request"/> for execution
|
|
/// Queues the given <paramref name="request"/> for execution
|
|
|
/// </summary>
|
|
/// </summary>
|
|
|
/// <param name="request"></param>
|
|
/// <param name="request"></param>
|
|
|
public void QueueAnsiRequest (AnsiEscapeSequenceRequest request);
|
|
public void QueueAnsiRequest (AnsiEscapeSequenceRequest request);
|
|
|
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Gets the <see cref="AnsiRequestScheduler"/> for the driver
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- /// <returns></returns>
|
|
|
|
|
- public AnsiRequestScheduler GetRequestScheduler ();
|
|
|
|
|
-
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Gets a string representation of <see cref="Contents"/>.
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- /// <returns></returns>
|
|
|
|
|
- public string ToString ();
|
|
|
|
|
-
|
|
|
|
|
- /// <summary>
|
|
|
|
|
- /// Gets an ANSI escape sequence representation of <see cref="Contents"/>. This is the
|
|
|
|
|
- /// same output as would be written to the terminal to recreate the current screen contents.
|
|
|
|
|
- /// </summary>
|
|
|
|
|
- /// <returns></returns>
|
|
|
|
|
- public string ToAnsi ();
|
|
|
|
|
|
|
+ #endregion ANSI Escape Sequences
|
|
|
}
|
|
}
|