path: root/fauxtari.7

.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "FAUXTARI" 7 "2024-07-24" "0.2.1" "Urchlay's Atari 8-bit Tools"
.SH NAME
fauxtari \- Atari 8-bit-based font for Linux console and X11
.SH DESCRIPTION
.sp
\fBfauxtari\fP is a set of monospaced bitmap fonts for use with the
Linux console or X11. Most of the glyphs are taken from the Atari
XL/XE ROM font; see \fBGLYPHS\fP, below.
.SH APPEARANCE
.sp
The console (\fBpsf\fP files) and X11 (\fBbdf\fP files) fonts each come
in 3 sizes: 8x8 (original size), 16x16 (scaled 2x), and 24x24 (scaled
3x). The scaling has no interpolation or antialiasing, so the larger
fonts have a blocky "retro" look.
.sp
The appearance of the font is also vertically squashed, since it was
designed for non\-square pixels (NTSC and PAL "pixels" are slightly
taller than they are wide). This allows you to fit a \fIlot\fP of text
on the screen, in the console or with a fullscreen X terminal:
.TS
center;
|l|l|l|.
_
T{
Font Size
T}	T{
Display Size
T}	T{
Characters
T}
_
T{
8x8
T}	T{
1280x1024
T}	T{
160x128
T}
_
T{
8x8
T}	T{
1920x1080
T}	T{
240x135
T}
_
T{
8x8
T}	T{
3840x2160
T}	T{
480x270
T}
_
T{
16x16
T}	T{
1280x1024
T}	T{
80x64
T}
_
T{
16x16
T}	T{
1920x1080
T}	T{
120x67
T}
_
T{
16x16
T}	T{
3840x2160
T}	T{
240x135
T}
_
T{
24x24
T}	T{
1280x1024
T}	T{
53x42
T}
_
T{
24x24
T}	T{
1920x1080
T}	T{
80x45
T}
_
T{
24x24
T}	T{
3840x2160
T}	T{
160x90
T}
_
.TE
.sp
Of course, the smaller font sizes might be too small to read, especially
on smaller displays.
.SH CONSOLE
.sp
If the \fBpsf\fP fonts have been installed to the standard console font
directory (usually \fB/usr/share/kbd/consolefonts/\fP; this is done by
\fBmake install\fP when \fBbw\-atari8\-tools\fP is built), you can use e.g.:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
setfont fauxtari\-16
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Replace the 16 with 8 or 24, for the other sizes. For Slackware Linux,
you can make this the default in \fB/etc/rc.d/rc.font\fP, or just put it
in \fB/etc/rc.d/rc.local\fP\&. Other Linux distributions will have their
own ways to set this up (especially systemd\-based ones).
.SH X11
.sp
If the \fBbdf\fP fonts have been installed (via \fBmake install\fP when
\fBbw\-atari8\-tools\fP is built), you should be able to launch a terminal
via:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
xterm \-fn fauxtari\-16
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Replace the 16 with 8 or 24, for the other sizes. These names are
aliases (added to \fBfonts.alias\fP in the font directory); the full
names are:
.INDENT 0.0
.IP \(bu 2
\-bw\-fauxtari\-medium\-r\-normal\-\-8\-80\-75\-75\-c\-80\-iso10646\-1
.IP \(bu 2
\-bw\-fauxtari\-medium\-r\-normal\-\-16\-160\-75\-75\-c\-160\-iso10646\-1
.IP \(bu 2
\-bw\-fauxtari\-medium\-r\-normal\-\-24\-240\-75\-75\-c\-240\-iso10646\-1
.UNINDENT
.sp
For \fBurxvt\fP(1), you might have to turn off the \fBboldFont\fP resource (set
it to an empty string), or run it as:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
urxvt \-fn fauxtari\-16 \-fb ""
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
This keeps \fBurxvt\fP from using some other font (from its built\-in
list, or from your \fBURxvt.font\fP resource) for bold characters. You
could also try:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
urxvt \-fn \(aqxft:Fauxtari:size=16\(aq
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Note that the "size=" must be one of the available sizes (8, 16, or
24). Or, rather, \fBurxvt\fP \fIwill\fP use one of these sizes, whichever is the
next larger than the size you gave it (or, it\(aqll refuse to load the
font, if the size is too large).
.sp
For \fBst\fP from suckless.org, run:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
st \-f fauxtari\-16
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
It\(aqs possible to use the fonts with \fBrxvt\fP, but since \fBrxvt\fP
doesn\(aqt support Unicode, it won\(aqt be all that useful except for plain
ASCII text. Why are you still using \fBrxvt\fP, anyway?
.SH GLYPHS
.sp
All 3 sizes contain the same set of glyphs. These include:
.INDENT 0.0
.IP \(bu 2
Printable ASCII. Complete. Mostly taken from the Atari 800XL ROM
($E000 area), except the \fB~\fP \fB{\fP \fB}\fP \fB\(ga\fP characters which are
missing from the Atari\(aqs character set (these were hand\-drawn by the
author).
.IP \(bu 2
Unicode mappings for ATASCII graphics characters. Complete set. These
work well with \fBlistbas\fP(1), \fBa8cat\fP(1), and \fBa8xd\fP(1). The glyphs
are taken from the 800XL ROM.
.IP \(bu 2
The XL International Character set (umlauted/accented letters, plus
the \fB¡\fP character and the British pound sign), taken from the 800XL ROM
($CC00 area).
.IP \(bu 2
Arabic, taken from Atari\(aqs Arabic model of the 65XE. Only the
isolated and terminal letter forms are included, but these are
also mapped to the Unicode codepoints for the initial and medial forms.
Hopefully this results in readable Arabic text. The creator of
\fBfauxtari\fP can\(aqt read Arabic at all and doesn\(aqt know anyone who
can, so some of the character mappings may be wrong.
.IP \(bu 2
Hebrew glyphs, the complete aleph\-bet, taken from the Hebrew ROM
modification that was available for sale in Israel in the early 1980s.
I\(aqm almost 100% certain this was a 3rd\-party product, not made by Atari.
.IP \(bu 2
Polish accented letters, taken from a Polish XL ROM found on the Web
at some point. No idea who created this or whether it was homebrew or
commercial.
.IP \(bu 2
A few extra Latin\-1 characters, hand\-drawn by the author. These include
Spanish punctuation (quotation marks, inverted question mark), the
copyright symbol, and the Euro currency sign.
.IP \(bu 2
TODO: Commodore 64 graphics characters.
.UNINDENT
.SH LIMITATIONS
.INDENT 0.0
.IP \(bu 2
Since these are bitmap fonts, applications generally won\(aqt render them at
arbitrary sizes.
.IP \(bu 2
There are no true descenders, since the Atari ROM character set doesn\(aqt use them.
Someday I may add hand\-hacked true descender versions of the fonts.
.UNINDENT
.SH COPYRIGHT
.sp
WTFPL. See \fI\%http://www.wtfpl.net/txt/copying/\fP for details.
.SH AUTHOR
.INDENT 0.0
.IP B. 3
Watson <\fI\%urchlay@slackware.uk\fP>; Urchlay on irc.libera.chat \fI##atari\fP\&.
.UNINDENT
.SH SEE ALSO
.sp
\fBa8cat\fP(1),
\fBa8eol\fP(1),
\fBa8xd\fP(1),
\fBatr2xfd\fP(1),
\fBatrsize\fP(1),
\fBaxe\fP(1),
\fBbas2aplus\fP(1),
\fBblob2c\fP(1),
\fBblob2xex\fP(1),
\fBcart2xex\fP(1),
\fBcxrefbas\fP(1),
\fBdasm2atasm\fP(1),
\fBdiffbas\fP(1),
\fBdumpbas\fP(1),
\fBf2toxex\fP(1),
\fBfenders\fP(1),
\fBlistbas\fP(1),
\fBprotbas\fP(1),
\fBrenumbas\fP(1),
\fBrom2cart\fP(1),
\fBunmac65\fP(1),
\fBunprotbas\fP(1),
\fBvxrefbas\fP(1),
\fBwhichbas\fP(1),
\fBxex1to2\fP(1),
\fBxexamine\fP(1),
\fBxexcat\fP(1),
\fBxexsplit\fP(1),
\fBxfd2atr\fP(1),
\fBxex\fP(5),
\fBatascii\fP(7),
\fBfauxtari\fP(7).
.sp
Any good Atari 8\-bit book: \fIDe Re Atari\fP, \fIThe Atari BASIC  Reference
Manual\fP,  the  \fIOS Users\(aq Guide\fP, \fIMapping the Atari\fP, etc.
.\" Generated by docutils manpage writer.
.