# 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).