diff options
Diffstat (limited to 'a8xd.rst')
-rw-r--r-- | a8xd.rst | 84 |
1 files changed, 69 insertions, 15 deletions
@@ -23,18 +23,8 @@ The ATASCII codes are converted to UTF-8, in the same way as **a8cat**\(1). Codes with the high bit set are displayed in inverse video, using ANSI/VT-100 escape sequences. -By default, the output is colorized: - - - Normal characters are green. This includes alphanumerics, spaces, and - punctuation. - - - Codes **$00** (null, or ATASCII heart) and **$9B** (EOL) are red. - - - Control characters are yellow. This includes codes **$01** to **$1F** - (control + letters/punctuation, escape, and arrow keys), **$60**, **$7B**, **$7D** - (clear screen), **$7E** (backspace), and **$7F** (tab). - -The colors and inverse rendering apply to both the ATASCII and hex bytes. +By default, the output is colorized (see **COLORS**, below). The +colors and inverse rendering apply to both the ATASCII and hex bytes. Without *infile*, or if *infile* is **-**, **a8xd** reads from standard input. @@ -43,11 +33,15 @@ OPTIONS -a ANTIC mode: treat the input as screen bytes (aka "internal codes") - rather than ATASCII. Can usefully be combined with **-g**. + rather than ATASCII. Can usefully be combined with **-g** or **-f**. + +-f + Like **-g**, but using the top half of the character set. This is + what you'd see on the Atari with *GRAPHICS 1:POKE 756,226*. -g - Graphics mode. Changes the colorization so it looks like *GRAPHICS 1* (or 2) - on the Atari. + Graphics mode. Changes the printed characters and colorization so it + looks like *GRAPHICS 1* (or 2) on the Atari. -i Print XL/XE International Character Set conversions instead of ATASCII. @@ -89,6 +83,66 @@ OPTIONS **--version** Show version number and exit. +COLORS +====== + +The default color scheme is: + + - Non-control characters are green. This includes alphanumerics, spaces, and + punctuation. These are the characters that ATASCII has in common with + ASCII. + + - Graphics characters are yellow. This includes **$01** to **$1a** (the + alphabet, with the Control key held down), **$60** (the diamond), and + **$7b** (the spade). + + - Codes **$00** (null, or ATASCII heart) and **$9B** (EOL) are red. These + characters are used as delimiters, so it makes sense for them to + stand out. + + - Cursor control characters are purple. These are characters that perform + some action when printed to the *E:* device. These are: + + **$1b** + Escape. + + **$1c** through **$1f** + Cursor movement (up/down/left/right arrows). + + **$7d** + Clear screen. + + **$7e** + Backspace. + + **$7f** + Tab. + + **$9c** + Delete line. + + **$9d** + Insert line. + + **$9e** + Clear tab stop. + + **$9f** + Set tab stop. + + **$fd** + Bell. + + **$fe** + Delete character. + + **$ff** + Insert character. + +In **-f** and **-g** modes, the above doesn't apply. Instead, the +colors are (close to) the colors that would appear in *GRAPHICS 1*, +with the default palette. + NOTES ===== |