Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kenjennings/Atari-Font-To-Code
An over-engineered linux tool to convert an Atari 8-bit font to BASIC, C, and Assembly source.
https://github.com/kenjennings/Atari-Font-To-Code
Last synced: 12 days ago
JSON representation
An over-engineered linux tool to convert an Atari 8-bit font to BASIC, C, and Assembly source.
- Host: GitHub
- URL: https://github.com/kenjennings/Atari-Font-To-Code
- Owner: kenjennings
- License: lgpl-3.0
- Created: 2017-08-24T17:53:10.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-08-26T17:44:36.000Z (over 7 years ago)
- Last Synced: 2023-08-10T20:39:40.120Z (over 1 year ago)
- Language: C
- Homepage:
- Size: 101 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-typography - Atari-Font-To-Code - An over-engineered linux tool to convert an Atari 8-bit font to BASIC, C, and Assembly source. (Assembly)
README
# Atari-Font-To-Code
An over-engineered linux tool to convert an Atari 8-bit font to BASIC, C, and Assembly source.
atf2code
$Id: main.c,v 1.17 2014/04/04 18:37:10 kjenning Exp $
$Id: globals.c,v 1.13 2014/04/08 17:28:43 kjenning Exp $
$Id: myglobals.c,v 1.6 2014/04/04 17:00:07 kjenning Exp $
$Id: E000.c,v 1.3 2014/03/18 19:44:23 kjenning Exp $
$Id: io.c,v 1.7 2014/03/31 20:53:36 kjenning Exp $
Dump Atari font (1024 or 512 byte) files as data statements for a programming
language -- DATA for BASIC, a number of data directives for assembly language,
or an unsigned char array for C.
Data may be output as hex or decimal values. Line numbers may or may not be
included.
Usage:
atf2code [options]
file filename == Providing filename 'stdin' (default) will use stdio
instead.
lines == Include line numbers. The C format always overrides
this to turn off line numbers. (default for BASIC
and ASM).
nolines == Do not include line numbers. (default for C)
start num == Starting line number less than 32000 (default 1000).
inc num == Line number increment. (default 10).
asm == Output for Assembly. (default)
basic == Output for BASIC. (DATA format only)
cc == Output for C. (unsigned char array)
org num == Starting address for Assembly output. (default
$9000)
hex == Output data using hex values. ($00 or $0000)
(default)
dec == Output data using decimal format.
byte == Output bytes as single byte values. (default)
dbyte == Outputs pairs of bytes as word values low-endian.
($1234 == $12 $34)
word == Outputs pairs of bytes as word values high-endian.
($1234 == $34 $12)
noindex == Do not output the character index. (default)
index == Outputs the character index before the eight
character bytes. See --diff for how this option
benefits the BASIC format. This is of limited use
in the C format and corrupts the Assembly format
output.
nodiff == Do not compare. Output all the characters. (default)
diff == Outputs the character bytes only if they differ from
the ROM character set. Where gaps occur the Assembly
format will insert a new origination address
directive declaring the next character bytes in the
correct location. The options --basic --index --diff
used together permit optimizing the data for BASIC.
Where assembly language can easily declare the bytes
assigned at specific memory addresses, BASIC must
read DATA statements which themselves occupy memory
in order to load character bit-map values into
memory. The output of these options produces the
minimum amount of data for use by a program such as
the example below, which should be compatible with
TurboBasic XL, and OSS BASIC XL. (The hex values and
memory move to copy the character set in lines 100
to 120 are not compatible with Atari BASIC.):
100 Rem Copy Rom (Eset) To RAM (Cset)
110 Eset = $e000: Cset = $9000
120 Move Eset, Cset, $0400
130 Rem Read the character index
140 Read Cindex
150 Rem Exit if index is end of data
160 If Cindex = -1 Then Goto 240
170 Rem Determine character location
180 Char = Cset + (Cindex * 8 )
190 Rem Read/Store 8 bytes
200 For Loop = Char to Char + 7
210 Read Cdata: Poke Loop, Cdata
220 Next Loop
230 Goto 140: Rem Read next index
240 Rem Program Continues Here...
rom num == Specifies the ROM page to start at (0 to 3). For
1024 byte fonts, page must be 0. For 512 byte fonts
page 0 or 2 may be used. (default 0)
pages nums == Specifies which 256 byte page(s) of the input font
to output and the order they are output. The
defaults are "0,1,2,3" for 1024 byte fonts, and
"0,1" for 512 byte fonts.
nopagecomment == Do not output the page comment. (default)
pagecomment == At the start of each page (32 character block)
output a descriptive comment.
Example for Page 3 in C format:
/* Page 0xE3. Chars 96 to 127 -- lowercase */
nocharcomment == Do not output the character information comment.
(default)
charcomment == Before each block of character bytes output the
character information.
Example for a control character in C format with Hex
data:
/* 0x7b ctrl-; */
0x00,0x18,0x3c,0x7e,0x7e,0x18,0x3c,0x00,
nobitscomment == Do not output the character bitmap comments.
(default)
bitscomment == After the block of character bytes output a series
of lines of text representing the character bitmap
as it would be rendered according to the "glyphtype"
value using the "pixel" character values to
represent the font pixels, according to the
"pixelsize".
Example shown for control character 0x7b as
glyphtype 2 in C format for hex data:
/* 0x00: . . . . . . . . */
/* 0x18: . . . # # . . . */
/* 0x3c: . . # # # # . . */
/* 0x7e: . # # # # # # . */
/* 0x7e: . # # # # # # . */
/* 0x18: . . . # # . . . */
/* 0x3c: . . # # # # . . */
/* 0x00: . . . . . . . . */
glyphtype num == Specify the glyph rendering type when the bitmap
comment is produced. The value is the corresponding
ANTIC text mode: 2, 3, 4. The values 5 through 7 are
also valid, but map to one of these other values: 5
is the same as 4, 6 and 7 are the same as 2. Antic
2 is two-color (bitmap), and Antic 4 is four-color
(bit pairs). Antic 3 is a two-color bitmap, but
occupies 10 scan lines using 8 bytes of data by
shifting the first two data rows of the lowercase
characters to the last scan lines, and filling in 0
data for all other "extra" scan lines. (default is
2)
pixelsize num == Specifies how many characters wide a "pixel" is when
the bitmap comment is produced. Valid values are 1
through 4. (default 2)
pixelfill num == Specifies how many times the character representing
a "pixel" will be written out within the pixel field
(specified by "pixelsize") when the bitmap comment
is produced. If the size of "pixelfill" is less
than "pixelsize" then the difference will be made up
by blank spaces. Valid values are 1 through 4.
(default 1)
pixel0 char(s) == Specifies the character to use to represent pixel
value 0 when the bitmap comment is produced. Note
that this and all other "pixel" values can be a
string of multiple characters determined by
"pixelsize" and "pixelfill" which can be used to
simulate the on screen aspect ratios more
accurately. (default ".")
pixel1 char(s) == Specifies the character to use to represent pixel
value 1 when the bitmap comment is produced.
(default "#")
pixel2 char(s) == Specifies the character to use to represent pixel
value 2 when the bitmap comment is produced.
(default "O")
pixel3 char(s) == Specifies the character to use to represent pixel
value 3 when the bitmap comment is produced.
(default "X")
Later options will likely override earlier options on the command line, so
conflicting options will usually not result in an error. However, the "rom"
option should come before the "pages" option. As an example: If a line
includes --asm followed by --basic then the output format will be DATA
statements for BASIC.