DVX_GUI/config
2026-03-22 21:03:10 -05:00
..
themes Start of major refactor for dynamic library and widget loading. 2026-03-22 20:50:25 -05:00
wpaper Start of major refactor for dynamic library and widget loading. 2026-03-22 20:50:25 -05:00
dvx.ini Start of major refactor for dynamic library and widget loading. 2026-03-22 20:50:25 -05:00
dvxshell.dep Start of major refactor for dynamic library and widget loading. 2026-03-22 20:50:25 -05:00
libdvx.dep Start of major refactor for dynamic library and widget loading. 2026-03-22 20:50:25 -05:00
README.md Docs. 2026-03-22 21:03:10 -05:00

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.

[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().

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