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/ and bin/widgets/ (dep files) during the
build. Text files are converted to DOS line endings (CR+LF) via sed.
Files
| Source File |
Build Output |
Description |
dvx.ini |
bin/config/dvx.ini |
System configuration |
ASSOC.INI |
bin/config/ASSOC.INI |
File associations: which program opens each document type (shellAssoc.h; edited on the Control Panel's File Types page) |
themes/cde.thm |
bin/config/themes/cde.thm |
CDE color theme |
themes/geos.thm |
bin/config/themes/geos.thm |
GEOS Ensemble theme |
themes/hotdog.thm |
bin/config/themes/hotdog.thm |
Hot Dog Stand theme |
themes/win31.thm |
bin/config/themes/win31.thm |
Windows 3.1 theme |
wpaper/blueglow.jpg |
bin/config/wpaper/blueglow.jpg |
Wallpaper image |
wpaper/swoop.jpg |
bin/config/wpaper/swoop.jpg |
Wallpaper image |
wpaper/triangle.jpg |
bin/config/wpaper/triangle.jpg |
Wallpaper image |
libdvx.dep |
bin/libs/libdvx.dep |
libdvx dependency file |
texthelp.dep |
bin/libs/texthelp.dep |
texthelp dependency file |
listhelp.dep |
bin/libs/listhelp.dep |
listhelp dependency file |
dvxshell.dep |
bin/libs/dvxshell.dep |
dvxshell dependency file |
textinpt.dep |
bin/widgets/textinpt.dep |
TextInput widget dep file |
combobox.dep |
bin/widgets/combobox.dep |
ComboBox widget dep file |
spinner.dep |
bin/widgets/spinner.dep |
Spinner widget dep file |
terminal.dep |
bin/widgets/terminal.dep |
AnsiTerm widget dep file |
dropdown.dep |
bin/widgets/dropdown.dep |
Dropdown widget dep file |
listbox.dep |
bin/widgets/listbox.dep |
ListBox widget dep file |
listview.dep |
bin/widgets/listview.dep |
ListView widget dep file |
treeview.dep |
bin/widgets/treeview.dep |
TreeView widget dep file |
basrt.dep |
bin/libs/basrt.dep |
BASIC runtime dep file |
serial.dep |
bin/libs/serial.dep |
Serial communications dep file |
dvx.ini Format
Standard INI format with [section] headers and key = value pairs.
Comments start with ;. The shell loads this at startup via
prefsLoad("CONFIG/DVX.INI").
[video] Section
| Key |
Default |
Description |
width |
640 |
Requested horizontal resolution |
height |
480 |
Requested vertical resolution |
bpp |
16 |
Preferred color depth (8, 15, 16, 24, 32) |
The system picks the closest available VESA mode. If that mode cannot
be set, or a Shift key is held while DVX starts (or DVX /SAFE), the
shell starts in safe video mode (640x480, 16 bpp or the closest the card
has) and asks whether to write that mode here.
[mouse] Section
| Key |
Default |
Values |
Description |
wheel |
normal |
normal, reversed |
Scroll wheel direction |
wheelspeed |
3 |
1-10 |
Lines scrolled per wheel notch |
doubleclick |
500 |
200-900 |
Double-click speed (ms) |
acceleration |
medium |
off, low, medium, high |
Mouse acceleration |
speed |
8 |
2-32 |
Mickeys per 8 pixels of pointer travel (lower = faster pointer) |
[shell] Section
| Key |
Default |
Description |
desktop |
apps/kpunch/progman/progman.app |
Path to the desktop app loaded at startup |
welcome |
(none) |
Program started after the desktop; the shipped file names the Welcome window, which deletes the key when the user ticks "Don't show this again" |
[colors] Section
All 20 system colors as R,G,B triplets (0-255). Missing keys use
compiled-in defaults.
| Key |
Description |
desktop |
Desktop background |
windowFace |
Window frame and widget face |
windowHighlight |
Bevel highlight (top/left) |
windowShadow |
Bevel shadow (bottom/right) |
activeTitleBg |
Focused window title bar background |
activeTitleFg |
Focused window title bar text |
inactiveTitleBg |
Unfocused window title bar background |
inactiveTitleFg |
Unfocused window title bar text |
contentBg |
Content area background |
contentFg |
Content area text |
menuBg |
Menu background |
menuFg |
Menu text |
menuHighlightBg |
Menu selection background |
menuHighlightFg |
Menu selection text |
buttonFace |
Button face color |
scrollbarBg |
Scrollbar background |
scrollbarFg |
Scrollbar foreground |
scrollbarTrough |
Scrollbar track color |
cursorColor |
Mouse cursor foreground |
cursorOutline |
Mouse cursor outline |
[desktop] Section
| Key |
Default |
Values |
Description |
wallpaper |
(none) |
file path |
Path to wallpaper image |
mode |
stretch |
stretch, tile, center |
Wallpaper display mode |
[network] Section
Read by the networking library (dvxnet) when the stack starts; the
Control Panel's Network page edits it.
| Key |
Default |
Values |
Description |
dhcp |
true |
true, false |
Get the address from a DHCP server |
address |
(none) |
dotted IPv4 |
Static address (dhcp = false) |
netmask |
(none) |
dotted IPv4 |
Static subnet mask (dhcp = false) |
gateway |
(none) |
dotted IPv4 |
Static default gateway (optional) |
dns1, dns2 |
(none) |
dotted IPv4 |
Name servers; they win over the DHCP server's |
hostname |
DVX |
text |
Name sent to the DHCP server and returned by gethostname() |
vector |
auto |
auto, 0x60-0x80 |
Packet driver interrupt |
[printer] Section
Read by the printing library (print.lib) for every print; the Control
Panel's Printer page edits the port and model, File > Page Setup (and
the Printer page's Page Setup button) the rest. A page setup that
cannot work (margins leaving no room, values out of range) is ignored
as a whole in favour of the defaults.
| Key |
Default |
Values |
Description |
port |
LPT1 |
LPT1, LPT2, LPT3, FILE |
Where printed output goes |
file |
PRINTER.PRN |
file path |
The file used with port = FILE |
model |
text |
text, epson9, epson24, laserjet |
Printer model; all but text print pictures |
linesPerPage |
0 |
0, 10-200 |
Lines per page; 0 = the model's usual length (66, laser 60) |
columns |
80 |
20-255 |
Characters across the page |
marginTop, marginBottom |
3 |
lines |
Top and bottom margins (header / footer in their middle line) |
marginLeft, marginRight |
5 |
characters |
Left and right margins |
tabWidth |
8 |
1-16 |
Tab stops for printed text |
wrap |
true |
true, false |
Wrap long lines at a word, or cut them off |
header, footer |
&f, Page &p |
text |
&f file name, &p page, &n pages, &d date, &t time, &l &c &r left / centre / right, && an ampersand |
Theme Files (.thm)
Theme files use the same INI format as dvx.ini but contain only a
[colors] section with the 20 color keys. The Control Panel can
load and save themes via dvxLoadTheme() / dvxSaveTheme().
Bundled themes:
| File |
Description |
cde.thm |
CDE (Common Desktop Environment) -- warm tan/blue palette |
geos.thm |
GEOS Ensemble -- cyan/grey palette |
hotdog.thm |
Hot Dog Stand -- the infamous yellow/red/black palette |
win31.thm |
Windows 3.1 -- grey/navy palette |
Dependency Files (.dep)
Plain text files listing module base names that must be loaded before
this module. One name per line. Empty lines and # comments are
ignored. Names are case-insensitive.
Library Dependencies
| Dep File |
Module |
Dependencies |
libdvx.dep |
libdvx.lib |
libtasks |
texthelp.dep |
texthelp.lib |
libtasks, libdvx |
listhelp.dep |
listhelp.lib |
libtasks, libdvx |
dvxshell.dep |
dvxshell.lib |
libtasks, libdvx, texthelp, listhelp |
basrt.dep |
basrt.lib |
libtasks, libdvx |
serial.dep |
serial.lib |
libtasks, libdvx |
Widget Dependencies
| Dep File |
Widget |
Dependencies |
textinpt.dep |
textinpt.wgt |
texthelp |
combobox.dep |
combobox.wgt |
texthelp, listhelp |
spinner.dep |
spinner.wgt |
texthelp |
terminal.dep |
terminal.wgt |
texthelp |
dropdown.dep |
dropdown.wgt |
listhelp |
listbox.dep |
listbox.wgt |
listhelp |
listview.dep |
listview.wgt |
listhelp |
treeview.dep |
treeview.wgt |
listhelp |
Wallpaper Images
| File |
Description |
wpaper/blueglow.jpg |
Blue gradient glow |
wpaper/swoop.jpg |
Curved swoosh pattern |
wpaper/triangle.jpg |
Geometric triangle pattern |
Wallpapers support BMP, PNG, JPEG, and GIF formats. They are
pre-rendered to screen dimensions in native pixel format at load time.
