User:Preza

1. This is the configurationfile for DOSBox 0.72.
2. Lines starting with a # are commentlines.
3. They are used to (briefly) document the effect of each option.

[sdl]

1. fullscreen -- Start dosbox directly in fullscreen.
2. fulldouble -- Use double buffering in fullscreen.
3. fullresolution -- What resolution to use for fullscreen: original or fixed size (e.g. 1024x768).
4. windowresolution -- Scale the window to this size IF the output device supports hardware scaling.
5. output -- What to use for output: surface,overlay,opengl,openglnb,ddraw.
6. autolock -- Mouse will automatically lock, if you click on the screen.
7. sensitiviy -- Mouse sensitivity.
8. waitonerror -- Wait before closing the console if dosbox has an error.
9. priority -- Priority levels for dosbox: lowest,lower,normal,higher,highest,pause (when not focussed).
10. Second entry behind the comma is for when dosbox is not focused/minimized.
11. mapperfile -- File used to load/save the key/event mappings from.
12. usescancodes -- Avoid usage of symkeys, might not work on all operating systems.

fullscreen=true fulldouble=false fullresolution=original windowresolution=original output=surface autolock=true sensitivity=100 waitonerror=true priority=higher,normal mapperfile=mapper.txt usescancodes=true

[dosbox]

1. language -- Select another language file.
2. memsize -- Amount of memory DOSBox has in megabytes.
3. machine -- The type of machine tries to emulate:hercules,cga,tandy,pcjr,vga.
4. captures -- Directory where things like wave,midi,screenshot get captured.

language= machine=vgahelp

captures=capture memsize=16

[render]

1. frameskip -- How many frames DOSBox skips before drawing one.
2. aspect -- Do aspect correction, if your output method doesn't support scaling this can slow things down!.
3. scaler -- Scaler used to enlarge/enhance low resolution modes.
4. Supported are none,normal2x,normal3x,advmame2x,advmame3x,hq2x,hq3x,
5. 2xsai,super2xsai,supereagle,advinterp2x,advinterp3x,
6. tv2x,tv3x,rgb2x,rgb3x,scan2x,scan3x.
7. If forced is appended (like scaler=hq2x forced), the scaler will be used
8. even if the result might not be desired.

frameskip=0 aspect=false scaler=normal2x

[cpu]

1. core -- CPU Core used in emulation: normal,simple,dynamic,auto.
2. auto switches from normal to dynamic if appropriate.
3. cycles -- Amount of instructions DOSBox tries to emulate each millisecond.
4. Setting this value too high results in sound dropouts and lags.
5. You can also let DOSBox guess the correct value by setting it to max.
6. The default setting (auto) switches to max if appropriate.
7. cycleup -- Amount of cycles to increase/decrease with keycombo.
8. cycledown Setting it lower than 100 will be a percentage.

core=auto cycles=auto cycleup=500 cycledown=20

[mixer]

1. nosound -- Enable silent mode, sound is still emulated though.
2. rate -- Mixer sample rate, setting any devices higher than this will
3. probably lower their sound quality.
4. blocksize -- Mixer block size, larger blocks might help sound stuttering
5. but sound will also be more lagged.
6. prebuffer -- How many milliseconds of data to keep on top of the blocksize.

nosound=false rate=22050 blocksize=2048 prebuffer=10

[midi]

1. mpu401 -- Type of MPU-401 to emulate: none, uart or intelligent.
2. device -- Device that will receive the MIDI data from MPU-401.
3. This can be default,alsa,oss,win32,coreaudio,none.
4. config -- Special configuration options for the device. In Windows put
5. the id of the device you want to use. See README for details.

mpu401=intelligent device=default config=

[sblaster]

1. sbtype -- Type of sblaster to emulate:none,sb1,sb2,sbpro1,sbpro2,sb16.
2. sbbase,irq,dma,hdma -- The IO/IRQ/DMA/High DMA address of the soundblaster.
3. mixer -- Allow the soundblaster mixer to modify the DOSBox mixer.
4. oplmode -- Type of OPL emulation: auto,cms,opl2,dualopl2,opl3.
5. On auto the mode is determined by sblaster type.
6. All OPL modes are 'Adlib', except for CMS.
7. oplrate -- Sample rate of OPL music emulation.

sbtype=sb16 sbbase=220 irq=7 dma=1 hdma=5 mixer=true oplmode=auto oplrate=22050

[gus]

1. gus -- Enable the Gravis Ultrasound emulation.
2. gusbase,irq1,irq2,dma1,dma2 -- The IO/IRQ/DMA addresses of the
3. Gravis Ultrasound. (Same IRQ's and DMA's are OK.)
4. gusrate -- Sample rate of Ultrasound emulation.
5. ultradir -- Path to Ultrasound directory. In this directory
6. there should be a MIDI directory that contains
7. the patch files for GUS playback. Patch sets used
8. with Timidity should work fine.

gus=true gusrate=22050 gusbase=240 irq1=5 irq2=5 dma1=3 dma2=3 ultradir=C:\ULTRASND

[speaker]

1. pcspeaker -- Enable PC-Speaker emulation.
2. pcrate -- Sample rate of the PC-Speaker sound generation.
3. tandy -- Enable Tandy Sound System emulation (off,on,auto).
4. For auto Tandysound emulation is present only if machine is set to tandy.
5. tandyrate -- Sample rate of the Tandy 3-Voice generation.
6. disney -- Enable Disney Sound Source emulation. Covox Voice Master and Speech Thing compatible.

pcspeaker=true pcrate=22050 tandy=auto tandyrate=22050 disney=true

[joystick]

1. joysticktype -- Type of joystick to emulate: auto (default), none,
2. 2axis (supports two joysticks,
3. 4axis (supports one joystick, first joystick used),
4. 4axis_2 (supports one joystick, second joystick used),
5. fcs (Thrustmaster), ch (CH Flightstick).
6. none disables joystick emulation.
7. auto chooses emulation depending on real joystick(s).
8. timed -- enable timed intervals for axis. (false is old style behaviour).
9. autofire -- continuously fires as long as you keep the button pressed.
10. swap34 -- swap the 3rd and the 4th axis. can be useful for certain joysticks.
11. buttonwrap -- enable button wrapping at the number of emulated buttons.

joysticktype=auto timed=true autofire=false swap34=false buttonwrap=true

[serial]

1. serial1-4 -- set type of device connected to com port.
2. Can be disabled, dummy, modem, nullmodem, directserial.
3. Additional parameters must be in the same line in the form of
4. parameter:value. Parameter for all types is irq.
5. for directserial: realport (required), rxdelay (optional).
6. for modem: listenport (optional).
7. for nullmodem: server, rxdelay, txdelay, telnet, usedtr,
8. transparent, port, inhsocket (all optional).
9. Example: serial1=modem listenport:5000

serial1=dummy serial2=dummy serial3=disabled serial4=disabled

[dos]

1. xms -- Enable XMS support.
2. ems -- Enable EMS support.
3. umb -- Enable UMB support.
4. keyboardlayout -- Language code of the keyboard layout (or none).

xms=true ems=true umb=true keyboardlayout=none

[ipx]

1. ipx -- Enable ipx over UDP/IP emulation.

ipx=false

[autoexec]

1. Lines in this section will be run at startup.