Repository navigation
Releases
1.02
XGDOS 1.02 – now for PC GEM too
XGDOS, the re-entrant Speedo GDOS replacement for the Atari ST, now also runs under PC GEM (FreeGEM / OpenGEM) on DOS. It gives PC GEM programs Speedo outline fonts at any size, through the same GDOS calls SpeedoGDOS programs use on the Atari: vst_arbpt, vqt_advance, v_ftext, v_getoutline and the rest. It's the same font engine as the Atari version, built as a 16-bit DOS program.
What's new
XGDOS for PC GEM
- Starts GEM itself. XGDOS isn't a TSR: GEM.BAT runs
XGDOS GEMVDI %1 %2 %3instead ofGEMVDI %1 %2 %3. XGDOS readsXGDOS.SYS, loads its font table and starts GEMVDI. When GEMVDI starts GEM, XGDOS puts itself in front of GEMVDI's VDI entry. Calls it doesn't handle go on to GEM untouched. When GEM ends, XGDOS ends. - Settings in
XGDOS.SYS. It uses the same settings and font lines as the Atari's ASSIGN.SYS XGDOS block:FONTPATH,CACHE,HEAP,HINTING, and a+FONTxxxx.SPDline for each font. - Leaves GEM as much conventional memory as possible. XGDOS has no C library at run time, and it puts its font memory in upper memory (UMBs) when DOS has some. GEM's desktop needs about 370 KB, and programs need more.
- Includes the eight Bitstream Speedo fonts: Charter and Courier 10 Pitch in all four styles.
- Test switches for tracking down problems:
SET XGPASS=1keeps XGDOS in front of GEM but passes every call straight on;SET XGNOHOOK=1loads XGDOS without putting it in front of GEM at all.
Atari
- No changes in what XGDOS does. The font engine now also builds as 16-bit code, so the shared sources picked up a few portability fixes.
Downloads
- XGDOS-1.02-PCGEM.zip:
XGDOS.EXE,XGDOS.SYS,README.TXT(installation),LICENSE.TXTand the fonts inFONTS. - Atari:
XGDOS.PRG,XGDOSCFG.PRGandXGDOSLOG.PRGwith theGEMSYSandDRIVERSfolders, as before.
Installing on PC GEM
- Copy
XGDOS.EXEandXGDOS.SYSinto GEM's system folder, the one withGEMVDI.EXEin it. On OpenGEM that'sC:\GEMAPPS\GEMSYS. - Copy the
FONTSfolder there as well, or setFONTPATHinXGDOS.SYSto wherever your fonts are. - In
GEM.BAT, changeGEMVDI %1 %2 %3toXGDOS GEMVDI %1 %2 %3.
Known limits on PC GEM
- XGDOS's own PDF printer, metafile and memory devices aren't in the PC version yet; GEM's own drivers handle those as before.
Tested
- OpenGEM 7 RC3 under DOSBox-X, with EdWord 3.0.14 for PC GEM (Font menu, outline text at any size) and Fbench 1.1.5 for PC GEM (all tests pass, including the GDOS group).
Licence
XGDOS is free software under the GNU GPL version 2, Copyright © 2026 Francis C Bullen. The Bitstream fonts keep their own licence (FONTS/COPYING.TXT).
XGDOS 1.01
XGDOS 1.01 – re-entrant Speedo GDOS replacement
XGDOS replaces SpeedoGDOS on the Atari ST/STE/TT/Falcon. It renders
Bitstream Speedo (.SPD) outline fonts at any size, prints to numbered
PDF files, and is safe for several processes at once under MiNT/MultiTOS.
| File | Purpose |
|---|---|
XGDOS.PRG |
the resident GDOS – put it in \AUTO (after MiNT if you use it) |
XGDOSLOG.PRG |
same, but logs font loading and printing to C:\XGDOS.LOG |
XGDOSCFG.PRG |
preferences (GEM program; rename to .ACC for an accessory) |
ASSIGN.SYS |
default configuration – goes in the root of the boot drive |
GEMSYS\ |
the Speedo font folder, with eight free Bitstream fonts (Charter, Courier 10 Pitch) – see below |
DRIVERS\ |
the GDOS driver folder (PATH); XGDOS needs nothing in it |
The project is laid out like the boot drive it installs to: ASSIGN.SYS
in the root, fonts in C:\GEMSYS, drivers in C:\DRIVERS.
Building
make # m68k-atari-mint-gcc, GNU make 3.81 is fine
make CROSS=m68k-atari-mintelf-
make host-test # renders a test screen + PDFs on the build machine
No C library is used (own startup, OS bindings and memcpy), only -lgcc.
Do not build with -mshort. The Makefile passes
-fno-tree-loop-distribute-patterns; keep it, or GCC may turn the copy
loop inside memcpy into a call to itself.
host-test expects the fonts in host/hostfs/C/FONTS/ and an ASSIGN.SYS
in host/hostfs/C/ (the host build maps C:\ there).
Installing
- Remove SpeedoGDOS/NVDI from
\AUTO. XGDOS will not load over another GDOS. - Copy
XGDOS.PRGtoC:\AUTO, andASSIGN.SYS,GEMSYS\and
DRIVERS\to the root ofC:. The default ASSIGN.SYS enables the
eight free fonts inGEMSYS\; add your own.SPDfiles there too. - Run
XGDOSCFG.PRGto enable your own fonts, add more font folders or
change the PDF folder. If you keep your old ASSIGN.SYS instead, just run
XGDOSCFG once and it adds the XGDOS block.
XGDOS readsX:\ASSIGN.SYS, thenX:\GEMSYS\ASSIGN.SYS, then
C:\ASSIGN.SYS(X = boot drive). The default paths assume drive C:;
change them in XGDOSCFG if you boot from another drive.
ASSIGN.SYS
Classic lines (PATH, device lines such as 21 STYLUS.SYS, bitmap .FNT
names under a device) keep their meaning. XGDOS adds:
FONTPATH = C:\GEMSYS Speedo font folder (default: PATH); repeat the
FONTPATH = C:\DRIVERS line for up to 4 folders, searched in order
PDFPATH = C:\PRINTS where printouts go (default: root of boot drive)
PDFNAME = PRN PRN0001.PDF, PRN0002.PDF ... (next free number)
PDFDPI = 600 resolution reported to applications (72-2400)
PAPER = A4 A4 / A5 / LETTER / LEGAL
CACHE = 48 glyph bitmap cache, KB
HEAP = 192 XGDOS memory, KB (fonts load into it on demand)
STACKS = 0 concurrent VDI calls; 0 = 4 under MiNT, 2 under TOS
HINTING = ON even stem weights, true shapes; FULL fits every stem; OFF
PRINTER = PDF PDF, or DRIVER to use the .SYS printer drivers
FSMC = OFF ON adds the SpeedoGDOS 'FSMC' cookie (see below)
MODE = FULL diagnostics: NOGDOS, NOFSMC or BYPASS
+BX000043.SPD enabled font
-BX000044.SPD disabled font (kept so XGDOSCFG can re-enable it)
+D:\FONTS\X.SPD 5050 full path and optional VDI font ID
A font given by bare name is looked for in each font folder in turn.
Several folders can also go on one line, separated by ;. If there are no
+/- lines, every *.SPD in the font folders is enabled. Without a
FONTPATH line the font folder is PATH, which is C:\DRIVERS in your
current ASSIGN.SYS.
XGDOSCFG
This is a non-modal window that works under MultiTOS and as an accessory:
- Font list: click the box (or Space, or a double-click) to enable or
disable a font. Fonts found in the folder but not yet listed show "new". - Add font... picks an
.SPDanywhere. Fonts outside the font folders
are stored with their full path. - Font folder rows (up to four): click a folder to change it or remove
it, or click the row below the last one to add another. The font list
is checked again straight away, so fonts that were "file not found"
turn black once their folder is listed, and new fonts show up. - PDF folder picks the folder printouts are written to.
- Remove removes the font from the list (the file is not deleted).
- Settings rows change when clicked: folders open a file selector, and the
others cycle through their values. - Save & Apply (Ctrl-S) rewrites ASSIGN.SYS, keeping every classic
line and saving the old file asASSIGN.BAK, then tells a running XGDOS
to reload. Applications see the new font list on their next
vst_load_fonts. HEAP and STACKS changes need a reboot.
Printing
Every print job gets its own file, the next free PRNnnnn.PDF. The file
is created when the job prints something, so a program that opens the
printer only to ask about it (its page size, say) leaves no empty PDF
behind and uses up no number. Applications see a 600 dpi (PDFDPI) page, so
programs that lay out at device resolution get the higher resolution
automatically. Output is vector throughout:
- Speedo text is embedded as glyph outlines (each glyph stored once per
file), so it stays sharp at any zoom or printer resolution. - The system font prints as PDF Courier (Atari umlauts mapped).
- Lines, fills, arcs, circles, ellipses, rounded boxes and markers become
PDF paths. Patterns are approximated as tints. vro_cpyfm/vrt_cpyfmfrom memory andv_bit_image(GEM.IMG) become
embedded images.- Printing is in colour: 256 colour indices, set with
vs_color. Colour
bitmaps (2, 4 or 8 planes) keep their colours. A colour.IMGprints
with its own palette when the file has anXIMGheader; without one,
its pixel values are treated as ST colour registers and printed with the
workstation's palette..IMGfiles with more than 8 planes print in
black and white. v_clrwk/v_form_advstart a new page, andv_clswkfinishes the file.
Devices
XGDOS runs stand-alone: it needs no SpeedoGDOS file and no .SYS driver.
Every device it supports is built in, so the driver names on the device
lines of ASSIGN.SYS are ignored for these:
| Device | ASSIGN.SYS line (yours) | What XGDOS does |
|---|---|---|
| 1–10 screen | 1P SCREEN.SYS … |
the TOS VDI draws; XGDOS adds Speedo text |
| 21–30 printer | 21 STYLUS.SYS |
numbered PDF files (PRINTER = PDF, the default) |
| 31–40 metafile | 31 META.SYS |
XGDOS's own GEM metafile writer |
| 61–70 memory | 61 MEMORY.SYS |
XGDOS's own off-screen bitmap renderer |
Other device numbers (plotters, cameras, tablets) and PRINTER = DRIVER
still load the .SYS file named in ASSIGN.SYS, for anyone who has one.
Metafile (31–40)
v_opnwk creates GEMFILE.GEM in the program's current folder;
vm_filename changes the name (as with META.SYS, the program deletes
GEMFILE.GEM itself). Drawing and attribute calls are recorded as GEM
metafile items in the standard little-endian format; queries are answered
by XGDOS and not recorded. v_meta_extents, vm_pagesize, vm_coords and
v_write_meta work as documented, and v_clswk writes the header with the
extents of everything drawn. Device space is 0–32767 with 85 µm pixels,
like META.SYS. v_ftext is stored as v_gtext, and vst_arbpt also as
vst_point, so older readers such as GEM Draw understand the file.
Memory (61–70)
As with MEMORY.SYS: set contrl[1] = 1 and put the width and height in
ptsin[0]/ptsin[1] before v_opnwk (otherwise the bitmap is the size of
the screen). The one-plane bitmap is allocated in the program's own memory
and its address comes back in contrl[0] (high word) and contrl[1];
v_clrwk and v_updwk clear it. XGDOS draws everything itself: lines with
all styles, widths and end styles; markers; filled polygons (even-odd, like
the VDI), bars, circles, ellipses, pies, arcs and rounded boxes with every
fill interior, pattern, hatch and user pattern; v_contourfill; all four
writing modes; clipping; vro_cpyfm, vrt_cpyfm, vr_trnfm and
v_get_pixel; Speedo text; and system font text with all effects and
90 degree rotation. Virtual workstations opened on it share the bitmap.
The system font comes from XGDOS itself, not the ROM: Line-A, the only way
to reach the ROM fonts, is deprecated on later TOS versions and missing
under some VDIs. XGDOS carries the EmuTOS system fonts in the full Atari ST
character set: 6×6 (8 pt), 8×8 (9 pt) and 8×16 (10 pt), each also
doubled (16, 18 and 20 pt), with the same metrics as the ST's own fonts.
As on the screen, vst_point takes the largest of these at or below the
size asked for, and vst_height the largest cell top (4, 6, 13, or
doubled 8, 12, 26). On every device font 1 is named "System Font" (TOS
itself calls it "6x6 system font", after its first size).
Fonts and the VDI
Speedo fonts appear after vst_load_fonts, as in SpeedoGDOS. Their VDI
font ID is 5000 + the Bitstream font ID (BX000043 is 5043, BX000044 is
5044), unless ASSIGN.SYS gives one. vqt_name returns the full font name
and sets intout[33] = 1 for outline fonts. vq_gdos returns '_FSM', so
Speedo-aware programs recognise XGDOS. The SpeedoGDOS FSMC cookie
('_SPD') is only installed with FSMC = ON: the MultiTOS AES treats it as
"the real SpeedoGDOS is here" and its desktop text disappears.
Implemented calls: vst_font, vst_point, vst_height, vst_arbpt(32),
vst_setsize(32), vst_skew, vst_rotation (any angle), vst_effects
(bold, light, italic, underline, outline), vst_alignment, vst_kern
(track and pair kerning from the font), vst_charmap, `v...