TerminalMatrix 1.7.0

dotnet add package TerminalMatrix --version 1.7.0
NuGet\Install-Package TerminalMatrix -Version 1.7.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TerminalMatrix" Version="1.7.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add TerminalMatrix --version 1.7.0
#r "nuget: TerminalMatrix, 1.7.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install TerminalMatrix as a Cake Addin
#addin nuget:?package=TerminalMatrix&version=1.7.0

// Install TerminalMatrix as a Cake Tool
#tool nuget:?package=TerminalMatrix&version=1.7.0


An 8-bit video interface emulator. Hope to make it good enough to replace the GUI code in our Altair BASIC emulator, A-BASIC-Language. Place the control on a Windows Forms-window and get events for what the user is typing, or call the Input function to prompt the user. Nuget:

Install-Package TerminalMatrix

Basic functionality

For adding text to the terminal matrix, use the WriteLine method. To prompt the user, use the Input method.

Limit text area

When the text area is unlimited, the text terminal displays 25 lines of text. This amount can be limited using the SetTextRenderLimit method. 0 means that text is allowed everywhere, a larger value leaves empty space on the upper part of the screen, and the largest value (23) only allows two lines of text on the bottom of the screen.

Bitmap images

To produce a bitmap image, create a picture (preferably a 16 or 32 color GIF file) using the palette described in the ah-c64-palette.act Photoshop file (or the extended 32 color file). The color palette is also described in the source code, here. Remember that pixels usually are more high then wide, and that the interface emulator only can display 640 * 200 pixels at one time. The default resolution is 320 * 200 rectangular pixels.*

To display an image, load it as a byte array using the LoadPictureFromGif function and draw it using the SetPixels function. Call UpdateBitmap to force the pixel buffer to be displayed.

var gif = terminalMatrixControl1.LoadPictureFromGif(@"..\..\..\..\testgif.gif");
terminalMatrixControl1.SetPixels(0, 0, gif);

The image is a screenshot of the AdventureGameExample projet, a text adventure game dummy.

Text adventure dummy


For a clean exit, you must call the Quit method in the FormClosed event handler.

private void Form1_FormClosed(object sender, FormClosedEventArgs e)
Product Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.
  • net8.0-windows7.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.7.0 94 12/31/2023
1.6.0 100 12/21/2023
1.5.0 110 12/15/2023
1.4.0 97 12/15/2023
1.3.0 105 12/14/2023
1.2.0 91 12/13/2023
1.1.0 102 12/12/2023
1.0.0 95 12/12/2023

Function keys (F1-F10) and detection of request full screen (F11).