VOGONS


User friendly DosBox.conf

Topic actions

First post, by DosFreak

User metadata
Rank l33t++
Rank
l33t++

I decided to create a more user friendly dosbox.conf because some of the .conf entries do not make any sense from a user standpoint. Feel free to tell me how FUGLY it looks or to provide suggestions.

NOTES

Don't ask about supposed duplicate or unecessary entries.

Ex:

[****MEMORY****] # memsize -- Amount of memory assigned to DosBox (in megabytes) # xms -- Enable XMS support. (false,true) # ems […]
Show full quote

[****MEMORY****]
# memsize -- Amount of memory assigned to DosBox (in megabytes)
# xms -- Enable XMS support. (false,true)
# ems -- Enable EMS support. (false,true)
# umb -- Enable UMB support (false,true,max).
#---------------------------------
[dosbox]
memsize=16
[dos]
xms=true
ems=true
umb=true

the [ ] are required.....

********DOSBOX EXTERNAL********] # ALL SETTINGS THAT REFER TO HOW YOU INTERACT WITH DOSBOX. […]
Show full quote

********DOSBOX EXTERNAL********]
# ALL SETTINGS THAT REFER TO HOW YOU INTERACT WITH DOSBOX.

[********VIDEO********]
#FULLSCREEN -- Start dosbox in full screen on execution.
#FULLDOUBLE -- Use double buffering in full screen.
#FULLFIXED -- TRUE=Will resize the screen to resolution specified in "FULLRESOLUTION"
# FALSE=Will not resize the screen and let the game specify the resolution.
#FULLRESOLUTION -- Used if you do not want the game to specify the resolution.
# Option mostly used for LCD's when the LCD cannot handle lower resolutions well.
# So set FULLRESOLUTION to the native resolution of your monitor for best results.
# 0x0=Sets DosBox to use your desktop resolution.
# Must set FULLFIXED to TRUE to use FULLRESOLUTION!.
#OUTPUT -- What to use for output: surface,overlay,opengl,openglnb.
#HWSCALE -- Extra scaling of window if the output device supports hardware scaling.
# Surface doesn't support scaling.
#FRAMESKIP -- Specifies how many frames DosBox skips before drawing another.
# Only really usefull for games that have alot of movement or for reducing the
# amount of DosBox overhead since video emulation uses alot of processing power.
#ASPECT -- Do aspect correction.
#SCALER -- Scaler used to enlarge/enhance low resolution modes.
# Supported are none,normal2x,advmame2x,advmame3x,advinterp2x,interp2x,tv2x.
# I took the following from the ScummVM readme (modified for DosBox), credit goes to them for gathering the info:
#DosBox offers several anti-aliasing filters to attempt to improve visual quality. These
#filters take the original game graphics, and scale them by a certain fixed factor
#(usually 2x or 3x) before displaying them to you. For example, if the game originally ran at
#a resolution of 320x200, then using a filter with a scale factor of 2x will effectively
#yield 640x400 graphics. Likewise with a 3x filter you'll get 960x600.
#NORMAL2x= No filtering. (No increase in image quality)
#ADVMAME2x=Based on scale2x from Mame project.
# Source: http://scale2x.sourceforge.net/
# Scale2x is real-time graphics effect able to increase the size of small bitmaps
# guessing the missing pixels without interpolating pixels and blurring the images.
#ADVMAME3x=Same as advmame2x except 3x.
#ADVINTERP2X=
#INTERP2X=
#TV2X= Interlace filter, tries to emulate a TV.
#---------------------------------
[sdl]
fullscreen=false
fulldouble=false
output=surface
hwscale=1
[render]
frameskip=0
scaler=none
#********************
#LCD OPTIONS
#********************
[sdl]
fullfixed=false
fullresolution=0x0
[render]
aspect=false

