DOSBoxWiki - User contributions [en]

Configuration:RENDER

2009-12-25T04:15:48Z

Quoth: /* scaler */

The rendering (drawing) section controls methods that DOSBox uses to improve the speed and quality of the graphics displayed on the screen. E.g. it can "forget" (skip) the every 3rd screen update (which will save time), or it can try to smooth out some of the coarse low-resolution graphics that was used on old displays, but which looks bad when shown on a modern, high-resolution screen.

==== frameskip = ''nnn'' ====
How many frames DOSBox skips before drawing one.

Default is '''0'''.

==== aspect = true | '''false''' ====
Do [[/render/aspect|aspect correction]]. It only affects non-square pixel modes (like for example Mode 13h, which has a resolution of 320x200 pixels and it's used by many DOS games), and it's needed to get correct aspect ratio on square-pixel screens in windowed mode.

However, it may look weird in some situations due to line doubling. Also, many people don't notice it when the aspect ratio is distorted and may even prefer it without correction. It depends on the game.

Default is '''false'''.

==== scaler = none | normal2x | normal3x | tv2x | tv3x | rgb2x | rgb3x | scan2x | scan3x | advmame2x | advmame3x | advinterp2x | advinterp3x | 2xsai | super2xsai | supereagle | hq2x | hq3x ====

Specifies which scaler is used to enlarge and enhance low resolution modes. To see comparisons between the different scalers, see [[Scaler]].
:none: no scaling is performed.
:normal: nearest-neighbour scaling (big square pixels).
:scan: like 'normal', but with horizontal black lines.
:tv: like 'scan', but with darkened versions of the data instead of black lines.
:rgb: simulates the phosphors on a dot trio CRT.
:advmame: smooths corners and removes jaggies from diagonal lines.
:advinterp: identical to 'advmame'.
:sai: similar to 'advmame' but with much softer color gradients and edges.
:supersai: similar to 'sai' but sharper.
:hq: a 'high quality' scaler which delivers a cleaner and sharper image than 'advmame' or 'sai' scalers.

Default is '''normal2x'''.

Supported scalers which still need descriptions: supereagle

Dosbox.conf

2009-12-25T03:49:25Z

Quoth: /* Windows Vista */

'''dosbox.conf''' is a configuration file that DOSBox can use globally and/or locally per game (and settings that are left out are taken from the global file). It contains various system settings and initialization values that define your emulated environment. Everything can be controlled by editing this file or if you like through more graphically oriented [[DOSBoxFrontends|Front Ends]]. You can also [[Dosbox.conf#Creation and Location |create]] separate '''dosbox.conf''' files for multiple host environments (which is helpful in playing various DOS games that expect various types of hardware).

The configuration file is broken into separate [[Dosbox.conf#Sections |sections]] which contain section settings. Many of these settings do not need to be fully understood to configure DOSBox, but it is helpful to know where to look. You should also be aware that anything to the right of the '''#''' to the end of the line is considered a comment as is totally ignored by DOSBox when it loads.

== Creation and Location ==
Depending on the version or host OS, the dosbox.conf file is located either inside the [[user profile folder]] or inside the same folder as dosbox.exe.

===Windows===
Dosbox.conf is created automatically in the Windows' [[user profile folder]]. The location is indicated by the DOSBox Status Window upon startup.

You can find the '''dosbox.conf''' by browsing '''Start > All Programs > Dosbox-{version}'''
[[Image:Dosbox_config.png]]

==== Windows XP ====
%USERPROFILE%\Local Settings\Application Data\DOSBox\dosbox-{version}.conf
==== Windows Vista & Windows 7 ====
''{system drive}'':\Users\''{username}''\AppData\Local\DOSBox\dosbox-{version}.conf

===Linux===
For Linux the configfile is created on the first run in ~/.dosbox/
The name is dosbox-version.conf where version is currently 0.73

On Ubuntu in the dosbox man file it is written:
Configuration and language files use a format similar to Windows .ini
files. First ~/.dosboxrc (if present) will be loaded. If no config‐
file is specified at the commandline, a file named dosbox.conf (if
present in the current directory) will be loaded automatically after‐
wards. If a configfile is specified at the commandline that one will be
used instead.

===Mac OS X===
If you are using Mac OS X, a preferences file will be created for you on the first time you run DOSBox (as of version 0.73). This file contains the same system settings and initialization values as the '''dosbox.conf''' file on other systems.

It can be found (and modified) at '''<tt>~/Library/Preferences/DOSBox 0.73 Preferences</tt>''', where ~/ is your [[user profile folder]] (usually <tt>/Macintosh HD/Users/''username''/</tt>). The exact folder name in the [http://en.wikipedia.org/wiki/Finder_(software) Finder] may vary, depending on the language you use for OS X.

== Sections ==

=== [sdl] ===
{{:Configuration:SDL}}

=== [dosbox] ===
{{:Configuration:DOSBox}}

=== [render] ===
{{:Configuration:RENDER}}

=== [cpu] ===
{{:Configuration:CPU}}

=== [mixer] ===
{{:Configuration:Mixer}}(see [[Sound]])
:Here you can define the quality of emulated audio.

=== [midi] ===
{{:Configuration:MIDI}} (see [[Sound]])
:Here you can define any MIDI related settings. The term MIDI is commonly used to refer to background music found in games, but specifically it refers to synthesizer audio (which can be passed directly from emulated games to modern hardware.

=== [sblaster] ===
{{:Configuration:SBlaster}}(see [[Sound]])
:Sound Blaster related settings.

=== [gus] ===
{{:Configuration:GUS}} (see [[Sound]])
:Gravis Ultra Sound related settings.

=== [speaker] ===
{{:Configuration:PCSpeaker}} (see [[Sound]])
:PC Speaker related settings.

=== [joystick] ===
{{:Configuration:Joystick}} (see [[Sound]])
:Joystick related settings.

=== [serial] ===
{{:Configuration:SerialPort}}

=== [dos] ===
{{:Configuration:DOS}}

=== [ipx] ===
{{:Configuration:IPX}}

=== [autoexec] ===
{{:Configuration:AUTOEXEC}}

==Recommendations==

Different games will naturally work best with different configuration settings. Something to consider is to define a conf file for each game that will set the appropriate configurations and start the game for you. Then, create a shortcut such as DOSBox.exe -conf "DOSbox-GameName.conf" so that you can start your game in the least possible number of steps.

Configuration:RENDER

2009-12-24T09:52:37Z

Quoth: /* scaler */ Added 'hq', 'sai', 'supersai', and 'none' description and links

The rendering (drawing) section controls methods that DOSBox uses to improve the speed and quality of the graphics displayed on the screen. E.g. it can "forget" (skip) the every 3rd screen update (which will save time), or it can try to smooth out some of the coarse low-resolution graphics that was used on old displays, but which looks bad when shown on a modern, high-resolution screen.

==== frameskip = ''nnn'' ====
How many frames DOSBox skips before drawing one.

Default is '''0'''.

==== aspect = true | '''false''' ====
Do [[/render/aspect|aspect correction]]. It only affects non-square pixel modes (like for example Mode 13h, which has a resolution of 320x200 pixels and it's used by many DOS games), and it's needed to get correct aspect ratio on square-pixel screens in windowed mode.

However, it may look weird in some situations due to line doubling. Also, many people don't notice it when the aspect ratio is distorted and may even prefer it without correction. It depends on the game.

Default is '''false'''.

==== scaler = none | '''[[Scaler#normal2x|normal2x]]''' | [[Scaler#normal3x|normal3x]] | [[Scaler#tv2x|tv2x]] | [[Scaler#tv3x|tv3x]] | [[Scaler#rgb2x|rgb2x]] | [[Scaler#rgb3x|rgb3x]] | [[Scaler#scan2x|scan2x]] | [[Scaler#scan3x|scan3x]] | [[Scaler#advmame2x|advmame2x]] | [[Scaler#advmame3x|advmame3x]] | [[Scaler#advinterp2x|advinterp2x]] | [[Scaler#advinterp3x|advinterp3x]] | [[Scaler#2xsai|2xsai]] |[[Scaler#super2xsai|super2xsai]] | [[Scaler#hq2x|hq2x]] | [[Scaler#hq3x|hq3x]] ====

Scaler used to enlarge/enhance low resolution modes.
:none: no scaling is performed.
:normal: nearest-neighbour scaling (big square pixels).
:scan: like 'normal', but with horizontal black lines.
:tv: like 'scan', but with darkened versions of the data instead of black lines.
:rgb: simulates the phosphors on a dot trio CRT.
:advmame: smooths corners and removes jaggies from diagonal lines.
:advinterp: identical to 'advmame'.
:sai: similar to 'advmame' but with much softer color gradients.
:supersai: similar to 'sai' but sharper.
:hq: a 'high quality' scaler which delivers a cleaner and sharper image than 'advmame' or 'sai' scalers.

Default is '''[[Scaler#normal2x|normal2x]]'''.

Additional scalers which need adding: supereagle