Skip to content

Latest commit

 

History

History
154 lines (111 loc) · 5.84 KB

README.md

File metadata and controls

154 lines (111 loc) · 5.84 KB

3270font: A font for the nostalgic

Travis-CI Debian package Ubuntu package

Screenshot

Sample

A little bit of history

This font is derived from the x3270 font, which, in turn, was translated from the one in Georgia Tech's 3270tool, which was itself hand-copied from a 3270 series terminal. I built it because I felt terminals deserve to be pretty. The .sfd font file contains a x3270 bitmap font that was used for guidance.

Using with the cool-old-tern (now cool-retro-term) terminal program

Getting it

If you are running Debian or Ubuntu and you don't want to mess with building your font files, you can simply apt-get install fonts-3270 (It's available from the Debian (https://packages.debian.org/sid/fonts/fonts-3270) and Ubuntu (http://packages.ubuntu.com/impish/fonts-3270) package repos at https://packages.debian.org/sid/fonts/fonts-3270 and https://packages.ubuntu.com/impish/fonts/fonts-3270, although the packaged version may not be the latest version, but it's good enough for most purposes.

On FreeBSD the font can be installed with pkg install 3270font.

For those who don't have the luxury of a proper system-managed package, Adobe Type 1, TTF, OTF and WOFF versions are available for download on https://3270font.s3.amazonaws.com/3270_fonts_d916271.zip (although this URL may not always reflect the latest build or release).

ASCII is so 60's

The format

The "source" file is edited using FontForge. You'll need it if you want to generate fonts for your platform. On most civilized operating systems, you can simply apt-get install fontforge, yum install fontforge or even port install fontforge. On others, you may need to grab your copy from https://fontforge.org/. I encourage you to drop by and read the tutorials.

Using it on OSX (don't forget to turn antialiasing on)

If you are running Windows, you'll probably need something like WSL or Cygwin, but, in the end, the font works correctly (with some very minor hinting issues).

Works on Windows

Generating usable font files

The easiest way to generate the font files your computer can use is to run make all (if you are running Ubuntu or Debian, make install will install them too). Using make help will offer a handy list of options.

The script generate_derived.pe calls FontForge and generates PostScript, OTF, TTF and WOFF versions of the base font, as well as a slightly more condensed .sfd file with the base font narrowed to 488 units, with no glyph rescaling (or cropping - we need to fix that) and its corresponding PostScript, TTF, OTF and WOFF versions.

For your favorite editor

Contributing

I fear GitHub's pull-request mechanism may not be very FontForge-friendly. If you want to contribute (there are a lot of missing glyphs, such as most non-latin alphabets which most likely were never built into 3270 terminals), the best workflow would probably be to add the encoding slots (if needed), add/make the changes, remove the unchanged glyphs and save it as a different file. If, in doubt, get in touch and we will figure out how to do it right.

In order to generate the sample image and the grids for FontForge, you'll need a Python 3 environment with PIL or pillow installed. The requirements.txt file lists everything you need to do it.

If all you want is an easier way to provide feedback, you can use a container runtime, Docker, Podman, and etc, and use these make targets:

  • make image - builds a local image with fontforge and make
  • make generate - uses the local container image to run make font

Build Requirements

On Debian derived distros, you'll need Fontforge and python3-dev. On Red Hat ans similar distros, you'll need Fontforge and python3-devel. Since some packages will need to be compiled, you'll need a build system (GNU Make, a C compiler, etc).

Screenshots

xterm

Gnome Terminal

Konsole

Terminator

urxvt

Known problems

Not all symbols in the 3270 charset have Unicode counterparts. When possible, they are duplicated in the Unicode space. The 3270-only symbols are at the end of the font, along with some glyphs useful for building others.

Please refer to http://x3270.bgp.nu/Charset.html for a complete map.

Future improvements

A grid generator is provided for producing various grid sizes for the font. Those grids are not used yet, but they are intended to be used to align font features to provide better rendering at common font size choices. The captures below exemplify these choices:

x3270 with 32 pixel font (used as bitmap template for the font)

x3270 with 20 pixel font

Gnome Terminal on Ubuntu 17.10