[****INPUT****]
# AUTOLOCK -- Mouse will automatically lock, if you click on the DosBox screen.
# SENSITIVITY -- Mouse sensitivity.
# MAPPERFILE -- File used to load/save the key/event mappings from (Activated by CTRL+F1).
#---------------------------------
[sdl]
autolock=true
sensitivity=100
mapperfile=mapper.txt

[****SCREENSHOTS****]
# CAPTURES -- Directory where wave, midi, and screenshots are saved.
# If there is no capture directory in the DosBox directory then create one.
#---------------------------------
[dosbox]
captures=capture

[****INTERFACE****]
# WAITONERROR -- Wait before closing the console if dosbox has an error.
# Usefull if you want to copy an error message out of the console window.
#---------------------------------
[sdl]
waitonerror=true

[****PRIORITY****]
# PRIORITY -- Priority levels for dosbox: lower,normal,higher,highest.
# Second entry behind the comma is for when dosbox is not focused/minimized.
#---------------------------------
[sdl]
priority=higher,normal

[********DOSBOX INTERNAL********]
# ALL SETTINGS THAT AFFECT DOSBOX EMULATION.

[****PROCESSOR****]
# CORE -- CPU Core used in emulation: dynamic, simple, normal, full
# Ordered from fastest to slowest
# CYCLES -- Amount of instructions dosbox tries to emulate each millisecond.
# Check Task Manager and make sure that you are not using 100% processor.
# CYCLEUP -- Amount of cycles to increase/decrease with CTRL F11(-)/F12(+).
# CYCLEDOWN Setting it lower than 100 will be a percentage.
#---------------------------------
[cpu]
core=normal
cycles=3000
cycleup=500
cycledown=20

[****VIDEO****]
# MACHINE -- The type of video card DosBox emulates: vga, cga, tandy, hercules
# Ordered from most likely used to least likely.
#---------------------------------
[dosbox]
machine=vga

[****MEMORY****]
# MEMSIZE -- Amount of memory assigned to DosBox (in megabytes)
# XMS -- Enable XMS support. (false,true)
# EMS -- Enable EMS support. (false,true)
# UMB -- Enable UMB support (false,true,max).
#---------------------------------
[dosbox]
memsize=16
[dos]
xms=true
ems=true
umb=false

[****INPUT****]
# JOYSTICKTYPE -- Type of joystick to emulate: none, 2axis, 4axis,
# fcs (Thrustmaster) ,ch (CH Flightstick).
# none disables joystick emulation.
# 2axis is the default and supports two joysticks.
#---------------------------------
[bios]
joysticktype=2axis

[****NETWORK****]
#IPX -- Enable GUEST IPX emulation over HOST UDP/IP.
ipx=false

[****SOUND****]

[mixer]
# NOSOUND -- Enable silent mode, sound is still emulated though.
# RATE -- Mixer sample rate, setting any devices higher than this will
# probably lower their sound quality, Options=8000, 11025, 22050, 44100
# BLOCKSIZE -- Mixer block size, larger blocks might help sound stuttering
# but sound will also be more lagged.
# PREBUFFER -- How many milliseconds of data to keep on top of the blocksize.
#---------------------------------
nosound=false
rate=22050
blocksize=2048
prebuffer=10

[midi]
# MPU401 -- Enable MPU-401 (MIDI) Emulation.
# INTELLIGENT -- Operate in Intelligent mode.
# DEVICE -- Device that will receive the MIDI data from MPU-401.
# This can be default,alsa,oss,win32,coreaudio,none.
# CONFIG -- Special configuration options for the device. In Windows put
# the id of the device you want to use. See README for details.
#---------------------------------
mpu401=true
intelligent=true
device=default
config=

