DVX_GUI/config/README.md

DVX Shipped Settings and Shared Files

The settings files DVX ships and the files it shares with every program. The build copies them into bin/ (text files converted to DOS line endings, CR+LF, with sed): the settings into bin/system/, the themes and wallpapers into bin/shared/. At its first start DVX copies DVX.INI to the user folder (USER, or the folder DVXUSER names), where every change is saved; the shipped copy is never written. File types work the same way, except that the user's ASSOC.INI holds only their changes to the shipped list.

Files

Source File	Build Output	Description
dvx.ini	bin/system/DVX.INI	The settings a new user starts with
ASSOC.INI	bin/system/ASSOC.INI	File associations: which program opens each document type (shellAssoc.h; changed on the Control Panel's File Types page, in the user's ASSOC.INI)
themes/cde.thm	bin/shared/themes/cde.thm	CDE color theme
themes/geos.thm	bin/shared/themes/geos.thm	GEOS Ensemble theme
themes/hotdog.thm	bin/shared/themes/hotdog.thm	Hot Dog Stand theme
themes/win31.thm	bin/shared/themes/win31.thm	Windows 3.1 theme
wpaper/blueglow.jpg	bin/shared/wpaper/blueglow.jpg	Wallpaper image
wpaper/swoop.jpg	bin/shared/wpaper/swoop.jpg	Wallpaper image
wpaper/triangle.jpg	bin/shared/wpaper/triangle.jpg	Wallpaper image
keys/*.KEY	bin/system/KEYS/*.KEY	DVX's repository key: packages it signs (DVX's own, and everything the package server publishes) are trusted as DVX's

The desktop sounds (bin/shared/sounds/) are made by mksounds and the fonts (bin/shared/fonts/) by mkfont (src/tools).

dvx.ini Format

Standard INI format with [section] headers and key = value pairs. Comments start with ;. The shell loads the user's copy at startup via prefsLoad(platformDvxIniPath()).

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

The Repository Key

DVX trusts as its own the packages signed by the keys in SYSTEM\KEYS, and refuses an update of DVX itself (kpunch.dvx) signed by any other. The key pair is made once, on a computer the package server never touches:

bin/host/dvxpkg keygen "DVX Repository" KPUNCH

KPUNCH.KEY (the public half) goes in config/keys/, so every build ships it. KPUNCH.SEC stays offline, with the operator who approves packages (server/README.md); config/keys/.gitignore keeps a stray copy of it out of the repository.