1 # This is the configurationfile for DOSBox 0.74. (Please use the latest version of DOSBox)
2 # Lines starting with a # are commentlines and are ignored by DOSBox.
3 # They are used to (briefly) document the effect of each option.
6 # fullscreen: Start dosbox directly in fullscreen. (Press ALT-Enter to go back)
7 # fulldouble: Use double buffering in fullscreen. It can reduce screen flickering, but it can also result in a slow DOSBox.
8 # fullresolution: What resolution to use for fullscreen: original or fixed size (e.g. 1024x768).
9 # Using your monitor's native resolution with aspect=true might give the best results.
10 # If you end up with small window on a large screen, try an output different from surface.
11 # windowresolution: Scale the window to this size IF the output device supports hardware scaling.
12 # (output=surface does not!)
13 # output: What video system to use for output.
14 # Possible values: surface, overlay, opengl, openglnb.
15 # autolock: Mouse will automatically lock, if you click on the screen. (Press CTRL-F10 to unlock)
16 # sensitivity: Mouse sensitivity.
17 # waitonerror: Wait before closing the console if dosbox has an error.
18 # priority: Priority levels for dosbox. Second entry behind the comma is for when dosbox is not focused/minimized.
19 # pause is only valid for the second entry.
20 # Possible values: lowest, lower, normal, higher, highest, pause.
21 # mapperfile: File used to load/save the key/event mappings from. Resetmapper only works with the defaul value.
22 # usescancodes: Avoid usage of symkeys, might not work on all operating systems.
26 fullresolution=original
27 windowresolution=original
32 priority=higher,normal
33 mapperfile=mapper-0.74.map
37 # language: Select another language file.
38 # machine: The type of machine tries to emulate.
39 # Possible values: hercules, cga, tandy, pcjr, ega, vgaonly, svga_s3, svga_et3000, svga_et4000, svga_paradise, vesa_nolfb, vesa_oldvbe.
40 # captures: Directory where things like wave, midi, screenshot get captured.
41 # memsize: Amount of memory DOSBox has in megabytes.
42 # This value is best left at its default to avoid problems with some games,
43 # though few games might require a higher value.
44 # There is generally no speed advantage when raising this value.
52 # frameskip: How many frames DOSBox skips before drawing one.
53 # aspect: Do aspect correction, if your output method doesn't support scaling this can slow things down!.
54 # scaler: Scaler used to enlarge/enhance low resolution modes.
55 # If 'forced' is appended, then the scaler will be used even if the result might not be desired.
56 # Possible values: none, normal2x, normal3x, advmame2x, advmame3x, advinterp2x, advinterp3x, hq2x, hq3x, 2xsai, super2xsai, supereagle, tv2x, tv3x, rgb2x, rgb3x, scan2x, scan3x.
63 # core: CPU Core used in emulation. auto will switch to dynamic if available and appropriate.
64 # Possible values: auto, dynamic, normal, simple.
65 # cputype: CPU Type used in emulation. auto is the fastest choice.
66 # Possible values: auto, 386, 386_slow, 486_slow, pentium_slow, 386_prefetch.
67 # cycles: Amount of instructions DOSBox tries to emulate each millisecond.
68 # Setting this value too high results in sound dropouts and lags.
69 # Cycles can be set in 3 ways:
70 # 'auto' tries to guess what a game needs.
71 # It usually works, but can fail for certain games.
72 # 'fixed #number' will set a fixed amount of cycles. This is what you usually need if 'auto' fails.
73 # (Example: fixed 4000).
74 # 'max' will allocate as much cycles as your computer is able to handle.
76 # Possible values: auto, fixed, max.
77 # cycleup: Amount of cycles to decrease/increase with keycombo.(CTRL-F11/CTRL-F12)
78 # cycledown: Setting it lower than 100 will be a percentage.
87 # nosound: Enable silent mode, sound is still emulated though.
88 # rate: Mixer sample rate, setting any device's rate higher than this will probably lower their sound quality.
89 # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
90 # blocksize: Mixer block size, larger blocks might help sound stuttering but sound will also be more lagged.
91 # Possible values: 1024, 2048, 4096, 8192, 512, 256.
92 # prebuffer: How many milliseconds of data to keep on top of the blocksize.
100 # mpu401: Type of MPU-401 to emulate.
101 # Possible values: intelligent, uart, none.
102 # mididevice: Device that will receive the MIDI data from MPU-401.
103 # Possible values: default, win32, alsa, oss, coreaudio, coremidi, none.
104 # midiconfig: Special configuration options for the device driver. This is usually the id of the device you want to use.
105 # See the README/Manual for more details.
112 # sbtype: Type of Soundblaster to emulate. gb is Gameblaster.
113 # Possible values: sb1, sb2, sbpro1, sbpro2, sb16, gb, none.
114 # sbbase: The IO address of the soundblaster.
115 # Possible values: 220, 240, 260, 280, 2a0, 2c0, 2e0, 300.
116 # irq: The IRQ number of the soundblaster.
117 # Possible values: 7, 5, 3, 9, 10, 11, 12.
118 # dma: The DMA number of the soundblaster.
119 # Possible values: 1, 5, 0, 3, 6, 7.
120 # hdma: The High DMA number of the soundblaster.
121 # Possible values: 1, 5, 0, 3, 6, 7.
122 # sbmixer: Allow the soundblaster mixer to modify the DOSBox mixer.
123 # oplmode: Type of OPL emulation. On 'auto' the mode is determined by sblaster type. All OPL modes are Adlib-compatible, except for 'cms'.
124 # Possible values: auto, cms, opl2, dualopl2, opl3, none.
125 # oplemu: Provider for the OPL emulation. compat might provide better quality (see oplrate as well).
126 # Possible values: default, compat, fast.
127 # oplrate: Sample rate of OPL music emulation. Use 49716 for highest quality (set the mixer rate accordingly).
128 # Possible values: 44100, 49716, 48000, 32000, 22050, 16000, 11025, 8000.
141 # gus: Enable the Gravis Ultrasound emulation.
142 # gusrate: Sample rate of Ultrasound emulation.
143 # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
144 # gusbase: The IO base address of the Gravis Ultrasound.
145 # Possible values: 240, 220, 260, 280, 2a0, 2c0, 2e0, 300.
146 # gusirq: The IRQ number of the Gravis Ultrasound.
147 # Possible values: 5, 3, 7, 9, 10, 11, 12.
148 # gusdma: The DMA channel of the Gravis Ultrasound.
149 # Possible values: 3, 0, 1, 5, 6, 7.
150 # ultradir: Path to Ultrasound directory. In this directory
151 # there should be a MIDI directory that contains
152 # the patch files for GUS playback. Patch sets used
153 # with Timidity should work fine.
163 # pcspeaker: Enable PC-Speaker emulation.
164 # pcrate: Sample rate of the PC-Speaker sound generation.
165 # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
166 # tandy: Enable Tandy Sound System emulation. For 'auto', emulation is present only if machine is set to 'tandy'.
167 # Possible values: auto, on, off.
168 # tandyrate: Sample rate of the Tandy 3-Voice generation.
169 # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
170 # disney: Enable Disney Sound Source emulation. (Covox Voice Master and Speech Thing compatible).
179 # joysticktype: Type of joystick to emulate: auto (default), none,
180 # 2axis (supports two joysticks),
181 # 4axis (supports one joystick, first joystick used),
182 # 4axis_2 (supports one joystick, second joystick used),
183 # fcs (Thrustmaster), ch (CH Flightstick).
184 # none disables joystick emulation.
185 # auto chooses emulation depending on real joystick(s).
186 # (Remember to reset dosbox's mapperfile if you saved it earlier)
187 # Possible values: auto, 2axis, 4axis, 4axis_2, fcs, ch, none.
188 # timed: enable timed intervals for axis. Experiment with this option, if your joystick drifts (away).
189 # autofire: continuously fires as long as you keep the button pressed.
190 # swap34: swap the 3rd and the 4th axis. can be useful for certain joysticks.
191 # buttonwrap: enable button wrapping at the number of emulated buttons.
200 # serial1: set type of device connected to com port.
201 # Can be disabled, dummy, modem, nullmodem, directserial.
202 # Additional parameters must be in the same line in the form of
203 # parameter:value. Parameter for all types is irq (optional).
204 # for directserial: realport (required), rxdelay (optional).
205 # (realport:COM1 realport:ttyS0).
206 # for modem: listenport (optional).
207 # for nullmodem: server, rxdelay, txdelay, telnet, usedtr,
208 # transparent, port, inhsocket (all optional).
209 # Example: serial1=modem listenport:5000
210 # Possible values: dummy, disabled, modem, nullmodem, directserial.
211 # serial2: see serial1
212 # Possible values: dummy, disabled, modem, nullmodem, directserial.
213 # serial3: see serial1
214 # Possible values: dummy, disabled, modem, nullmodem, directserial.
215 # serial4: see serial1
216 # Possible values: dummy, disabled, modem, nullmodem, directserial.
224 # xms: Enable XMS support.
225 # ems: Enable EMS support.
226 # umb: Enable UMB support.
227 # keyboardlayout: Language code of the keyboard layout (or none).
235 # ipx: Enable ipx over UDP/IP emulation.
240 # Lines in this section will be run at startup.
241 # You can put your MOUNT lines here.