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 it in 86Box as a CD-ROM drive and run `D:\DVX.EXE` (or whatever drive
letter is assigned). 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 ## Configuration
DVX reads its configuration from `CONFIG\DVX.INI` on the target DVX reads its configuration from `CONFIG\DVX.INI` on the target
@ -199,10 +184,31 @@ wheel = normal
doubleclick = 500 doubleclick = 500
acceleration = medium 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] [desktop]
wallpaper = C:\DVX\WPAPER\SWOOP.JPG wallpaper = C:\DVX\WPAPER\SWOOP.JPG
wallpaperMode = stretch mode = stretch
theme = C:\DVX\THEMES\WIN31.THM
``` ```
### Video Section ### Video Section
@ -216,18 +222,28 @@ theme = C:\DVX\THEMES\WIN31.THM
- `doubleclick` -- double-click speed in milliseconds (200--900) - `doubleclick` -- double-click speed in milliseconds (200--900)
- `acceleration` -- `off`, `low`, `medium`, or `high` - `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 ### Desktop Section
- `wallpaper` -- path to wallpaper image (BMP, PNG, JPEG, GIF) - `wallpaper` -- path to wallpaper image (BMP, PNG, JPEG, GIF)
- `wallpaperMode` -- `stretch`, `tile`, or `center` - `mode` -- `stretch`, `tile`, or `center`
- `theme` -- path to color theme file (.thm)
## Bundled Applications ## Bundled Applications
| App | File | Type | Description | | 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 | | 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 | | Clock | `clock.app` | Main-loop | Digital clock display; multi-instance capable |
| DVX Demo | `dvxdemo.app` | Callback | Widget system showcase demonstrating all 32 widget types | | DVX Demo | `dvxdemo.app` | Callback | Widget system showcase demonstrating all 32 widget types |

View file

@ -109,7 +109,8 @@ Shell.
launch. launch.
- **Menu bar**: File (Run..., Exit Shell), Options (Minimize on Run), Window - **Menu bar**: File (Run..., Exit Shell), Options (Minimize on Run), Window
(Cascade, Tile, Tile H, Tile V), Help (About, System Information, Task (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 - **Minimize on Run**: optional preference -- when enabled, Program Manager
minimizes itself after launching an app, getting out of the way. minimizes itself after launching an app, getting out of the way.
- **Status bar**: shows the count of running applications, updated in - **Status bar**: shows the count of running applications, updated in