Edit

Share via


Windows Terminal sample code

Explore some of the sample code hosted on the Windows Terminal repo, including Pixel Shader .hlsl samples, an EchoCon ConPTY sample Win32 pseudo console, a GUIConsole sample WPF console targeting .NET, a MiniTerm sample using basic PTY API calls, and a ReadConsoleInputStream demo for monitoring of console events while streaming character input.

Pixel Shaders

Due to the sheer amount of computing power in GPUs, one can do awesome things with pixel shaders such as real-time fractal zoom, ray tracers and image processing.

Windows Terminal allows users to provide a pixel shader, applied to the terminal by adding the experimental.pixelShaderPath property to a profile in your settings.json file. Pixel shaders are written in a language called HLSL, a C-like language with some restrictions.

Try one of several Pixel Shader .hlsl samples provided in the Windows Terminal repo: Pixel Shaders.

Terminal Retro Pixel Shader sample

EchoCon ConPTY sample app

This sample application illustrates how to use the Win32 Pseudo Console (ConPTY) by:

  1. Creating an input and an output pipe
  2. Calling CreatePseudoConsole() to create a ConPTY instance attached to the other end of the pipes
  3. Spawning an instance of ping.exe connected to the ConPTY
  4. Running a thread that listens for output from ping.exe, writing received text to the Console

Visit the Windows Terminal repo to find this sample: EchoCon ConPTY Sample App.

GUIConsole sample app

This sample application provides an example skeleton of a custom WPF console.

Within this sample, you will find:

  • GUIConsole.WPF: a WPF application, targeting .NET 4.6.1, that creates a single WPF window which acts as the console and keeps the underlying console visible.

  • GUIConsole.ConPTY: a .NET Standard 2.0 library that handles the creation of the console and enables pseudoconsole behavior. The Terminal.cs file contains the publicly visible pieces that the WPF application will interact with. Terminal.cs exposes two things that allow reading from, and writing to, the console:

    • ConsoleOutStream: a FileStream hooked up to the pseudoconsole's output pipe. This will output VT100.
    • WriteToPseudoConsole(string input): a method that will take the given string and write it to the pseudoconsole via its input pipe. This accepts VT100.

Visit the Windows Terminal repo to find this sample: GUIConsole.

MiniTerm sample app

This experimental terminal demonstrates basic API calls (not intended for "real-world" usage) using PTY APIs from Microsoft. Written in C# and heavily based on the native code examples.

Visit the Windows Terminal repo to find this sample: MiniTerm.

ReadConsoleInputStream Demo

Demonstration of asynchronous monitoring of console events (like mouse, menu, focus, buffer/viewport resize) while simultaneously streaming the character input view from the console. A particularly useful feature when working with VT100 streams and ConPTY.

Visit the Windows Terminal repo to find this demo: ReadConsoleInputStream Demo.