93 lines
2.2 KiB
Markdown
93 lines
2.2 KiB
Markdown
# DVX Configuration Files
|
|
|
|
Runtime configuration, theme files, wallpaper images, and module
|
|
dependency files. These are copied into `bin/config/` (INI, themes,
|
|
wallpapers) or `bin/libs/` (dep files) during the build.
|
|
|
|
|
|
## Files
|
|
|
|
| File | Destination | Purpose |
|
|
|------|-------------|---------|
|
|
| `dvx.ini` | `bin/config/dvx.ini` | Main configuration (video, mouse, colors, desktop) |
|
|
| `themes/*.thm` | `bin/config/themes/` | Color theme files (INI format with `[colors]` section) |
|
|
| `wpaper/*.jpg` | `bin/config/wpaper/` | Bundled wallpaper images |
|
|
| `libdvx.dep` | `bin/libs/libdvx.dep` | libdvx.lib dependency list |
|
|
| `dvxshell.dep` | `bin/libs/dvxshell.dep` | dvxshell.lib dependency list |
|
|
|
|
|
|
## DVX.INI Format
|
|
|
|
Standard `[section]` / `key = value` INI format. Converted to DOS
|
|
line endings (`\r\n`) during the build.
|
|
|
|
```ini
|
|
[video]
|
|
width = 640
|
|
height = 480
|
|
bpp = 16
|
|
|
|
[mouse]
|
|
wheel = normal # normal | reversed
|
|
doubleclick = 500 # milliseconds (200-900)
|
|
acceleration = medium # off | low | medium | high
|
|
|
|
[colors]
|
|
desktop = 0,128,128
|
|
windowFace = 192,192,192
|
|
# ... 20 color keys total (R,G,B triplets 0-255)
|
|
|
|
[desktop]
|
|
wallpaper = CONFIG\WPAPER\SWOOP.JPG
|
|
mode = stretch # stretch | tile | center
|
|
```
|
|
|
|
|
|
## Dependency Files (.dep)
|
|
|
|
Plain text, one dependency per line. Each line is the base name
|
|
(without extension) of a module that must be loaded before this one.
|
|
Lines starting with `#` are comments. Empty lines are ignored.
|
|
|
|
Example -- `dvxshell.dep`:
|
|
```
|
|
# Core libraries
|
|
libtasks
|
|
libdvx
|
|
|
|
# Widget modules used by the shell
|
|
box
|
|
button
|
|
checkbox
|
|
dropdown
|
|
label
|
|
listbox
|
|
listview
|
|
radio
|
|
separator
|
|
spacer
|
|
statbar
|
|
textinpt
|
|
```
|
|
|
|
Dep files are read by the loader during startup to determine the
|
|
correct load order via topological sort.
|
|
|
|
|
|
## Theme Files (.thm)
|
|
|
|
INI format with a `[colors]` section containing the same 20 color
|
|
keys as `dvx.ini`. Loaded via the Control Panel app or
|
|
`dvxLoadTheme()`.
|
|
|
|
```ini
|
|
[colors]
|
|
desktop = 0,128,128
|
|
windowFace = 192,192,192
|
|
windowHighlight = 255,255,255
|
|
windowShadow = 128,128,128
|
|
; ... remaining colors
|
|
```
|
|
|
|
Three themes are bundled: `geos.thm` (GEOS Ensemble), `win31.thm`
|
|
(Windows 3.1), `cde.thm` (CDE/Motif).
|