mirror of
https://github.com/alfishe/amiga-bootcamp.git
synced 2026-06-13 00:26:28 +00:00
Expand documentation suite: 30+ articles enriched with diagrams, code examples, and hardware details
Graphics: text_fonts (bitmap layout, styles), sprites (DMA, multiplexing), gfx_base (chipset detection), rastport (draw modes, clipping), ham_ehb (mermaid fixes), display_modes (HAM palettes) Devices: scsi (per-model interfaces, Gayle limits, CD-ROM, native vs vendor drivers), console (ANSI sequences, CON:/RAW:), parallel (CIA registers, pinout), timer (resource exhaustion), gameport (quadrature, XOR state) Libraries: workbench (WBStartup, AppWindow/Icon/MenuItem), rexxsyslib (ARexx port hosting, command parsing), diskfont (font directory, colour fonts), keymap (rawkey codes, dead keys), locale (catalogue system, date formatting), layers (ClipRect, refresh types), utility (TagItem chains), icon (DiskObject, ToolTypes), iffparse (IFF structure, ByteRun1), expansion (Zorro AutoConfig) Networking: tcp_ip_stacks (major rewrite - Amiga vs Unix architecture, SANA-II pipeline, PPP/SLIP dial-up, Ethernet cards, MiSTer), bsdsocket (pure API ref), sana2 (buffer hooks, driver requirements), protocols (all code examples). Deduplicated overlap between the three files. Toolchain: debugging (Enforcer patterns, SnoopDOS, GDB remote, kprintf checklist), sasc (pragma encoding, __saveds idioms), stormc (NEW - StormC IDE, C++, PowerPC) References: error_codes (DOS, Exec, trackdisk, Intuition error tables) Driver development: rtg_driver (Native driver analysis, P96 tuning) All 22 README indexes updated. Root README synced with stormc.md entry.
This commit is contained in:
Ilia Sharin
parent
0ded078134
commit
f61c26b542
38 changed files with 6402 additions and 1065 deletions
|
|
@ -1,10 +1,48 @@
|
|||
[← Home](../README.md) · [Libraries](README.md)
|
||||
|
||||
# diskfont.library — Disk-Based Fonts
|
||||
# diskfont.library — Disk-Based Font Loading
|
||||
|
||||
## Overview
|
||||
|
||||
`diskfont.library` loads bitmap fonts from disk (the `FONTS:` assign). ROM fonts (topaz 8, topaz 9) are always available; all others require this library.
|
||||
`diskfont.library` loads bitmap fonts from disk (the `FONTS:` assign). Only two fonts are built into ROM — **topaz 8** and **topaz 9**. All other fonts (helvetica, times, courier, etc.) must be loaded from disk via this library.
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
APP["Application"] -->|"OpenDiskFont(&ta)"| DFL["diskfont.library"]
|
||||
DFL -->|"Scans FONTS: directory"| FONTS["FONTS:<br/>helvetica.font<br/>helvetica/24"]
|
||||
DFL -->|"Returns loaded font"| TF["struct TextFont"]
|
||||
TF -->|"SetFont(rp, font)"| RP["RastPort"]
|
||||
|
||||
ROM["ROM"] -->|"OpenFont(&ta)"| TOPAZ["topaz 8/9<br/>(always available)"]
|
||||
|
||||
style DFL fill:#e8f4fd,stroke:#2196f3,color:#333
|
||||
style FONTS fill:#c8e6c9,stroke:#2e7d32,color:#333
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Font Directory Structure
|
||||
|
||||
Amiga bitmap fonts are stored as a descriptor file plus per-size data files:
|
||||
|
||||
```
|
||||
FONTS:
|
||||
helvetica.font ← font descriptor (FontContents header)
|
||||
helvetica/
|
||||
9 ← bitmap data for 9-pixel height
|
||||
11 ← bitmap data for 11-pixel height
|
||||
13 ← bitmap data for 13-pixel height
|
||||
18 ← bitmap data for 18-pixel height
|
||||
24 ← bitmap data for 24-pixel height
|
||||
times.font
|
||||
times/
|
||||
11
|
||||
13
|
||||
18
|
||||
24
|
||||
```
|
||||
|
||||
The `.font` descriptor file contains a `FontContentsHeader` listing all available sizes, styles, and flags.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -13,45 +51,106 @@
|
|||
```c
|
||||
struct Library *DiskfontBase = OpenLibrary("diskfont.library", 0);
|
||||
|
||||
/* Request a specific font and size: */
|
||||
struct TextAttr ta = {"helvetica.font", 24, 0, 0};
|
||||
struct TextFont *font = OpenDiskFont(&ta);
|
||||
if (font) {
|
||||
|
||||
if (font)
|
||||
{
|
||||
SetFont(rp, font);
|
||||
/* ... render ... */
|
||||
Move(rp, 10, 30);
|
||||
Text(rp, "Disk Font Text", 14);
|
||||
|
||||
/* When done with the font: */
|
||||
CloseFont(font);
|
||||
}
|
||||
else
|
||||
{
|
||||
/* Font not found — fall back to ROM font: */
|
||||
struct TextAttr fallback = {"topaz.font", 8, 0, FPF_ROMFONT};
|
||||
struct TextFont *topaz = OpenFont(&fallback);
|
||||
SetFont(rp, topaz);
|
||||
}
|
||||
|
||||
CloseLibrary(DiskfontBase);
|
||||
```
|
||||
|
||||
---
|
||||
### Size Matching
|
||||
|
||||
## Font Directory Structure
|
||||
|
||||
```
|
||||
FONTS:
|
||||
helvetica.font ← font descriptor file
|
||||
helvetica/
|
||||
24 ← bitmap data for size 24
|
||||
11 ← bitmap data for size 11
|
||||
```
|
||||
If the exact requested size is not available, `OpenDiskFont` returns NULL. To find the nearest available size, use `AvailFonts` to enumerate, then request the closest match.
|
||||
|
||||
---
|
||||
|
||||
## Listing Available Fonts
|
||||
## Enumerating Available Fonts
|
||||
|
||||
```c
|
||||
struct List *fontList = NULL;
|
||||
LONG count = AvailFonts(buf, bufsize, AFF_DISK | AFF_MEMORY);
|
||||
/* AvailFonts returns all fonts in ROM and on disk: */
|
||||
LONG bufSize = 4096;
|
||||
APTR buf = AllocMem(bufSize, MEMF_ANY | MEMF_CLEAR);
|
||||
|
||||
LONG shortfall = AvailFonts(buf, bufSize, AFF_DISK | AFF_MEMORY);
|
||||
if (shortfall > 0)
|
||||
{
|
||||
/* Buffer too small — reallocate and retry: */
|
||||
FreeMem(buf, bufSize);
|
||||
bufSize += shortfall;
|
||||
buf = AllocMem(bufSize, MEMF_ANY | MEMF_CLEAR);
|
||||
AvailFonts(buf, bufSize, AFF_DISK | AFF_MEMORY);
|
||||
}
|
||||
|
||||
struct AvailFontsHeader *afh = (struct AvailFontsHeader *)buf;
|
||||
struct AvailFonts *af = (struct AvailFonts *)&afh[1];
|
||||
for (int i = 0; i < afh->afh_NumEntries; i++) {
|
||||
Printf("%s %ld\n", af[i].af_Attr.ta_Name, af[i].af_Attr.ta_YSize);
|
||||
|
||||
for (int i = 0; i < afh->afh_NumEntries; i++)
|
||||
{
|
||||
Printf("%s size %-3ld %s\n",
|
||||
af[i].af_Attr.ta_Name,
|
||||
af[i].af_Attr.ta_YSize,
|
||||
(af[i].af_Type & AFF_DISK) ? "disk" :
|
||||
(af[i].af_Type & AFF_MEMORY) ? "ROM" : "scaled");
|
||||
}
|
||||
|
||||
FreeMem(buf, bufSize);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Font Types
|
||||
|
||||
| Flag | Source | Notes |
|
||||
|---|---|---|
|
||||
| `AFF_MEMORY` | ROM or already loaded in memory | topaz, or previously opened disk fonts |
|
||||
| `AFF_DISK` | Available on `FONTS:` | Requires disk access to load |
|
||||
| `AFF_SCALED` | Algorithmically scaled from another size | Lower quality; avoid when native size exists |
|
||||
| `AFF_BITMAP` | Bitmap (pixel) font | Standard Amiga font format |
|
||||
| `AFF_TAGGED` | Tagged (OS 3.0+ extended) font | Supports colour fonts, outlined fonts |
|
||||
|
||||
---
|
||||
|
||||
## Colour Fonts (OS 3.0+)
|
||||
|
||||
OS 3.0 introduced **colour bitmap fonts** — each glyph can have multiple bitplanes:
|
||||
|
||||
```c
|
||||
/* Colour fonts use ColorTextFont — an extension of TextFont: */
|
||||
struct ColorTextFont {
|
||||
struct TextFont ctf_TF; /* standard TextFont */
|
||||
UWORD ctf_Flags; /* CT_COLORFONT etc. */
|
||||
UBYTE ctf_Depth; /* number of bitplanes */
|
||||
UBYTE ctf_FgColor; /* default foreground pen */
|
||||
UBYTE ctf_Low; /* lowest colour used */
|
||||
UBYTE ctf_High; /* highest colour used */
|
||||
APTR ctf_PlanePick; /* plane selection */
|
||||
APTR ctf_PlaneOnOff; /* plane on/off defaults */
|
||||
struct ColorFontColors *ctf_ColorTable;
|
||||
APTR ctf_CharData[8]; /* per-plane glyph data */
|
||||
};
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## References
|
||||
|
||||
- NDK39: `diskfont/diskfont.h`
|
||||
- NDK39: `diskfont/diskfont.h`, `graphics/text.h`
|
||||
- ADCD 2.1: diskfont.library autodocs
|
||||
- See also: [text_fonts.md](../08_graphics/text_fonts.md) — TextFont structure and rendering
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue