(Translated by https://www.hiragana.jp/)
GitHub - statico/langterm: 🕹️ WebGL-based VT220 emulator, made as a learning example and frontend for a text adventure
Skip to content

🕹️ WebGL-based VT220 emulator, made as a learning example and frontend for a text adventure

License

Notifications You must be signed in to change notification settings

statico/langterm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

langterm 🕹️

     __ _____________  __  ___
    / //_  __/ __/ _ \/  |/  /   langterm by Ian Langworth, 2017
   / /__/ / / _// , _/ /|_/ /    featuring "The Archive", a cheesy
  /____/_/ /___/_/|_/_/  /_/     interactive fiction game

This is a WebGL-based VT220 emulator with a simple fallback for non-JS/non-WebGL/non-desktop browsers. Made as a learning example and frontend for a cute text adventure game. It's also used as my home page on https://langworth.com/.

CleanShot 2023-11-16 at 09 19 40

How It Works

The game has two view modes: simple and fancy.

If the user is on a small screen, or fires a touch event, or we cannot initialize WebGL, we fallback to the simple mode which is just a scrollable text box and an input field. Touch devices should have the on-screen keyboard appear which makes the game playable.

On larger desktops with hardware keyboards, provide the full pseudo-CRT experience using WebGL. This works as follows:

  1. A data structure, Terminal, keeps track of the logical appearance of the terminal.

  2. The terminal is rendered to a 2048x2048 texture by drawing triangles filled up with bitmap font data found in assets/apple2font.png. That font came from KreativeKorp's Ultimate Apple II Font and was turned into a sprite sheet with Codehead’s Bitmap Font Generator.

  3. That texture is rendered to another texture as a full-screen quad (two triangles) and post-processed to add CRT-like scanline and warping effects. I got the CRT shader from this CRT shader by Timothy Lottes.

  4. The background image was from here and is reused with permission. I photoshopped the text out and noise added to make it look blank. It's rendered to a full-screen quad, and some vignetting and noise is added for effect. I could have used background-size: cover in CSS and composited the vignette and noise over the web page, but I wanted to do it all in GLSL as a learning example.

  5. The terminal texture is rendered to a 2D quad. I initially used a 3D quad with a persepctive matrix, but the field of view gets stretched with short/wide windows. Using 2D and writing my own aspect ratio math in the shader looks better. Also, I had to enable GL blending to properly composite this texture and its alpha channel over the background image.

  6. Text input gets added to a buffer. When you hit Enter, the input buffer is sent to an interactive fiction server running a custom story made with Inform7. See my gluluxe-httpd project for the server. The story is closed source, but you can check out a limited public version here. The whole idea is that you'll have to figure it out on your own ;)

I started with WebGL Boilerplate. For more involved projects and to reduce repetition, I would consider using ThreeJS.

Build/Test

  1. Get a Glulx game and run statico/glulxe-httpd
  2. Serve this directory with something like python -m SimpleHTTPServer and go to http://localhost:8000

See Also

License

The source code in this repository is released under the MIT License. Other assets, such as the VT520 photo, fonts and CRT GLSL shader, are subject to any license provided by the original authors.