[sblaster]
# TYPE -- Type of SoundBlaster to emulate:none,sb1,sb2,sbpro1,sbpro2,sb16.
# base,irq,dma,hdma -- The IO/IRQ/DMA/High DMA address of the soundblaster.
# Usually either IRQ 5 or IRQ 7 for Old DOS games.
# MIXER -- Allow the soundblaster mixer to modify the dosbox mixer.
# OPLMODE -- Type of OPL emulation: auto,cms,opl2,dualopl2,opl3.
# On auto the mode is determined by sblaster type.
# OPLRATE -- Sample rate of OPL music emulation. Options=8000, 11025, 22050, 44100
#---------------------------------
type=sb16
base=220
irq=7
dma=1
hdma=5
mixer=true
oplmode=auto
oplrate=22050

[gus]
# GUS -- Enable the Gravis Ultrasound emulation.
# base,irq1,irq2,dma1,dma2 -- The IO/IRQ/DMA addresses of the
# Gravis Ultrasound. (Same IRQ's and DMA's are OK.)
# RATE -- Sample rate of Ultrasound emulation. Options=8000, 11025, 22050, 44100
# ULTRADIR -- Path to Ultrasound directory. In this directory
# there should be a MIDI directory that contains
# the patch files for GUS playback. Patch sets used
# with Timidity should work fine.
#---------------------------------
gus=true
rate=22050
base=240
irq1=5
irq2=5
dma1=3
dma2=3
ultradir=C:\ULTRASND

[speaker]
# PCSPEAKER -- Enable PC-Speaker emulation.
# PCRATE -- Sample rate of the PC-Speaker sound generation.
# 8000, 11025, 22050, 44100
# TANDYRATE -- Sample rate of the Tandy 3-Voice generation.
# Tandysound emulation is present if machine is set to tandy.
# 8000, 11025, 22050, 44100
# DISNEY -- Enable Disney Sound Source emulation.
#---------------------------------
pcspeaker=true
pcrate=22050
tandyrate=22050
disney=true

[********PORTS********]

[****serial****]
# SERIAL1-4 -- set type of device connected to com port.
# Can be disabled, dummy, modem, directserial.
# Additional parameters must be in the same line in the form of
# parameter:value. Parameters for all types are irq, startbps, bytesize,
# stopbits, parity (all optional).
# for directserial: realport (required).
# for modem: listenport (optional).
#---------------------------------
[serial]
serial1=dummy
serial2=dummy
serial3=disabled
serial4=disabled

[****LANGUAGE****]
# LANGUAGE -- Select another language file.
#---------------------------------
[dosbox]
language=

[autoexec]
# Lines in this section will be run at startup.
#---------------------------------
REM @echo off
REM mount c c:\
REM c:

Attachments

  • Filename
    dosboxconf.txt
    File size
    8.45 KiB
    Downloads
    280 downloads
    File license
    Fair use/fair dealing exception
Last edited by DosFreak on 2005-11-19, 02:40. Edited 4 times in total.

How To Ask Questions The Smart Way
Make your games work offline

Reply 3 of 21, by GreatBarrier86

User metadata
Rank Newbie
Rank
Newbie

I like what you did but i would like to expand on it if you don't mind. First, i would suggest listing the scaler modes quality wise. Second, perhaps use dosbox wiki to explain each of the scaler modes. You know, for the newbie. I'll take a stab at it. What do you think?

IBM ThinkPad X40
1.2Ghz with 2MB L2 cache
1.0GB DDR2 SDRAM
Intel 852/855GME Graphics Media Accelerator with 64MB
12'' LCD Screen
SoundMax Integrated Audio

Peas Pobie!

Reply 4 of 21, by DosFreak

User metadata
Rank l33t++
Rank
l33t++

Yeah, the scalers are complicated tho..

Different configurations, LCD/CRT. Different games look better with different scalers, some scalers perform better than others....but I guess from a technical standpoint they could be listed quality wise.

I do agree that there needs to be a better explanation on what each scaler does for the end user since it is somewhat complicated and most of the DosBox userbase unfortunately probably do not even use them (Except of course for the default scaler).

How To Ask Questions The Smart Way
Make your games work offline

Reply 5 of 21, by GreatBarrier86

