using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
namespace Terminal.Gui {
///
/// Text alignment enumeration, controls how text is displayed.
///
public enum TextAlignment {
///
/// The text will be left-aligned.
///
Left,
///
/// The text will be right-aligned.
///
Right,
///
/// The text will be centered horizontally.
///
Centered,
///
/// The text will be justified (spaces will be added to existing spaces such that
/// the text fills the container horizontally).
///
Justified
}
///
/// Vertical text alignment enumeration, controls how text is displayed.
///
public enum VerticalTextAlignment {
///
/// The text will be top-aligned.
///
Top,
///
/// The text will be bottom-aligned.
///
Bottom,
///
/// The text will centered vertically.
///
Middle,
///
/// The text will be justified (spaces will be added to existing spaces such that
/// the text fills the container vertically).
///
Justified
}
/// TextDirection [H] = Horizontal [V] = Vertical
/// =============
/// LeftRight_TopBottom [H] Normal
/// TopBottom_LeftRight [V] Normal
///
/// RightLeft_TopBottom [H] Invert Text
/// TopBottom_RightLeft [V] Invert Lines
///
/// LeftRight_BottomTop [H] Invert Lines
/// BottomTop_LeftRight [V] Invert Text
///
/// RightLeft_BottomTop [H] Invert Text + Invert Lines
/// BottomTop_RightLeft [V] Invert Text + Invert Lines
///
///
/// Text direction enumeration, controls how text is displayed.
///
public enum TextDirection {
///
/// Normal horizontal direction.
/// HELLO
WORLD
///
LeftRight_TopBottom,
///
/// Normal vertical direction.
/// H W
E O
L R
L L
O D
///
TopBottom_LeftRight,
///
/// This is a horizontal direction.
RTL
/// OLLEH
DLROW
///
RightLeft_TopBottom,
///
/// This is a vertical direction.
/// W H
O E
R L
L L
D O
///
TopBottom_RightLeft,
///
/// This is a horizontal direction.
/// WORLD
HELLO
///
LeftRight_BottomTop,
///
/// This is a vertical direction.
/// O D
L L
L R
E O
H W
///
BottomTop_LeftRight,
///
/// This is a horizontal direction.
/// DLROW
OLLEH
///
RightLeft_BottomTop,
///
/// This is a vertical direction.
/// D O
L L
R L
O E
W H
///
BottomTop_RightLeft
}
///
/// Provides text formatting. Supports s, horizontal alignment, vertical alignment, multiple lines, and word-based line wrap.
///
public class TextFormatter {
#region Static Members
static string StripCRLF (string str, bool keepNewLine = false)
{
var runes = str.ToRuneList ();
for (int i = 0; i < runes.Count; i++) {
switch ((char)runes [i].Value) {
case '\n':
if (!keepNewLine) {
runes.RemoveAt (i);
}
break;
case '\r':
if ((i + 1) < runes.Count && runes [i + 1].Value == '\n') {
runes.RemoveAt (i);
if (!keepNewLine) {
runes.RemoveAt (i);
}
i++;
} else {
if (!keepNewLine) {
runes.RemoveAt (i);
}
}
break;
}
}
return StringExtensions.ToString (runes);
}
static string ReplaceCRLFWithSpace (string str)
{
var runes = str.ToRuneList ();
for (int i = 0; i < runes.Count; i++) {
switch (runes [i].Value) {
case '\n':
runes [i] = (Rune)' ';
break;
case '\r':
if ((i + 1) < runes.Count && runes [i + 1].Value == '\n') {
runes [i] = (Rune)' ';
runes.RemoveAt (i + 1);
i++;
} else {
runes [i] = (Rune)' ';
}
break;
}
}
return StringExtensions.ToString (runes);
}
static string ReplaceTABWithSpaces (string str, int tabWidth)
{
if (tabWidth == 0) {
return str.Replace ("\t", "");
}
return str.Replace ("\t", new string (' ', tabWidth));
}
///
/// Splits all newlines in the into a list
/// and supports both CRLF and LF, preserving the ending newline.
///
/// The text.
/// A list of text without the newline characters.
public static List SplitNewLine (string text)
{
var runes = text.ToRuneList ();
var lines = new List ();
var start = 0;
var end = 0;
for (int i = 0; i < runes.Count; i++) {
end = i;
switch (runes [i].Value) {
case '\n':
lines.Add (StringExtensions.ToString (runes.GetRange (start, end - start)));
i++;
start = i;
break;
case '\r':
if ((i + 1) < runes.Count && runes [i + 1].Value == '\n') {
lines.Add (StringExtensions.ToString (runes.GetRange (start, end - start)));
i += 2;
start = i;
} else {
lines.Add (StringExtensions.ToString (runes.GetRange (start, end - start)));
i++;
start = i;
}
break;
}
}
if (runes.Count > 0 && lines.Count == 0) {
lines.Add (StringExtensions.ToString (runes));
} else if (runes.Count > 0 && start < runes.Count) {
lines.Add (StringExtensions.ToString (runes.GetRange (start, runes.Count - start)));
} else {
lines.Add ("");
}
return lines;
}
///
/// Adds trailing whitespace or truncates
/// so that it fits exactly console units.
/// Note that some unicode characters take 2+ columns
///
///
///
///
public static string ClipOrPad (string text, int width)
{
if (string.IsNullOrEmpty (text))
return text;
// if value is not wide enough
if (text.EnumerateRunes ().Sum (c => c.GetColumns ()) < width) {
// pad it out with spaces to the given alignment
int toPad = width - (text.EnumerateRunes ().Sum (c => c.GetColumns ()));
return text + new string (' ', toPad);
}
// value is too wide
return new string (text.TakeWhile (c => (width -= ((Rune)c).GetColumns ()) >= 0).ToArray ());
}
///
/// Formats the provided text to fit within the width provided using word wrapping.
///
/// The text to word wrap
/// The number of columns to constrain the text to
/// If trailing spaces at the end of wrapped lines will be preserved.
/// If , trailing spaces at the end of wrapped lines will be trimmed.
/// The number of columns used for a tab.
/// The text direction.
/// A list of word wrapped lines.
///
///
/// This method does not do any justification.
///
///
/// This method strips Newline ('\n' and '\r\n') sequences before processing.
///
///
/// If is at most one space will be preserved at the end of the last line.
///
///
public static List WordWrapText (string text, int width, bool preserveTrailingSpaces = false, int tabWidth = 0,
TextDirection textDirection = TextDirection.LeftRight_TopBottom)
{
if (width < 0) {
throw new ArgumentOutOfRangeException ("Width cannot be negative.");
}
int start = 0, end;
var lines = new List ();
if (string.IsNullOrEmpty (text)) {
return lines;
}
var runes = StripCRLF (text).ToRuneList ();
if (preserveTrailingSpaces) {
while ((end = start) < runes.Count) {
end = GetNextWhiteSpace (start, width, out bool incomplete);
if (end == 0 && incomplete) {
start = text.GetRuneCount ();
break;
}
lines.Add (StringExtensions.ToString (runes.GetRange (start, end - start)));
start = end;
if (incomplete) {
start = text.GetRuneCount ();
break;
}
}
} else {
if (IsHorizontalDirection (textDirection)) {
//if (GetLengthThatFits (runes.GetRange (start, runes.Count - start), width) > 0) {
// // while there's still runes left and end is not past end...
// while (start < runes.Count &&
// (end = start + Math.Max (GetLengthThatFits (runes.GetRange (start, runes.Count - start), width) - 1, 0)) < runes.Count) {
// // end now points to start + LengthThatFits
// // Walk back over trailing spaces
// while (runes [end] == ' ' && end > start) {
// end--;
// }
// // end now points to start + LengthThatFits - any trailing spaces; start saving new line
// var line = runes.GetRange (start, end - start + 1);
// if (end == start && width > 1) {
// // it was all trailing spaces; now walk forward to next non-space
// do {
// start++;
// } while (start < runes.Count && runes [start] == ' ');
// // start now points to first non-space we haven't seen yet or we're done
// if (start < runes.Count) {
// // we're not done. we have remaining = width - line.Count columns left;
// var remaining = width - line.Count;
// if (remaining > 1) {
// // add a space for all the spaces we walked over
// line.Add (' ');
// }
// var count = GetLengthThatFits (runes.GetRange (start, runes.Count - start), width - line.Count);
// // [start..count] now has rest of line
// line.AddRange (runes.GetRange (start, count));
// start += count;
// }
// } else {
// start += line.Count;
// }
// //// if the previous line was just a ' ' and the new line is just a ' '
// //// don't add new line
// //if (line [0] == ' ' && (lines.Count > 0 && lines [lines.Count - 1] [0] == ' ')) {
// //} else {
// //}
// lines.Add (string.Make (line));
// // move forward to next non-space
// while (width > 1 && start < runes.Count && runes [start] == ' ') {
// start++;
// }
// }
//}
while ((end = start + GetLengthThatFits (runes.GetRange (start, runes.Count - start), width, tabWidth)) < runes.Count) {
while (runes [end].Value != ' ' && end > start)
end--;
if (end == start)
end = start + GetLengthThatFits (runes.GetRange (end, runes.Count - end), width, tabWidth);
var str = StringExtensions.ToString (runes.GetRange (start, end - start));
if (end > start && GetRuneWidth (str, tabWidth) <= width) {
lines.Add (str);
start = end;
if (runes [end].Value == ' ') {
start++;
}
} else {
end++;
start = end;
}
}
} else {
while ((end = start + width) < runes.Count) {
while (runes [end].Value != ' ' && end > start) {
end--;
}
if (end == start) {
end = start + width;
}
var zeroLength = 0;
for (int i = end; i < runes.Count - start; i++) {
var r = runes [i];
if (r.GetColumns () == 0) {
zeroLength++;
} else {
break;
}
}
lines.Add (StringExtensions.ToString (runes.GetRange (start, end - start + zeroLength)));
end += zeroLength;
start = end;
if (runes [end].Value == ' ') {
start++;
}
}
}
}
int GetNextWhiteSpace (int from, int cWidth, out bool incomplete, int cLength = 0)
{
var lastFrom = from;
var to = from;
var length = cLength;
incomplete = false;
while (length < cWidth && to < runes.Count) {
var rune = runes [to];
if (IsHorizontalDirection (textDirection)) {
length += rune.GetColumns ();
} else {
length++;
}
if (length > cWidth) {
if (to >= runes.Count || (length > 1 && cWidth <= 1)) {
incomplete = true;
}
return to;
}
if (rune.Value == ' ') {
if (length == cWidth) {
return to + 1;
} else if (length > cWidth) {
return to;
} else {
return GetNextWhiteSpace (to + 1, cWidth, out incomplete, length);
}
} else if (rune.Value == '\t') {
length += tabWidth + 1;
if (length == tabWidth && tabWidth > cWidth) {
return to + 1;
} else if (length > cWidth && tabWidth > cWidth) {
return to;
} else {
return GetNextWhiteSpace (to + 1, cWidth, out incomplete, length);
}
}
to++;
}
if (cLength > 0 && to < runes.Count && runes [to].Value != ' ' && runes [to].Value != '\t') {
return from;
} else if (cLength > 0 && to < runes.Count && (runes [to].Value == ' ' || runes [to].Value == '\t')) {
return lastFrom;
} else {
return to;
}
}
if (start < text.GetRuneCount ()) {
var str = ReplaceTABWithSpaces (StringExtensions.ToString (runes.GetRange (start, runes.Count - start)), tabWidth);
if (IsVerticalDirection (textDirection) || preserveTrailingSpaces || (!preserveTrailingSpaces && str.GetColumns () <= width)) {
lines.Add (str);
}
}
return lines;
}
///
/// Justifies text within a specified width.
///
/// The text to justify.
/// The number of columns to clip the text to. Text longer than will be clipped.
/// Alignment.
/// The text direction.
/// The number of columns used for a tab.
/// Justified and clipped text.
public static string ClipAndJustify (string text, int width, TextAlignment talign, TextDirection textDirection = TextDirection.LeftRight_TopBottom, int tabWidth = 0)
{
return ClipAndJustify (text, width, talign == TextAlignment.Justified, textDirection, tabWidth);
}
///
/// Justifies text within a specified width.
///
/// The text to justify.
/// The number of columns to clip the text to. Text longer than will be clipped.
/// Justify.
/// The text direction.
/// The number of columns used for a tab.
/// Justified and clipped text.
public static string ClipAndJustify (string text, int width, bool justify, TextDirection textDirection = TextDirection.LeftRight_TopBottom, int tabWidth = 0)
{
if (width < 0) {
throw new ArgumentOutOfRangeException ("Width cannot be negative.");
}
if (string.IsNullOrEmpty (text)) {
return text;
}
text = ReplaceTABWithSpaces (text, tabWidth);
var runes = text.ToRuneList ();
int slen = runes.Count;
if (slen > width) {
if (IsHorizontalDirection (textDirection)) {
return StringExtensions.ToString (runes.GetRange (0, GetLengthThatFits (text, width, tabWidth)));
} else {
var zeroLength = runes.Sum (r => r.GetColumns () == 0 ? 1 : 0);
return StringExtensions.ToString (runes.GetRange (0, width + zeroLength));
}
} else {
if (justify) {
return Justify (text, width, ' ', textDirection, tabWidth);
} else if (IsHorizontalDirection (textDirection) && GetRuneWidth (text, tabWidth) > width) {
return StringExtensions.ToString (runes.GetRange (0, GetLengthThatFits (text, width, tabWidth)));
}
return text;
}
}
///
/// Justifies the text to fill the width provided. Space will be added between words (demarked by spaces and tabs) to
/// make the text just fit width. Spaces will not be added to the ends.
///
///
///
/// Character to replace whitespace and pad with. For debugging purposes.
/// The text direction.
/// The number of columns used for a tab.
/// The justified text.
public static string Justify (string text, int width, char spaceChar = ' ', TextDirection textDirection = TextDirection.LeftRight_TopBottom, int tabWidth = 0)
{
if (width < 0) {
throw new ArgumentOutOfRangeException ("Width cannot be negative.");
}
if (string.IsNullOrEmpty (text)) {
return text;
}
text = ReplaceTABWithSpaces (text, tabWidth);
var words = text.Split (' ');
int textCount;
if (IsHorizontalDirection (textDirection)) {
textCount = words.Sum (arg => GetRuneWidth (arg, tabWidth));
} else {
textCount = words.Sum (arg => arg.GetRuneCount ());
}
var spaces = words.Length > 1 ? (width - textCount) / (words.Length - 1) : 0;
var extras = words.Length > 1 ? (width - textCount) % (words.Length - 1) : 0;
var s = new System.Text.StringBuilder ();
for (int w = 0; w < words.Length; w++) {
var x = words [w];
s.Append (x);
if (w + 1 < words.Length)
for (int i = 0; i < spaces; i++)
s.Append (spaceChar);
if (extras > 0) {
for (int i = 0; i < 1; i++)
s.Append (spaceChar);
extras--;
}
if (w + 1 == words.Length - 1) {
for (int i = 0; i < extras; i++)
s.Append (spaceChar);
}
}
return s.ToString ();
}
//static char [] whitespace = new char [] { ' ', '\t' };
///
/// Reformats text into lines, applying text alignment and optionally wrapping text to new lines on word boundaries.
///
///
/// The number of columns to constrain the text to for word wrapping and clipping.
/// Specifies how the text will be aligned horizontally.
/// If , the text will be wrapped to new lines no longer than .
/// If , forces text to fit a single line. Line breaks are converted to spaces. The text will be clipped to .
/// If trailing spaces at the end of wrapped lines will be preserved.
/// If , trailing spaces at the end of wrapped lines will be trimmed.
/// The number of columns used for a tab.
/// The text direction.
/// If new lines are allowed.
/// A list of word wrapped lines.
///
///
/// An empty string will result in one empty line.
///
///
/// If is 0, a single, empty line will be returned.
///
///
/// If is int.MaxValue, the text will be formatted to the maximum width possible.
///
///
public static List Format (string text, int width, TextAlignment talign, bool wordWrap, bool preserveTrailingSpaces = false, int tabWidth = 0, TextDirection textDirection = TextDirection.LeftRight_TopBottom, bool multiLine = false)
{
return Format (text, width, talign == TextAlignment.Justified, wordWrap, preserveTrailingSpaces, tabWidth, textDirection, multiLine);
}
///
/// Reformats text into lines, applying text alignment and optionally wrapping text to new lines on word boundaries.
///
///
/// The number of columns to constrain the text to for word wrapping and clipping.
/// Specifies whether the text should be justified.
/// If , the text will be wrapped to new lines no longer than .
/// If , forces text to fit a single line. Line breaks are converted to spaces. The text will be clipped to .
/// If trailing spaces at the end of wrapped lines will be preserved.
/// If , trailing spaces at the end of wrapped lines will be trimmed.
/// The number of columns used for a tab.
/// The text direction.
/// If new lines are allowed.
/// A list of word wrapped lines.
///
///
/// An empty string will result in one empty line.
///
///
/// If is 0, a single, empty line will be returned.
///
///
/// If is int.MaxValue, the text will be formatted to the maximum width possible.
///
///
public static List Format (string text, int width, bool justify, bool wordWrap,
bool preserveTrailingSpaces = false, int tabWidth = 0, TextDirection textDirection = TextDirection.LeftRight_TopBottom, bool multiLine = false)
{
if (width < 0) {
throw new ArgumentOutOfRangeException ("width cannot be negative");
}
List lineResult = new List ();
if (string.IsNullOrEmpty (text) || width == 0) {
lineResult.Add (string.Empty);
return lineResult;
}
if (!wordWrap) {
text = ReplaceTABWithSpaces (text, tabWidth);
if (multiLine) {
string [] lines = null;
if (text.Contains ("\r\n")) {
lines = text.Split ("\r\n");
} else if (text.Contains ('\n')) {
lines = text.Split ('\n');
}
if (lines == null) {
lines = new [] { text };
}
foreach (var line in lines) {
lineResult.Add (ClipAndJustify (line, width, justify, textDirection, tabWidth));
}
return lineResult;
} else {
text = ReplaceCRLFWithSpace (text);
lineResult.Add (ClipAndJustify (text, width, justify, textDirection, tabWidth));
return lineResult;
}
}
var runes = StripCRLF (text, true).ToRuneList ();
int runeCount = runes.Count;
int lp = 0;
for (int i = 0; i < runeCount; i++) {
Rune c = runes [i];
if (c.Value == '\n') {
var wrappedLines = WordWrapText (StringExtensions.ToString (runes.GetRange (lp, i - lp)), width, preserveTrailingSpaces, tabWidth, textDirection);
foreach (var line in wrappedLines) {
lineResult.Add (ClipAndJustify (line, width, justify, textDirection, tabWidth));
}
if (wrappedLines.Count == 0) {
lineResult.Add (string.Empty);
}
lp = i + 1;
}
}
foreach (var line in WordWrapText (StringExtensions.ToString (runes.GetRange (lp, runeCount - lp)), width, preserveTrailingSpaces, tabWidth, textDirection)) {
lineResult.Add (ClipAndJustify (line, width, justify, textDirection, tabWidth));
}
return lineResult;
}
///
/// Computes the number of lines needed to render the specified text given the width.
///
/// Number of lines.
/// Text, may contain newlines.
/// The minimum width for the text.
public static int MaxLines (string text, int width)
{
var result = TextFormatter.Format (text, width, false, true);
return result.Count;
}
///
/// Computes the maximum width needed to render the text (single line or multiple lines, word wrapped) given
/// a number of columns to constrain the text to.
///
/// Width of the longest line after formatting the text constrained by .
/// Text, may contain newlines.
/// The number of columns to constrain the text to for formatting.
/// The number of columns used for a tab.
public static int MaxWidth (string text, int maxColumns, int tabWidth = 0)
{
var result = TextFormatter.Format (text: text, width: maxColumns, justify: false, wordWrap: true);
var max = 0;
result.ForEach (s => {
var m = 0;
s.ToRuneList ().ForEach (r => m += GetRuneWidth (r, tabWidth));
if (m > max) {
max = m;
}
});
return max;
}
///
/// Returns the width of the widest line in the text, accounting for wide-glyphs (uses ).
/// if it contains newlines.
///
/// Text, may contain newlines.
/// The number of columns used for a tab.
/// The length of the longest line.
public static int MaxWidthLine (string text, int tabWidth = 0)
{
var result = TextFormatter.SplitNewLine (text);
return result.Max (x => GetRuneWidth (x, tabWidth));
}
///
/// Gets the maximum characters width from the list based on the
/// and the .
///
/// The lines.
/// The start index.
/// The length.
/// The number of columns used for a tab.
/// The maximum characters width.
public static int GetSumMaxCharWidth (List lines, int startIndex = -1, int length = -1, int tabWidth = 0)
{
var max = 0;
for (int i = (startIndex == -1 ? 0 : startIndex); i < (length == -1 ? lines.Count : startIndex + length); i++) {
var runes = lines [i];
if (runes.Length > 0)
max += runes.EnumerateRunes ().Max (r => GetRuneWidth (r, tabWidth));
}
return max;
}
///
/// Gets the maximum characters width from the text based on the
/// and the .
///
/// The text.
/// The start index.
/// The length.
/// The number of columns used for a tab.
/// The maximum characters width.
public static int GetSumMaxCharWidth (string text, int startIndex = -1, int length = -1, int tabWidth = 0)
{
var max = 0;
var runes = text.ToRunes ();
for (int i = (startIndex == -1 ? 0 : startIndex); i < (length == -1 ? runes.Length : startIndex + length); i++) {
max += GetRuneWidth (runes [i], tabWidth);
}
return max;
}
///
/// Gets the number of the Runes in a that will fit in .
///
/// The text.
/// The width.
/// The number of columns used for a tab.
/// The index of the text that fit the width.
public static int GetLengthThatFits (string text, int columns, int tabWidth = 0) => GetLengthThatFits (text?.ToRuneList (), columns, tabWidth);
///
/// Gets the number of the Runes in a list of Runes that will fit in .
///
/// The list of runes.
/// The width.
/// The number of columns used for a tab.
/// The index of the last Rune in that fit in .
public static int GetLengthThatFits (List runes, int columns, int tabWidth = 0)
{
if (runes == null || runes.Count == 0) {
return 0;
}
var runesLength = 0;
var runeIdx = 0;
for (; runeIdx < runes.Count; runeIdx++) {
var runeWidth = GetRuneWidth (runes [runeIdx], tabWidth);
if (runesLength + runeWidth > columns) {
break;
}
runesLength += runeWidth;
}
return runeIdx;
}
private static int GetRuneWidth (string str, int tabWidth)
{
return GetRuneWidth (str.EnumerateRunes ().ToList (), tabWidth);
}
private static int GetRuneWidth (List runes, int tabWidth)
{
return runes.Sum (r => GetRuneWidth (r, tabWidth));
}
private static int GetRuneWidth (Rune rune, int tabWidth)
{
var runeWidth = rune.GetColumns ();
if (rune.Value == '\t') {
return tabWidth;
}
if (runeWidth < 0 || runeWidth > 0) {
return Math.Max (runeWidth, 1);
}
return runeWidth;
}
///
/// Gets the index position from the list based on the .
///
/// The lines.
/// The width.
/// The number of columns used for a tab.
/// The index of the list that fit the width.
public static int GetMaxColsForWidth (List lines, int width, int tabWidth = 0)
{
var runesLength = 0;
var lineIdx = 0;
for (; lineIdx < lines.Count; lineIdx++) {
var runes = lines [lineIdx].ToRuneList ();
var maxRruneWidth = runes.Count > 0
? runes.Max (r => GetRuneWidth (r, tabWidth)) : 1;
if (runesLength + maxRruneWidth > width) {
break;
}
runesLength += maxRruneWidth;
}
return lineIdx;
}
///
/// Calculates the rectangle required to hold text, assuming no word wrapping or justification.
///
/// The x location of the rectangle
/// The y location of the rectangle
/// The text to measure
/// The text direction.
/// The number of columns used for a tab.
///
public static Rect CalcRect (int x, int y, string text, TextDirection direction = TextDirection.LeftRight_TopBottom, int tabWidth = 0)
{
if (string.IsNullOrEmpty (text)) {
return new Rect (new Point (x, y), Size.Empty);
}
int w, h;
if (IsHorizontalDirection (direction)) {
int mw = 0;
int ml = 1;
int cols = 0;
foreach (var rune in text.EnumerateRunes ()) {
if (rune.Value == '\n') {
ml++;
if (cols > mw) {
mw = cols;
}
cols = 0;
} else if (rune.Value != '\r') {
cols++;
var rw = 0;
if (rune.Value == '\t') {
rw += tabWidth - 1;
} else {
rw = ((Rune)rune).GetColumns ();
if (rw > 0) {
rw--;
} else if (rw == 0) {
cols--;
}
}
cols += rw;
}
}
if (cols > mw) {
mw = cols;
}
w = mw;
h = ml;
} else {
int vw = 1, cw = 1;
int vh = 0;
int rows = 0;
foreach (var rune in text.EnumerateRunes ()) {
if (rune.Value == '\n') {
vw++;
if (rows > vh) {
vh = rows;
}
rows = 0;
cw = 1;
} else if (rune.Value != '\r') {
rows++;
var rw = 0;
if (rune.Value == '\t') {
rw += tabWidth - 1;
rows += rw;
} else {
rw = ((Rune)rune).GetColumns ();
if (rw == 0) {
rows--;
} else if (cw < rw) {
cw = rw;
vw++;
}
}
}
}
if (rows > vh) {
vh = rows;
}
w = vw;
h = vh;
}
return new Rect (x, y, w, h);
}
///
/// Finds the HotKey and its location in text.
///
/// The text to look in.
/// The HotKey specifier (e.g. '_') to look for.
/// If true the legacy behavior of identifying the first upper case character as the HotKey will be enabled.
/// Regardless of the value of this parameter, hotKeySpecifier takes precedence.
/// Outputs the Rune index into text.
/// Outputs the hotKey. if not found.
/// true if a HotKey was found; false otherwise.
public static bool FindHotKey (string text, Rune hotKeySpecifier, bool firstUpperCase, out int hotPos, out Key hotKey)
{
if (string.IsNullOrEmpty (text) || hotKeySpecifier == (Rune)0xFFFF) {
hotPos = -1;
hotKey = KeyCode.Null;
return false;
}
Rune hot_key = (Rune)0;
int hot_pos = -1;
// Use first hot_key char passed into 'hotKey'.
// TODO: Ignore hot_key of two are provided
// TODO: Do not support non-alphanumeric chars that can't be typed
int i = 0;
foreach (Rune c in text.EnumerateRunes ()) {
if ((char)c.Value != 0xFFFD) {
if (c == hotKeySpecifier) {
hot_pos = i;
} else if (hot_pos > -1) {
hot_key = c;
break;
}
}
i++;
}
// Legacy support - use first upper case char if the specifier was not found
if (hot_pos == -1 && firstUpperCase) {
i = 0;
foreach (Rune c in text.EnumerateRunes ()) {
if ((char)c.Value != 0xFFFD) {
if (Rune.IsUpper (c)) {
hot_key = c;
hot_pos = i;
break;
}
}
i++;
}
}
if (hot_key != (Rune)0 && hot_pos != -1) {
hotPos = hot_pos;
var newHotKey = (KeyCode)hot_key.Value;
if (newHotKey != KeyCode.Unknown && newHotKey != KeyCode.Null && !(newHotKey == KeyCode.Space || Rune.IsControl (hot_key))) {
if ((newHotKey & ~KeyCode.Space) is >= KeyCode.A and <= KeyCode.Z) {
newHotKey &= ~KeyCode.Space;
}
hotKey = newHotKey;
return true;
}
}
hotPos = -1;
hotKey = KeyCode.Null;
return false;
}
///
/// Replaces the Rune at the index specified by the hotPos parameter with a tag identifying
/// it as the hotkey.
///
/// The text to tag the hotkey in.
/// The Rune index of the hotkey in text.
/// The text with the hotkey tagged.
///
/// The returned string will not render correctly without first un-doing the tag. To undo the tag, search for
///
public string ReplaceHotKeyWithTag (string text, int hotPos)
{
// Set the high bit
var runes = text.ToRuneList ();
if (Rune.IsLetterOrDigit (runes [hotPos])) {
runes [hotPos] = new Rune ((uint)runes [hotPos].Value);
}
return StringExtensions.ToString (runes);
}
///
/// Removes the hotkey specifier from text.
///
/// The text to manipulate.
/// The hot-key specifier (e.g. '_') to look for.
/// Returns the position of the hot-key in the text. -1 if not found.
/// The input text with the hotkey specifier ('_') removed.
public static string RemoveHotKeySpecifier (string text, int hotPos, Rune hotKeySpecifier)
{
if (string.IsNullOrEmpty (text)) {
return text;
}
// Scan
string start = string.Empty;
int i = 0;
foreach (Rune c in text) {
if (c == hotKeySpecifier && i == hotPos) {
i++;
continue;
}
start += c;
i++;
}
return start;
}
#endregion // Static Members
List _lines = new List ();
string _text = null;
TextAlignment _textAlignment;
VerticalTextAlignment _textVerticalAlignment;
TextDirection _textDirection;
Key _hotKey = new Key ();
int _hotKeyPos = -1;
Size _size;
private bool _autoSize;
private bool _preserveTrailingSpaces;
private int _tabWidth = 4;
private bool _wordWrap = true;
private bool _multiLine;
///
/// Event invoked when the is changed.
///
public event EventHandler HotKeyChanged;
///
/// The text to be displayed. This string is never modified.
///
public virtual string Text {
get => _text;
set {
var textWasNull = _text == null && value != null;
_text = EnableNeedsFormat (value);
if ((AutoSize && Alignment != TextAlignment.Justified && VerticalAlignment != VerticalTextAlignment.Justified) || (textWasNull && Size.IsEmpty)) {
Size = CalcRect (0, 0, _text, _textDirection, TabWidth).Size;
}
//if (_text != null && _text.GetRuneCount () > 0 && (Size.Width == 0 || Size.Height == 0 || Size.Width != _text.GetColumns ())) {
// // Provide a default size (width = length of longest line, height = 1)
// // TODO: It might makes more sense for the default to be width = length of first line?
// Size = new Size (TextFormatter.MaxWidth (Text, int.MaxValue), 1);
//}
}
}
///
/// Used by to resize the view's with the .
/// Setting to true only work if the and are null or
/// values and doesn't work with layout,
/// to avoid breaking the and settings.
///
///
/// Auto size is ignored if the and are used.
///
public bool AutoSize {
get => _autoSize;
set {
_autoSize = EnableNeedsFormat (value);
if (_autoSize && Alignment != TextAlignment.Justified && VerticalAlignment != VerticalTextAlignment.Justified) {
Size = CalcRect (0, 0, Text, _textDirection, TabWidth).Size;
}
}
}
///
/// Gets or sets whether trailing spaces at the end of word-wrapped lines are preserved
/// or not when is enabled.
/// If trailing spaces at the end of wrapped lines will be removed when
/// is formatted for display. The default is .
///
public bool PreserveTrailingSpaces {
get => _preserveTrailingSpaces;
set => _preserveTrailingSpaces = EnableNeedsFormat (value);
}
///
/// Controls the horizontal text-alignment property.
///
/// The text alignment.
public TextAlignment Alignment {
get => _textAlignment;
set => _textAlignment = EnableNeedsFormat (value);
}
///
/// Controls the vertical text-alignment property.
///
/// The text vertical alignment.
public VerticalTextAlignment VerticalAlignment {
get => _textVerticalAlignment;
set => _textVerticalAlignment = EnableNeedsFormat (value);
}
///
/// Controls the text-direction property.
///
/// The text vertical alignment.
public TextDirection Direction {
get => _textDirection;
set => _textDirection = EnableNeedsFormat (value);
}
///
/// Check if it is a horizontal direction
///
public static bool IsHorizontalDirection (TextDirection textDirection)
{
switch (textDirection) {
case TextDirection.LeftRight_TopBottom:
case TextDirection.LeftRight_BottomTop:
case TextDirection.RightLeft_TopBottom:
case TextDirection.RightLeft_BottomTop:
return true;
default:
return false;
}
}
///
/// Check if it is a vertical direction
///
public static bool IsVerticalDirection (TextDirection textDirection)
{
switch (textDirection) {
case TextDirection.TopBottom_LeftRight:
case TextDirection.TopBottom_RightLeft:
case TextDirection.BottomTop_LeftRight:
case TextDirection.BottomTop_RightLeft:
return true;
default:
return false;
}
}
///
/// Check if it is Left to Right direction
///
public static bool IsLeftToRight (TextDirection textDirection)
{
switch (textDirection) {
case TextDirection.LeftRight_TopBottom:
case TextDirection.LeftRight_BottomTop:
return true;
default:
return false;
}
}
///
/// Check if it is Top to Bottom direction
///
public static bool IsTopToBottom (TextDirection textDirection)
{
switch (textDirection) {
case TextDirection.TopBottom_LeftRight:
case TextDirection.TopBottom_RightLeft:
return true;
default:
return false;
}
}
///
/// Allows word wrap the to fit the available container width.
///
public bool WordWrap {
get => _wordWrap;
set => _wordWrap = EnableNeedsFormat (value);
}
///
/// Gets or sets the size of the area the text will be constrained to when formatted.
///
///
/// Does not return the size the formatted text; just the value that was set.
///
public Size Size {
get => _size;
set {
if (AutoSize && Alignment != TextAlignment.Justified && VerticalAlignment != VerticalTextAlignment.Justified) {
_size = EnableNeedsFormat (CalcRect (0, 0, Text, _textDirection, TabWidth).Size);
} else {
_size = EnableNeedsFormat (value);
}
}
}
///
/// The specifier character for the hot key (e.g. '_'). Set to '\xffff' to disable hot key support for this View instance. The default is '\xffff'.
///
public Rune HotKeySpecifier { get; set; } = (Rune)0xFFFF;
///
/// The position in the text of the hot key. The hot key will be rendered using the hot color.
///
public int HotKeyPos { get => _hotKeyPos; internal set => _hotKeyPos = value; }
///
/// Gets or sets the hot key. Must be be an upper case letter or digit. Fires the event.
///
public Key HotKey {
get => _hotKey;
internal set {
if (_hotKey != value) {
var oldKey = _hotKey;
_hotKey = value;
HotKeyChanged?.Invoke (this, new KeyChangedEventArgs (oldKey, value));
}
}
}
///
/// Gets the cursor position from . If the is defined, the cursor will be positioned over it.
///
public int CursorPosition { get; internal set; }
///
/// Gets the size required to hold the formatted text, given the constraints placed by .
///
///
/// Causes a format, resetting .
///
///
public Size GetFormattedSize ()
{
var lines = Lines;
var width = Lines.Max (line => line.GetColumns ());
var height = Lines.Count;
return new Size (width, height);
}
///
/// Gets the formatted lines.
///
///
///
/// Upon a 'get' of this property, if the text needs to be formatted (if is true)
/// will be called internally.
///
///
public List Lines {
get {
// With this check, we protect against subclasses with overrides of Text
if (string.IsNullOrEmpty (Text) || Size.IsEmpty) {
_lines = new List {
string.Empty
};
NeedsFormat = false;
return _lines;
}
if (NeedsFormat) {
var shown_text = _text;
if (FindHotKey (_text, HotKeySpecifier, true, out _hotKeyPos, out var newHotKey)) {
HotKey = newHotKey;
shown_text = RemoveHotKeySpecifier (Text, _hotKeyPos, HotKeySpecifier);
shown_text = ReplaceHotKeyWithTag (shown_text, _hotKeyPos);
}
if (IsVerticalDirection (_textDirection)) {
var colsWidth = GetSumMaxCharWidth (shown_text, 0, 1, TabWidth);
_lines = Format (shown_text, Size.Height, VerticalAlignment == VerticalTextAlignment.Justified, Size.Width > colsWidth && WordWrap,
PreserveTrailingSpaces, TabWidth, Direction, MultiLine);
if (!AutoSize) {
colsWidth = GetMaxColsForWidth (_lines, Size.Width, TabWidth);
if (_lines.Count > colsWidth) {
_lines.RemoveRange (colsWidth, _lines.Count - colsWidth);
}
}
} else {
_lines = Format (shown_text, Size.Width, Alignment == TextAlignment.Justified, Size.Height > 1 && WordWrap,
PreserveTrailingSpaces, TabWidth, Direction, MultiLine);
if (!AutoSize && _lines.Count > Size.Height) {
_lines.RemoveRange (Size.Height, _lines.Count - Size.Height);
}
}
NeedsFormat = false;
}
return _lines;
}
}
///
/// Gets or sets whether the needs to format the text when is called.
/// If it is false when Draw is called, the Draw call will be faster.
///
///
///
/// This is set to true when the properties of are set.
///
///
public bool NeedsFormat { get; set; }
///
/// Gets or sets the number of columns used for a tab.
///
public int TabWidth {
get => _tabWidth;
set => _tabWidth = EnableNeedsFormat (value);
}
///
/// Gets or sets a value indicating whether multi line is allowed.
///
///
/// Multi line is ignored if is .
///
public bool MultiLine {
get => _multiLine;
set {
_multiLine = EnableNeedsFormat (value);
}
}
private T EnableNeedsFormat (T value)
{
NeedsFormat = true;
return value;
}
///
/// Causes the to reformat the text.
///
/// The formatted text.
public string Format ()
{
var sb = new StringBuilder ();
// Lines_get causes a Format
foreach (var line in Lines) {
sb.AppendLine (line);
}
return sb.ToString ();
}
///
/// Draws the text held by to using the colors specified.
///
/// Specifies the screen-relative location and maximum size for drawing the text.
/// The color to use for all text except the hotkey
/// The color to use to draw the hotkey
/// Specifies the screen-relative location and maximum container size.
/// Determines if the bounds width will be used (default) or only the text width will be used.
/// The console driver currently used by the application.
public void Draw (Rect bounds, Attribute normalColor, Attribute hotColor, Rect containerBounds = default, bool fillRemaining = true, ConsoleDriver driver = null)
{
// With this check, we protect against subclasses with overrides of Text (like Button)
if (string.IsNullOrEmpty (_text)) {
return;
}
if (driver == null) {
driver = Application.Driver;
}
driver?.SetAttribute (normalColor);
// Use "Lines" to ensure a Format (don't use "lines"))
var linesFormated = Lines;
switch (_textDirection) {
case TextDirection.TopBottom_RightLeft:
case TextDirection.LeftRight_BottomTop:
case TextDirection.RightLeft_BottomTop:
case TextDirection.BottomTop_RightLeft:
linesFormated.Reverse ();
break;
}
var isVertical = IsVerticalDirection (_textDirection);
var maxBounds = bounds;
if (driver != null) {
maxBounds = containerBounds == default
? bounds
: new Rect (Math.Max (containerBounds.X, bounds.X),
Math.Max (containerBounds.Y, bounds.Y),
Math.Max (Math.Min (containerBounds.Width, containerBounds.Right - bounds.Left), 0),
Math.Max (Math.Min (containerBounds.Height, containerBounds.Bottom - bounds.Top), 0));
}
if (maxBounds.Width == 0 || maxBounds.Height == 0) {
return;
}
// BUGBUG: v2 - TextFormatter should not change the clip region. If a caller wants to break out of the clip region it should do
// so explicitly.
//var savedClip = Application.Driver?.Clip;
//if (Application.Driver != null) {
// Application.Driver.Clip = maxBounds;
//}
var lineOffset = !isVertical && bounds.Y < 0 ? Math.Abs (bounds.Y) : 0;
for (int line = lineOffset; line < linesFormated.Count; line++) {
if ((isVertical && line > bounds.Width) || (!isVertical && line > bounds.Height))
continue;
if ((isVertical && line >= maxBounds.Left + maxBounds.Width)
|| (!isVertical && line >= maxBounds.Top + maxBounds.Height + lineOffset))
break;
var runes = _lines [line].ToRunes ();
switch (_textDirection) {
case TextDirection.RightLeft_BottomTop:
case TextDirection.RightLeft_TopBottom:
case TextDirection.BottomTop_LeftRight:
case TextDirection.BottomTop_RightLeft:
runes = runes.Reverse ().ToArray ();
break;
}
// When text is justified, we lost left or right, so we use the direction to align.
int x, y;
// Horizontal Alignment
if (_textAlignment == TextAlignment.Right || (_textAlignment == TextAlignment.Justified && !IsLeftToRight (_textDirection))) {
if (isVertical) {
var runesWidth = GetSumMaxCharWidth (Lines, line, TabWidth);
x = bounds.Right - runesWidth;
CursorPosition = bounds.Width - runesWidth + (_hotKeyPos > -1 ? _hotKeyPos : 0);
} else {
var runesWidth = StringExtensions.ToString (runes).GetColumns ();
x = bounds.Right - runesWidth;
CursorPosition = bounds.Width - runesWidth + (_hotKeyPos > -1 ? _hotKeyPos : 0);
}
} else if (_textAlignment == TextAlignment.Left || _textAlignment == TextAlignment.Justified) {
if (isVertical) {
var runesWidth = line > 0 ? GetSumMaxCharWidth (Lines, 0, line, TabWidth) : 0;
x = bounds.Left + runesWidth;
} else {
x = bounds.Left;
}
CursorPosition = _hotKeyPos > -1 ? _hotKeyPos : 0;
} else if (_textAlignment == TextAlignment.Centered) {
if (isVertical) {
var runesWidth = GetSumMaxCharWidth (Lines, line, TabWidth);
x = bounds.Left + line + ((bounds.Width - runesWidth) / 2);
CursorPosition = (bounds.Width - runesWidth) / 2 + (_hotKeyPos > -1 ? _hotKeyPos : 0);
} else {
var runesWidth = StringExtensions.ToString (runes).GetColumns ();
x = bounds.Left + (bounds.Width - runesWidth) / 2;
CursorPosition = (bounds.Width - runesWidth) / 2 + (_hotKeyPos > -1 ? _hotKeyPos : 0);
}
} else {
throw new ArgumentOutOfRangeException ();
}
// Vertical Alignment
if (_textVerticalAlignment == VerticalTextAlignment.Bottom || (_textVerticalAlignment == VerticalTextAlignment.Justified && !IsTopToBottom (_textDirection))) {
if (isVertical) {
y = bounds.Bottom - runes.Length;
} else {
y = bounds.Bottom - Lines.Count + line;
}
} else if (_textVerticalAlignment == VerticalTextAlignment.Top || _textVerticalAlignment == VerticalTextAlignment.Justified) {
if (isVertical) {
y = bounds.Top;
} else {
y = bounds.Top + line;
}
} else if (_textVerticalAlignment == VerticalTextAlignment.Middle) {
if (isVertical) {
var s = (bounds.Height - runes.Length) / 2;
y = bounds.Top + s;
} else {
var s = (bounds.Height - Lines.Count) / 2;
y = bounds.Top + line + s;
}
} else {
throw new ArgumentOutOfRangeException ();
}
var colOffset = bounds.X < 0 ? Math.Abs (bounds.X) : 0;
var start = isVertical ? bounds.Top : bounds.Left;
var size = isVertical ? bounds.Height : bounds.Width;
var current = start + colOffset;
List lastZeroWidthPos = null;
Rune rune = default;
Rune lastRuneUsed;
var zeroLengthCount = isVertical ? runes.Sum (r => r.GetColumns () == 0 ? 1 : 0) : 0;
for (var idx = (isVertical ? start - y : start - x) + colOffset; current < start + size + zeroLengthCount; idx++) {
lastRuneUsed = rune;
if (lastZeroWidthPos == null) {
if (idx < 0 || x + current + colOffset < 0) {
current++;
continue;
} else if (!fillRemaining && idx > runes.Length - 1) {
break;
}
if ((!isVertical && current - start > maxBounds.Left + maxBounds.Width - bounds.X + colOffset)
|| (isVertical && idx > maxBounds.Top + maxBounds.Height - bounds.Y)) {
break;
}
}
//if ((!isVertical && idx > maxBounds.Left + maxBounds.Width - bounds.X + colOffset)
// || (isVertical && idx > maxBounds.Top + maxBounds.Height - bounds.Y))
// break;
rune = (Rune)' ';
if (isVertical) {
if (idx >= 0 && idx < runes.Length) {
rune = runes [idx];
}
if (lastZeroWidthPos == null) {
driver?.Move (x, current);
} else {
var foundIdx = lastZeroWidthPos.IndexOf (p => p.Value.Y == current);
if (foundIdx > -1) {
if (rune.IsCombiningMark ()) {
lastZeroWidthPos [foundIdx] = (new Point (lastZeroWidthPos [foundIdx].Value.X + 1, current));
driver?.Move (lastZeroWidthPos [foundIdx].Value.X, current);
} else if (!rune.IsCombiningMark () && lastRuneUsed.IsCombiningMark ()) {
current++;
driver?.Move (x, current);
} else {
driver?.Move (x, current);
}
} else {
driver?.Move (x, current);
}
}
} else {
driver?.Move (current, y);
if (idx >= 0 && idx < runes.Length) {
rune = runes [idx];
}
}
var runeWidth = GetRuneWidth (rune, TabWidth);
if (HotKeyPos > -1 && idx == HotKeyPos) {
if ((isVertical && _textVerticalAlignment == VerticalTextAlignment.Justified) ||
(!isVertical && _textAlignment == TextAlignment.Justified)) {
CursorPosition = idx - start;
}
driver?.SetAttribute (hotColor);
driver?.AddRune (rune);
driver?.SetAttribute (normalColor);
} else {
if (isVertical) {
if (runeWidth == 0) {
if (lastZeroWidthPos == null) {
lastZeroWidthPos = new List ();
}
var foundIdx = lastZeroWidthPos.IndexOf (p => p.Value.Y == current);
if (foundIdx == -1) {
current--;
lastZeroWidthPos.Add ((new Point (x + 1, current)));
}
driver?.Move (x + 1, current);
}
}
driver?.AddRune (rune);
}
if (isVertical) {
if (runeWidth > 0) {
current++;
}
} else {
current += runeWidth;
}
var nextRuneWidth = idx + 1 > -1 && idx + 1 < runes.Length ? runes [idx + 1].GetColumns () : 0;
if (!isVertical && idx + 1 < runes.Length && current + nextRuneWidth > start + size) {
break;
}
}
}
//if (Application.Driver != null) {
// Application.Driver.Clip = (Rect)savedClip;
//}
}
}
}