Difference between revisions of "Configuration:SDL"

From DOSBoxWiki
Jump to navigationJump to search
 
(23 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
This section contains all of the low level system settings for how DOSBox interacts with your real hardware. You can define what resolutions are emulated, how DOSBox should treat errors or listen to your keyboard and mouse. You can often achieve a fair level of optimization by working with these setting, though for the most part leaving them at their default settings will create the best experience. These settings are passed on to the SDL Library which handles low level things like input and thread priority.
 
This section contains all of the low level system settings for how DOSBox interacts with your real hardware. You can define what resolutions are emulated, how DOSBox should treat errors or listen to your keyboard and mouse. You can often achieve a fair level of optimization by working with these setting, though for the most part leaving them at their default settings will create the best experience. These settings are passed on to the SDL Library which handles low level things like input and thread priority.
  
 +
<div id="fullscreen"></div>
 
;fullscreen = true | false
 
;fullscreen = true | false
 
:Start DOSBox directly in fullscreen.
 
:Start DOSBox directly in fullscreen.
 
:Default is false.
 
:Default is false.
:(since 0.??)
 
  
 +
<div id="fulldouble"></div>
 
;fulldouble = true | false
 
;fulldouble = true | false
:Use double buffering in fullscreen.
+
:Use double buffering in fullscreen. See [http://en.wikipedia.org/wiki/Multiple_buffering]
 
:Default is false.
 
:Default is false.
:(since 0.??)
 
  
;fullresolution = ''width'' x ''height'' | original
+
<div id="fullresolution"></div>
:The resolution to use for fullscreen. If original is specified, DOSBox will try to switch the screen resolution to best match the resolution request by the application. For example, if a game in DOSBox is requesting a graphics screen resolution of (320 x 240) while your desktop is (1280 x 1024), DOSBox will perform the switch or try other resolutions that closely matches it, e.g. (400 x 300) if (320 x 240) is not available.
+
;fullresolution = ''width'' x ''height'' | original | desktop
 +
:Scale the application to this size IF the output device supports hardware scaling (i.e. any output other than surface). Original is the game's default or chosen (through setup.exe or in-game menu) resolution. If original resolution is less than desktop resolution, DOSBox will switch the screen resolution to the closest match requested by the game or application. For example, if a game in DOSBox is requesting a graphics screen resolution of (320 x 240) while your desktop is (1920 x 1200), DosBox will switch to (320x240) or the next highest resolution supported by your GPU drivers, e.g. (800 x 600) if the former is not available. Many games will be below the minimum resolution supported by modern video cards, so DOSBox will scale the game up to at least that minimum. Note: the scaler setting under [render] is also able to scale up the original resolution to some degree. Those changes are performed before any additional scaling done with fullresolution setting.
 
:Default is original.
 
:Default is original.
:(since 0.62)
 
  
;windowresolution = ''width'' x ''height'' | original
+
<div id="windowresolution"></div>
:Scale the window to this size IF the output device supports hardware scaling (i.e. any output other than surface). Note that the window size actually has a fixed 1.6 aspect ratio, so if you ask for 1280x1024, you'll end up with a squished 1280x800 window. original means 1x zoom and will resize as the emulator switches graphics modes.
+
;windowresolution = ''width'' x ''height'' | original | desktop
 +
:Scale the window to this size IF the output device supports hardware scaling (i.e. any output other than surface). Original is the game's default or chosen (through setup.exe or in-game menu) resolution. Note: the scaler setting under [render] is also able to scale up the original resolution to some degree. Those changes are performed before any scaling done with windowresolution setting.
 
:Default is original.
 
:Default is original.
:(since 0.62)
+
<div id="output"></div>
  
 
;output = surface | overlay | opengl | openglnb | ddraw
 
;output = surface | overlay | opengl | openglnb | ddraw
:What to use for output.
+
:What to use for output. Surface does not support scaling or aspect correction. More information here: [http://www.vogons.org/viewtopic.php?=&p=102291]
 
:Default is surface.
 
:Default is surface.
:(since 0.??)
+
<div id="autolock"></div>
 
 
 
;autolock = true | false
 
;autolock = true | false
 
:Mouse will automatically lock, if you click on the screen.
 
:Mouse will automatically lock, if you click on the screen.
 
:Default is true.
 
:Default is true.
:(since 0.??)
+
<div id="sensitivity></div>
 
+
;sensitivity = 1..1000
;sensitivity = 1..100
 
 
:Mouse sensitivity.
 
:Mouse sensitivity.
 
:Default is 100.
 
:Default is 100.
:(since 0.??)
 
  
 +
<div id="waitonerror"></div>
 
;waitonerror = true | false
 
;waitonerror = true | false
 
:Wait before closing the console if DOSBox has an error.
 
:Wait before closing the console if DOSBox has an error.
 
:Default is true.
 
:Default is true.
:(since 0.??)
 
  
 +
<div id="priority"></div>
 
;priority = ''when-focused'',''when-minimzed''
 
;priority = ''when-focused'',''when-minimzed''
:Priority levels for DOSBox. Second entry behind the comma is for when DOSBox is not focused/minimized. Valid priorities are: lowerest, lower, normal, higher, highest, and pause.
+
:Priority levels for DOSBox. Second entry behind the comma is for when DOSBox is not focused/minimized. Valid priorities are: lowest, lower, normal, higher, highest, and pause.
 
:Default is higher,normal.
 
:Default is higher,normal.
:(since 0.??)
 
  
 +
<div id="mapperfile"></div>
 
;mapperfile = ''path-to-mapper-file''
 
;mapperfile = ''path-to-mapper-file''
 
:File used to load/save the key/event mappings from.
 
:File used to load/save the key/event mappings from.
:Default is mapper.txt.
+
:Default is mapper-<version>.txt.
:(since 0.??)
 
  
 +
<div id="usescancodes"></div>
 
;usescancodes = true | false
 
;usescancodes = true | false
 
:Avoid usage of symkeys, might not work on all operating systems.
 
:Avoid usage of symkeys, might not work on all operating systems.
 
:Default is true.
 
:Default is true.
:(since 0.??)
 
 
===Deprecated parameters===
 
;fullfixed = true | false
 
:Deprecated as of 0.65. See fullresolution.
 
:(since 0.??)
 
 
;fullwidth = ''width''
 
:Deprecated with 0.62. See fullresolution.
 
:(since 0.61)
 
 
;fullheight = ''height''
 
:Deprecated with 0.62. See fullresolution.
 
:(since 0.61)
 

Latest revision as of 00:22, 2 October 2018

This section contains all of the low level system settings for how DOSBox interacts with your real hardware. You can define what resolutions are emulated, how DOSBox should treat errors or listen to your keyboard and mouse. You can often achieve a fair level of optimization by working with these setting, though for the most part leaving them at their default settings will create the best experience. These settings are passed on to the SDL Library which handles low level things like input and thread priority.

fullscreen = true | false
Start DOSBox directly in fullscreen.
Default is false.
fulldouble = true | false
Use double buffering in fullscreen. See [1]
Default is false.
fullresolution = width x height | original | desktop
Scale the application to this size IF the output device supports hardware scaling (i.e. any output other than surface). Original is the game's default or chosen (through setup.exe or in-game menu) resolution. If original resolution is less than desktop resolution, DOSBox will switch the screen resolution to the closest match requested by the game or application. For example, if a game in DOSBox is requesting a graphics screen resolution of (320 x 240) while your desktop is (1920 x 1200), DosBox will switch to (320x240) or the next highest resolution supported by your GPU drivers, e.g. (800 x 600) if the former is not available. Many games will be below the minimum resolution supported by modern video cards, so DOSBox will scale the game up to at least that minimum. Note: the scaler setting under [render] is also able to scale up the original resolution to some degree. Those changes are performed before any additional scaling done with fullresolution setting.
Default is original.
windowresolution = width x height | original | desktop
Scale the window to this size IF the output device supports hardware scaling (i.e. any output other than surface). Original is the game's default or chosen (through setup.exe or in-game menu) resolution. Note: the scaler setting under [render] is also able to scale up the original resolution to some degree. Those changes are performed before any scaling done with windowresolution setting.
Default is original.
output = surface | overlay | opengl | openglnb | ddraw
What to use for output. Surface does not support scaling or aspect correction. More information here: [2]
Default is surface.
autolock = true | false
Mouse will automatically lock, if you click on the screen.
Default is true.
sensitivity = 1..1000
Mouse sensitivity.
Default is 100.
waitonerror = true | false
Wait before closing the console if DOSBox has an error.
Default is true.
priority = when-focused,when-minimzed
Priority levels for DOSBox. Second entry behind the comma is for when DOSBox is not focused/minimized. Valid priorities are: lowest, lower, normal, higher, highest, and pause.
Default is higher,normal.
mapperfile = path-to-mapper-file
File used to load/save the key/event mappings from.
Default is mapper-<version>.txt.
usescancodes = true | false
Avoid usage of symkeys, might not work on all operating systems.
Default is true.