; DVX Configuration
;
; Video mode: the size and colors DVX starts in.  DVX takes one of the
; video card's modes no smaller than width x height, preferring the bpp
; asked for and that exact size, then 16 bpp, 15, 32, and 8; among larger
; modes alike, the first in the card's list.  With no such mode DVX starts
; in safe video mode (640x480) and asks whether to keep it.
; Common resolutions: 640x480, 800x600, 1024x768
; Color depths (bpp): 8, 15, 16, 32 (256, 32 thousand, 65 thousand, and 16
;        million colors); 24-bit modes are never used
; Control Panel's Video page saves the mode chosen there; Setup writes the
; mode it ran in.

[video]
width  = 1024
height = 768
bpp    = 16

; Mouse settings.
; wheel: normal or reversed
; wheelspeed: lines per wheel notch (1-10, default 3)
; doubleclick: double-click speed in milliseconds (default 500; Control
;        Panel's slider offers 200 to 900)
; acceleration: off, low, medium, high (default medium)
; speed: mouse travel needed per step of pointer movement (default 8; lower
;        = faster pointer; 0 keeps the mouse driver's own; Control Panel's
;        slider offers 2 to 32)

[mouse]
wheel        = normal
wheelspeed   = 3
doubleclick  = 500
acceleration = medium
speed        = 8

; Shell settings.
; desktop: path to the desktop app loaded at startup
; welcome: program started after the desktop (the Welcome window shown at
;          the first start); it removes this line itself when you tick
;          "Don't show this again"

[shell]
desktop = apps/kpunch/progman/progman.app
welcome = apps/kpunch/welcome/welcome.app

; Network settings (TCP/IP through a packet driver loaded before DVX).
; dhcp: true = get the address from a DHCP server; false = use address,
;       netmask and gateway below (gateway may be empty: this network only)
; dns1, dns2: name servers (empty = the DHCP server's; with dhcp false,
;       empty = none, and names cannot be looked up)
; hostname: this computer's name on the network: 1 to 63 letters, digits
;       and hyphens, not starting or ending with a hyphen
; vector: the packet driver's interrupt, 0x60 to 0x80, in hex as 0x60
;       (plain digits are decimal: 96 is 0x60), or auto to search 0x60-0x80

[network]
dhcp     = true
address  =
netmask  =
gateway  =
dns1     =
dns2     =
hostname = DVX
vector   = auto

; The package server (Software's File > Package Server): Software gets
; packages and updates from it, and publishes with the account.
; server: its host name (empty: DVX's own server); port: its port
; (empty: 80).  Software keeps both empty while they are DVX's own, so
; a DVX whose own server moves takes the new one.  DVX has no
; encryption, so an https:// server cannot be used.
; user, password: an account there, to publish packages (empty: none).
; Software saves the password scrambled; one typed here by hand is read
; as it is and scrambled the next time Software saves the settings.

[packages]
server   =
port     =
user     =
password =

; Printer settings: Control Panel's Printer page sets port, file, model,
; baud and handshake; Page Setup (File > Page Setup, or the Printer page's
; Page Setup button) the rest.
; port: LPT1, LPT2, LPT3, COM1 to COM4 (a serial printer), or FILE
;       (print into the file named by file)
; file: a name without a folder is in the USER folder
; baud, handshake: a serial printer's speed (300, 1200, 2400, 4800, 9600,
;       19200, or 38400; any other is 9600) and how it holds the computer
;       back: none, xonxoff, rtscts (its ready line on CTS), or dtrdsr (on
;       DSR, as Apple's ImageWriter cable wires it)
; model: text (any printer, text only), epson9, epson24 (Epson ESC/P
;        dot matrix), laserjet (HP PCL, 150 dpi), laserjet300 (HP
;        LaserJet III, DeskJet, and later; 300 dpi), epson9color,
;        epson24color (Epson with a color ribbon), deskjet500c,
;        deskjetcolor (DeskJet 550C and later), postscript,
;        postscriptcolor, imagewriter, or imagewritercolor (Apple
;        ImageWriter II); all but text print pictures, the color ones in
;        color
; linesPerPage: 0 = the printer's usual page length (66; 60 on the
;          LaserJets, DeskJets, and PostScript printers)
; columns: characters across the page; margins in lines (top, bottom)
;          and characters (left, right)
; header, footer: &f file name, &p page, &n pages, &d date, &t time,
;          &l &c &r left / centre / right, && an ampersand
; A page setup that cannot work (linesPerPage to footer: a value out of
; range, or margins that leave no room) is ignored as a whole, and the
; defaults are used.

[printer]
port         = LPT1
file         = PRINTER.PRN
model        = text
linesPerPage = 0
columns      = 80
marginTop    = 3
marginBottom = 3
marginLeft   = 5
marginRight  = 5
tabWidth     = 8
wrap         = true
header       = &f
footer       = Page &p
baud         = 9600
handshake    = dtrdsr

; Sound settings.
; driver: auto (find the sound hardware), wss (Windows Sound System),
;         sb (Sound Blaster family), gus (Gravis UltraSound), lpt (a
;         DAC on the printer port), speaker (PC speaker) or null (no
;         sound)
; rate: mixing rate in Hz (4000-48000, default 22050); the hardware uses
;       the nearest rate it can, which can be far from it (a printer-port
;       DAC at most 11048, the PC speaker 22096, a Gravis UltraSound at
;       most 617400 / gusVoices)
; bits, channels: 0 = the best the sound card can do, or 8 / 16 bits and
;       1 (mono) / 2 (stereo) to save work on a slow computer
; voices: sounds mixed at once (1-32, default 16); with all of them
;         playing, a new sound stops the quietest one only when it is
;         louder, else the new one does not play (music never stops a
;         sound)
; volume: master volume in percent (0-100)
; speakerPcm: true = play sampled sound on the PC speaker (takes a lot of
;             the computer's time); false = tones only
; fmTones: true = square and triangle tones play on the music synthesizer
;          chip when there is one; false = always mixed
; midi: where MIDI music plays: auto (a Gravis UltraSound's or Sound
;       Blaster AWE's recorded instruments, else the synthesizer chip,
;       else a built-in synthesizer), mpu401 (an external synthesizer on
;       the MIDI port; when the port was not found or is busy, as auto),
;       fm (the chip), software (the built-in synthesizer), or softwave
;       (the SoundFont played by the computer)
; midiIn: where MIDI input (a MIDI keyboard) comes from: none or mpu401
;         (the MIDI port, shared with MIDI music when midi = mpu401 too)
; modules: where music modules (MOD, S3M, XM, IT) play: wavetable (a
;          Gravis UltraSound's or Sound Blaster AWE's own voices when no
;          other music plays there and the module fits, else mixed by
;          the computer) or software (always mixed by the computer)
; mpuMode: what is on the MIDI port: gm (a General MIDI synthesizer),
;          mt32 (a Roland MT-32) or raw (send music unchanged)
; Optional: oplPort (default 388) and mpuPort (default 330), in hex; left
; empty, the default.
; midiBank = the instrument bank for MIDI music (OP2 format): its name in
; SHARED\BANKS or USER\BANKS (an add-on's as VENDOR\NAME), or a path from
; the DVX folder; not set, the bundled one.  Control Panel picks it;
; each MIDI music reads it as it starts.
; soundFont = the recorded instruments (a SoundFont, .SF2 or .SBK) for a
; Gravis UltraSound, a Sound Blaster AWE and softwave, named as midiBank
; is, or the path of a Gravis UltraSound's ULTRASND.INI (its patches);
; not set, KPUNCH\DVXGM.SF2 (an add-on), else the card's own.
; The Sound Blaster's port, IRQ, and DMA come from the BLASTER setting
; (for example SET BLASTER=A220 I5 D1 H5 in AUTOEXEC.BAT); without it
; only a Sound Blaster 16 is found (at 220 or 240).  An AWE needs BLASTER
; too, and its E (such as E620) names its music chip's port (without E,
; the A port + 400).  The Gravis UltraSound's come from ULTRASND (SET
; ULTRASND=220,1,1,11,5).
; Optional: gusVoices (14-32, default 28: fewer play at a higher rate);
; wssPort (hex: only that port is tried; not set, 530, 604, E80, and F40
; are tried in that order), wssIrq (7, 9, 10, or 11, default 7), and
; wssDma (0, 1, or 3, default 1) for a Windows Sound System card; lptDac
; (auto, covox, disney, or stereo; auto finds a Disney Sound Source or a
; Stereo-on-1, a Covox must be named) and lptPort (hex, default LPT1)
; for a DAC on the printer port.

[audio]
driver     = auto
rate       = 22050
bits       = 0
channels   = 0
voices     = 16
volume     = 100
speakerPcm = false
fmTones    = true
midi       = auto
midiIn     = none
modules    = wavetable
mpuMode    = gm

; Desktop sounds (Control Panel's Sounds page): the sound file (WAV or VOC)
; played for each event; empty, or the key missing, = no sound.  A name
; alone (or an add-on's, as VENDOR\NAME) is a file in the sound folders
; (your own in USER\SOUNDS first, then DVX's in SHARED\SOUNDS); any
; other name with a folder in it is that file.
; default: the default beep (also message boxes without an icon)
; startup, exit: DVX starting and ending
; error, warning, question, information: message boxes of that kind
; windowOpen, windowClose: a window opening or closing (not dialogs)

[sounds]
default     = beep.wav
startup     = startup.wav
exit        = exit.wav
error       = error.wav
warning     = warning.wav
question    = question.wav
information = info.wav
windowOpen  =
windowClose =