/// <summary>
/// Creates a custom character for standard displays with 8-pixel-per-row characters. See <see cref="ICharacterLcd.CreateCustomCharacter"/> for details.
/// </summary>
/// <param name="self">Instance of ICharacterLcd. This method can be called as extension method on this instance</param>
/// <param name="location">Index of the character to create in the hardware character table</param>
/// <param name="b0">First row data (standard displays only use the lower 5 bits of each row)</param>
/// <param name="b1">Second row data</param>
/// <param name="b2">Third row data</param>
/// <param name="b3">Fourth row data</param>
/// <param name="b4">Fifth row data</param>
/// <param name="b5">Sixth row data</param>
/// <param name="b6">Seventh row data</param>
/// <param name="b7">Eight row data</param>
public static void CreateCustomCharacter(this ICharacterLcd self, byte location, byte b0, byte b1, byte b2, byte b3, byte b4, byte b5, byte b6, byte b7)
{
byte[] array = { b0, b1, b2, b3, b4, b5, b6, b7 };
ReadOnlySpan <byte> bytes = new ReadOnlySpan <byte>(array);
self.CreateCustomCharacter(location, bytes);
}
/// <summary>
/// Creates an instance of <see cref="LcdValueUnitDisplay"/>
/// </summary>
/// <param name="lcd">Interface to the display</param>
/// <param name="culture">User culture</param>
public LcdValueUnitDisplay(ICharacterLcd lcd, CultureInfo culture)
{
_lock = new object();
_lcd = lcd;
_culture = culture;
_font = new Dictionary <char, byte[]>();
if (lcd.Size.Width < 20 || lcd.Size.Height < 4)
{
throw new NotSupportedException("This class can only run on displays with at least 20x4 characters.");
}
if (lcd.NumberOfCustomCharactersSupported < 8)
{
throw new NotSupportedException("This class can only run on displays with 8 or more custom character slots");
}
}
/// <summary>
/// Creates a new instance of the <see cref="LcdConsole"/> class using the specified LCD low-level interface.
/// This class automatically configures the low-level interface. Do not use the low-level interface at the same time.
/// </summary>
/// <param name="lcd">The low-level LCD interface.</param>
/// <param name="romType">Name of character ROM of display. Currently supported types: A00 and A02.</param>
/// <param name="shouldDispose">If the class should dispose the LCD driver when it is disposed. Defaults to true</param>
public LcdConsole(ICharacterLcd lcd, string romType, bool shouldDispose = true)
{
_lcd = lcd;
_shouldDispose = shouldDispose;
_romType = romType;
_characterEncoding = null;
Size = lcd.Size;
_currentData = new StringBuilder[Size.Height];
CursorLeft = 0;
CursorTop = 0;
ScrollUpDelay = TimeSpan.Zero;
_lock = new object();
_lcd.UnderlineCursorVisible = false;
_lcd.BlinkingCursorVisible = false;
_lcd.DisplayOn = true;
_lcd.BacklightOn = true;
ClearStringBuffer();
_lcd.Clear();
}
/// <summary>
/// Write stuff to the display.
/// </summary>
/// <param name="lcd">The display driver</param>
public static void WriteTest(ICharacterLcd lcd)
{
LcdConsole console = new LcdConsole(lcd, "A00", false);
console.LineFeedMode = LineWrapMode.Truncate;
Console.WriteLine("Nowrap test:");
console.Write("This is a long text that should not wrap and just extend beyond the display");
console.WriteLine("This has CRLF\r\nin it and should \r\n wrap.");
console.Write("This goes to the last line of the display");
console.WriteLine("This isn't printed, because it's off the screen");
Console.ReadLine();
Console.WriteLine("Autoscroll test:");
console.LineFeedMode = LineWrapMode.Wrap;
console.WriteLine();
console.WriteLine("Now the display should move up.");
console.WriteLine("And more up.");
for (int i = 0; i < 20; i++)
{
console.WriteLine($"This is line {i + 1}/{20}, but longer than the screen");
Thread.Sleep(10);
}
console.LineFeedMode = LineWrapMode.Wrap;
console.WriteLine("Same again, this time with full wrapping.");
for (int i = 0; i < 20; i++)
{
console.Write($"This is string {i + 1}/{20} longer than the screen");
Thread.Sleep(10);
}
Console.ReadLine();
Console.WriteLine("Intelligent wrapping test");
console.LineFeedMode = LineWrapMode.WordWrap;
console.WriteLine("Now intelligent wrapping should wrap this long sentence at word borders and ommit spaces at the start of lines.");
Console.WriteLine("Not wrappable test");
Console.ReadLine();
console.WriteLine("NowThisIsOneSentenceInOneWordThatCannotBeWrapped");
Console.ReadLine();
Console.WriteLine("Individual line test");
console.Clear();
console.LineFeedMode = LineWrapMode.Truncate;
console.ReplaceLine(0, "This is all garbage that will be replaced");
console.ReplaceLine(0, "Running clock test");
int left = console.Size.Width;
Task?alertTask = null;
// Let the current time move trought the display on line 1
while (!Console.KeyAvailable)
{
DateTime now = DateTime.Now;
String time = String.Format(CultureInfo.CurrentCulture, "{0}", now.ToLongTimeString());
string printTime = time;
if (left > 0)
{
printTime = new string(' ', left) + time;
}
else if (left < 0)
{
printTime = time.Substring(-left);
}
console.ReplaceLine(1, printTime);
left--;
// Each full minute, blink the display (but continue writing the time)
if (now.Second == 0 && alertTask == null)
{
alertTask = console.BlinkDisplayAsync(3);
}
if (alertTask != null && alertTask.IsCompleted)
{
// Ensure we catch any exceptions (there shouldn't be any...)
alertTask.Wait();
alertTask = null;
}
Thread.Sleep(500);
// Restart when the time string has left the display
if (left < -time.Length)
{
left = console.Size.Width;
}
}
alertTask?.Wait();
Console.ReadKey();
Console.WriteLine("Culture Info Test");
LcdCharacterEncoding encoding = LcdConsole.CreateEncoding(CultureInfo.CreateSpecificCulture("de-CH"), "A00", '?', 8);
console.LoadEncoding(encoding);
console.Clear();
console.ScrollUpDelay = TimeSpan.FromSeconds(1);
console.LineFeedMode = LineWrapMode.WordWrap;
console.WriteLine(@"Die Ratten im Gemäuer, englischer Originaltitel ""The Rats in the Walls"" " +
"ist eine phantastische Kurzgeschichte des amerikanischen Schriftstellers H. P. Lovecraft. Das etwa " +
"8000 Wörter umfassende Werk wurde zwischen August und September 1923 verfasst und erschien erstmals " +
"im März 1924 im Pulp-Magazin Weird Tales. Der Titel bezieht sich auf das Rascheln von Ratten in den " +
"Gemäuern des Familienanwesens, das der Erzähler Delapore nach 300 Jahren auf den Ruinen des Stammsitzes " +
"seiner Vorfahren neu errichtet hat. Im Verlauf der Erzählung führen die Ratten Delapore zur Entdeckung " +
"des grausigen Geheimnisses der Gruft seines Anwesens und der finsteren Vergangenheit seiner Familie. " +
"Nach Lovecraft entstand die Grundidee für die Geschichte, als eines späten Abends seine Tapete zu knistern begann. " +
"(von https://de.wikipedia.org/wiki/Die_Ratten_im_Gem%C3%A4uer, CC-BY-SA 3.0)");
console.WriteLine("From A00 default map: ");
console.WriteLine("Code: [{|}]^_\\");
console.WriteLine("Greek: Ωαβεπθμ");
console.WriteLine("Others: @ñ¢");
console.WriteLine("Math stuff: ∑÷×∞");
console.WriteLine("German code page");
console.WriteLine("Umlauts: äöüßÄÜÖ");
console.WriteLine("Äußerst ölige, überflüssige Ölfässer im Großhandel von Ützhausen.");
console.WriteLine("Currency: ¥€£$");
encoding = LcdConsole.CreateEncoding(CultureInfo.CreateSpecificCulture("fr-fr"), "A00", '?', 8);
console.LoadEncoding(encoding);
console.Clear();
console.WriteLine("Le français est une langue indo-européenne de la famille des langues romanes. " +
"Le français s'est formé en France. Le français est déclaré langue officielle en France en 1539. " +
"Après avoir été sous l'Ancien Régime la langue des cours royales et princières, " +
"des tsars de Russie aux rois d'Espagne et d'Angleterre en passant par les princes de l'Allemagne, " +
"il demeure une langue importante de la diplomatie internationale aux côtés de l'anglais. ");
encoding = LcdConsole.CreateEncoding(CultureInfo.CreateSpecificCulture("da-da"), "A00", '?', 8);
console.LoadEncoding(encoding);
console.Clear();
console.WriteLine("Dansk er et nordgermansk sprog af den østnordiske (kontinentale) gruppe, " +
"der tales af ca. seks millioner mennesker. Det er stærkt påvirket af plattysk. Dansk tales " +
"også i Sydslesvig (i Flensborg ca. 20 %) samt PÅ FÆRØER OG GRØNLAND.");
Console.ReadLine();
Console.WriteLine("Japanese test");
encoding = LcdConsole.CreateEncoding(CultureInfo.CreateSpecificCulture("ja-ja"), "A00", '?', 8);
console.LoadEncoding(encoding);
console.WriteLine("What about some japanese?");
console.WriteLine("イロハニホヘト");
console.WriteLine("チリヌルヲ");
console.WriteLine("ワカヨタレソ");
console.WriteLine("ツネナラム");
console.WriteLine("ウヰノオクヤマ");
console.WriteLine("ケフコエテ");
console.WriteLine("アサキユメミシ");
console.WriteLine("ヱヒモセス");
console.Clear();
console.Write("Test finished");
console.Dispose();
}