More docs.

This commit is contained in:
Scott Duensing 2026-03-20 21:15:37 -05:00
parent 26c3d7440d
commit 0a36dbe09e
2 changed files with 39 additions and 22 deletions

View file

@ -166,21 +166,6 @@ filenames at `~/.var/app/net._86box._86Box/data/86Box/dvx.iso`. Mount
it in 86Box as a CD-ROM drive and run `D:\DVX.EXE` (or whatever drive
letter is assigned).
### Floppy Image
For boot floppy setups with CD-ROM drivers:
```bash
mcopy -o -i <floppy.img> bin/dvx.exe ::DVX.EXE
mcopy -s -o -i <floppy.img> bin/apps ::APPS
mcopy -s -o -i <floppy.img> bin/config ::CONFIG
```
The `apps/` and `config/` directory structures must be preserved on the
target -- Program Manager recursively scans `apps/` for `.app` files at
startup.
## Configuration
DVX reads its configuration from `CONFIG\DVX.INI` on the target
@ -199,10 +184,31 @@ wheel = normal
doubleclick = 500
acceleration = medium
[colors]
desktop = 0,128,128
windowFace = 192,192,192
windowHighlight = 255,255,255
windowShadow = 128,128,128
activeTitleBg = 48,48,48
activeTitleFg = 255,255,255
inactiveTitleBg = 160,160,160
inactiveTitleFg = 64,64,64
contentBg = 192,192,192
contentFg = 0,0,0
menuBg = 192,192,192
menuFg = 0,0,0
menuHighlightBg = 48,48,48
menuHighlightFg = 255,255,255
buttonFace = 192,192,192
scrollbarBg = 192,192,192
scrollbarFg = 128,128,128
scrollbarTrough = 160,160,160
cursorColor = 255,255,255
cursorOutline = 0,0,0
[desktop]
wallpaper = C:\DVX\WPAPER\SWOOP.JPG
wallpaperMode = stretch
theme = C:\DVX\THEMES\WIN31.THM
mode = stretch
```
### Video Section
@ -216,18 +222,28 @@ theme = C:\DVX\THEMES\WIN31.THM
- `doubleclick` -- double-click speed in milliseconds (200--900)
- `acceleration` -- `off`, `low`, `medium`, or `high`
### Colors Section
All 20 system colors as `R,G,B` triplets (0--255). Key names match the
`ColorIdE` enum: `desktop`, `windowFace`, `windowHighlight`, `windowShadow`,
`activeTitleBg`, `activeTitleFg`, `inactiveTitleBg`, `inactiveTitleFg`,
`contentBg`, `contentFg`, `menuBg`, `menuFg`, `menuHighlightBg`,
`menuHighlightFg`, `buttonFace`, `scrollbarBg`, `scrollbarFg`,
`scrollbarTrough`, `cursorColor`, `cursorOutline`. Missing keys fall back to
compiled-in defaults (GEOS Ensemble palette). Colors can also be loaded from
standalone `.thm` theme files via the Control Panel.
### Desktop Section
- `wallpaper` -- path to wallpaper image (BMP, PNG, JPEG, GIF)
- `wallpaperMode` -- `stretch`, `tile`, or `center`
- `theme` -- path to color theme file (.thm)
- `mode` -- `stretch`, `tile`, or `center`
## Bundled Applications
| App | File | Type | Description |
|-----|------|------|-------------|
| Program Manager | `progman.app` | Callback | App launcher grid with icons; also provides the Task Manager (Ctrl+Esc) for switching between running apps |
| Program Manager | `progman.app` | Callback | App launcher grid with icons; Help menu opens the shell's Task Manager (Ctrl+Esc) |
| Notepad | `notepad.app` | Callback | Text editor with File/Edit menus, open/save dialogs, clipboard, and undo |
| Clock | `clock.app` | Main-loop | Digital clock display; multi-instance capable |
| DVX Demo | `dvxdemo.app` | Callback | Widget system showcase demonstrating all 32 widget types |

View file

@ -109,7 +109,8 @@ Shell.
launch.
- **Menu bar**: File (Run..., Exit Shell), Options (Minimize on Run), Window
(Cascade, Tile, Tile H, Tile V), Help (About, System Information, Task
Manager).
Manager). The Task Manager menu item opens the shell-level Task Manager
via `shellTaskMgrOpen()`.
- **Minimize on Run**: optional preference -- when enabled, Program Manager
minimizes itself after launching an app, getting out of the way.
- **Status bar**: shows the count of running applications, updated in