# Bundled DOS Fonts

These TrueType fonts are from **The Ultimate Oldschool PC Font Pack** by VileR (int10h.org).

## Included Fonts

| Font | Description | Best For |
|------|-------------|----------|
| `Px437_IBM_VGA_8x16.ttf` | Classic IBM VGA 8x16 | Standard DOS text (80x25) |
| `Px437_IBM_VGA_9x16.ttf` | IBM VGA 9x16 (wider) | Better readability |
| `Px437_IBM_EGA_8x14.ttf` | IBM EGA 8x14 | 80x25 with smaller font |
| `Px437_IBM_CGA.ttf` | IBM CGA | 40-column mode, retro look |
| `Px437_IBM_MDA.ttf` | IBM MDA (Monochrome) | Word processing style |
| `PxPlus_IBM_VGA_8x16.ttf` | VGA 8x16 + Unicode | Extended character support |
| `PxPlus_IBM_VGA_9x16.ttf` | VGA 9x16 + Unicode | Extended + better readability |

## Font Naming Convention

- **Px437_** - Strict CP437 encoding (original DOS character set)
- **PxPlus_** - Extended Unicode with full CP437 + additional characters

## Usage in DOSBox-X

```python
from dosbox_mcp.tools import launch

# Use bundled IBM VGA font
launch(
    binary_path="/dos/RIPTERM.EXE",
    output="ttf",
    ttf_font="Px437_IBM_VGA_9x16",  # Font name without .ttf
    ttf_ptsize=20,
)
```

## License

These fonts are licensed under **Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)**.

See LICENSE.TXT for full license text.

**Attribution:**
- Font Pack: The Ultimate Oldschool PC Font Pack
- Author: VileR
- Website: https://int10h.org/oldschool-pc-fonts/