User metadata
Rank Newbie
Rank
Newbie

True. I noticed something interesting. I use a laptop LCD and it doesn't display the advmame3x very well. Everything looks very cartoony. Interesting thing.

Also, won't a newbie try to use a frontend to make the setup easier?

Reply 7 of 21, by 5u3

User metadata
Rank Oldbie
Rank
Oldbie

Nice work! It provides a comprehensive list of the options, one can at least make an educated guess what they mean by the descriptions.

Also, won't a newbie try to use a frontend to make the setup easier?

Not every "newbie", I guess. For example, I'm a DOSBox newbie (have used it only once so far), but prefer editing a config file rather than clicking through a (GUI) frontend.

Reply 10 of 21, by DosFreak

User metadata
Rank l33t++
Rank
l33t++

Updated the .conf.

Don't cut and past (formatting is messed up). Download the attachment.

Moved the most commonly used sections to the top of the .conf and the least used to the bottom.
Expanded the VIDEO section with explanations
Capitalized the settings (FULLFIXED,FULLRESOLUTION) for easier reading.
Corrected some spelling mistakes and reworded some explanations.

HunterZ,
I placed fullresolution/fullfixed under the LCD section since they are most commonly used by LCD users. They can be used by CRT owners I suppose....I don't know why they would tho.

How To Ask Questions The Smart Way
Make your games work offline

Reply 11 of 21, by GreatBarrier86

User metadata
Rank Newbie
Rank
Newbie

Do you think it would be wise to explain some of the features? Eg: what does intelligent mode actually mean?

IBM ThinkPad X40
1.2Ghz with 2MB L2 cache
1.0GB DDR2 SDRAM
Intel 852/855GME Graphics Media Accelerator with 64MB
12'' LCD Screen
SoundMax Integrated Audio

Peas Pobie!

Reply 12 of 21, by Qbix

User metadata
Rank DOSBox Author
Rank
DOSBox Author

please note that if an option is specified twice the last encountered one is used.

Water flows down the stream
How to ask questions the smart way!

Reply 13 of 21, by HunterZ

User metadata
Rank l33t++
Rank
l33t++

DosFreak, I end up tweaking fullresolution almost every time I play with full screen on my CRTs (which is admittedly rare) because scaling 320x200 DOS games to my native desktop resolution of 1600x1200 would be overkill. I was also just using it to test DOSBox via my video card's TV out (to a TV)

Reply 14 of 21, by DosFreak

User metadata
Rank l33t++
Rank
l33t++

Hmmmm, split them off into LCD Options to remove confusion.....either I could write a note in there about other uses besides correcting for LCD native resolution or I could remove the LCD options category.....or I could do both....

How To Ask Questions The Smart Way
Make your games work offline

Reply 16 of 21, by Qbix

User metadata
Rank DOSBox Author
Rank
DOSBox Author

you know this is only a suggestion by dosFreak. I haven't implemented something like this at all. Must even think on how to implement it if it's going to be implemeted.

Water flows down the stream
How to ask questions the smart way!

Reply 17 of 21, by GreatBarrier86

User metadata
Rank Newbie
Rank
Newbie

Very nice changes. Qbix, if you can, you should really use this

IBM ThinkPad X40
1.2Ghz with 2MB L2 cache
1.0GB DDR2 SDRAM
Intel 852/855GME Graphics Media Accelerator with 64MB
12'' LCD Screen
SoundMax Integrated Audio

Peas Pobie!

Reply 18 of 21, by Dominus

User metadata
Rank DOSBox Moderator
Rank
DOSBox Moderator

Feeling necrophiliac... 😀
I have overlooked this thread. Even though it is out of date, I like it a lot and it would make it easier if I were a newbie 😀

Windows 3.1x guide for DOSBox
60 seconds guide to DOSBox
DOSBox SVN snapshot for macOS (10.4-11.x ppc/intel 32/64bit) notarized for gatekeeper