Advertisement
Guest User

Star Trek: Generations Dosbox-X Config

a guest
May 28th, 2018
1,394
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
text 114.97 KB | None | 0 0
  1. # This is the configuration file for DOSBox 0.82.7. (Please use the latest version of DOSBox)
  2. # Lines starting with a # are comment lines and are ignored by DOSBox.
  3. # They are used to (briefly) document the effect of each option.
  4. # To write out ALL options, use command 'config -all' with -wc or -writeconf options.
  5.  
  6. [log]
  7. # logfile: file where the log messages will be saved to
  8. # vga: Enable/Disable logging of this type.
  9. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  10. # vgagfx: Enable/Disable logging of this type.
  11. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  12. # vgamisc: Enable/Disable logging of this type.
  13. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  14. # int10: Enable/Disable logging of this type.
  15. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  16. # sblaster: Enable/Disable logging of this type.
  17. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  18. # dma_control: Enable/Disable logging of this type.
  19. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  20. # fpu: Enable/Disable logging of this type.
  21. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  22. # cpu: Enable/Disable logging of this type.
  23. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  24. # paging: Enable/Disable logging of this type.
  25. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  26. # fcb: Enable/Disable logging of this type.
  27. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  28. # files: Enable/Disable logging of this type.
  29. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  30. # ioctl: Enable/Disable logging of this type.
  31. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  32. # exec: Enable/Disable logging of this type.
  33. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  34. # dosmisc: Enable/Disable logging of this type.
  35. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  36. # pit: Enable/Disable logging of this type.
  37. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  38. # keyboard: Enable/Disable logging of this type.
  39. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  40. # pic: Enable/Disable logging of this type.
  41. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  42. # mouse: Enable/Disable logging of this type.
  43. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  44. # bios: Enable/Disable logging of this type.
  45. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  46. # gui: Enable/Disable logging of this type.
  47. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  48. # misc: Enable/Disable logging of this type.
  49. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  50. # io: Enable/Disable logging of this type.
  51. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  52. # pci: Enable/Disable logging of this type.
  53. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  54. # sst: Enable/Disable logging of this type.
  55. # Possible values: true, false, debug, normal, warn, error, fatal, never.
  56. logfile=
  57. vga=false
  58. vgagfx=false
  59. vgamisc=false
  60. int10=false
  61. sblaster=false
  62. dma_control=false
  63. fpu=false
  64. cpu=false
  65. paging=false
  66. fcb=false
  67. files=false
  68. ioctl=false
  69. exec=false
  70. dosmisc=false
  71. pit=false
  72. keyboard=false
  73. pic=false
  74. mouse=false
  75. bios=false
  76. gui=false
  77. misc=false
  78. io=false
  79. pci=false
  80. sst=false
  81.  
  82. [sdl]
  83. # fullscreen: Start dosbox directly in fullscreen. (Press ALT-Enter to go back)
  84. # fulldouble: Use double buffering in fullscreen. It can reduce screen flickering, but it can also result in a slow DOSBox.
  85. # fullresolution: What resolution to use for fullscreen: original, desktop or a fixed size (e.g. 1024x768).
  86. # Using your monitor's native resolution with aspect=true might give the best results.
  87. # If you end up with small window on a large screen, try an output different from surface.
  88. # windowresolution: Scale the window to this size IF the output device supports hardware scaling.
  89. # (output=surface does not!)
  90. # output: What video system to use for output.
  91. # Possible values: surface, overlay, opengl, openglnb, openglhq, ddraw.
  92. # autolock: Mouse will automatically lock, if you click on the screen. (Press CTRL-F10 to unlock)
  93. # sensitivity: Mouse sensitivity.
  94. # waitonerror: Wait before closing the console if dosbox has an error.
  95. # priority: Priority levels for dosbox. Second entry behind the comma is for when dosbox is not focused/minimized.
  96. # pause is only valid for the second entry.
  97. # Possible values: lowest, lower, normal, higher, highest, pause.
  98. # mapperfile: File used to load/save the key/event mappings from. Resetmapper only works with the default value.
  99. # usescancodes: Avoid usage of symkeys, might not work on all operating systems.
  100. # overscan: Width of overscan border (0 to 10). (works only if output=surface)
  101. # titlebar: Change the string displayed in the DOSBox title bar.
  102. # showmenu: Whether to show the menu bar (if supported). Default true.
  103. fullscreen=false
  104. fulldouble=false
  105. fullresolution=desktop
  106. windowresolution=original
  107. output=surface
  108. autolock=true
  109. sensitivity=100
  110. waitonerror=true
  111. priority=higher,normal
  112. mapperfile=mapper-0.82.5.map
  113. usescancodes=false
  114. overscan=0
  115. titlebar=
  116. showmenu=true
  117.  
  118. [dosbox]
  119. # language: Select another language file.
  120. # title: Additional text to place in the title bar of the window
  121. # dpi aware: Set this option (on by default) to indicate to your OS that DOSBox is DPI aware.
  122. # If it is not set, Windows Vista/7/8/10 and higher may upscale the DOSBox window
  123. # on higher resolution monitors which is probably not what you want.
  124. # keyboard hook: Use keyboard hook (currently only on Windows) to catch special keys and synchronize the keyboard LEDs with the host
  125. # weitek: If set, emulate the Weitek coprocessor. This option only has effect if cputype=386 or cputype=486.
  126. # bochs debug port e9: If set, emulate Bochs debug port E9h. ASCII text written to this I/O port is assumed to be debug output, and logged.
  127. # machine: The type of machine DOSBox tries to emulate.
  128. # Possible values: hercules, cga, cga_mono, cga_rgb, cga_composite, cga_composite2, tandy, pcjr, ega, vgaonly, svga_s3, svga_et3000, svga_et4000, svga_paradise, vesa_nolfb, vesa_oldvbe, amstrad, pc98, pc9801, pc9821.
  129. # vmemdelay: VGA Memory I/O delay in nanoseconds. Set to -1 to use default, 0 to disable.
  130. # Default off. Enable this option (-1 or nonzero) if you are running a game or
  131. # demo that needs slower VGA memory (like that of older ISA hardware) to work properly.
  132. # If your game is not sensitive to VGA RAM I/O speed, then turning on this option
  133. # will do nothing but cause a significant drop in frame rate which is probably not
  134. # what you want. Recommended values -1, 0 to 2000.
  135. # vmemsize: Amount of video memory in megabytes.
  136. # The maximum resolution and color depth the svga_s3 will be able to display
  137. # is determined by this value.
  138. # 0: 512k (800x600 at 256 colors)
  139. # 1: 1024x768 at 256 colors or 800x600 at 64k colors
  140. # 2: 1600x1200 at 256 colors or 1024x768 at 64k colors or 640x480 at 16M colors
  141. # 4: 1600x1200 at 64k colors or 1024x768 at 16M colors
  142. # 8: up to 1600x1200 at 16M colors
  143. # For build engine games, use more memory than in the list above so it can
  144. # use triple buffering and thus won't flicker.
  145. #
  146. # vmemsizekb: Amount of video memory in kilobytes, in addition to vmemsize
  147. # captures: Directory where things like wave, midi, screenshot get captured.
  148. # capture chroma format: Chroma format to use when capturing to H.264. 'auto' picks the best quality option.
  149. # 4:4:4 Chroma is at full resolution. This provides the best quality, however not widely supported by editing software.
  150. # 4:2:2 Chroma is at half horizontal resolution.
  151. # 4:2:0 Chroma is at quarter resolution, which may cause minor color smearing.
  152. # However, this chroma format is most likely to be compatible with video editing software.
  153. # Possible values: auto, 4:4:4, 4:2:2, 4:2:0.
  154. # capture format: Capture format to use when capturing video. The availability of the format depends on how DOSBox-X was compiled.
  155. # default Use compiled-in default (avi-zmbv)
  156. # avi-zmbv Use DOSBox-style AVI + ZMBV codec with PCM audio
  157. # mpegts-h264 Use MPEG transport stream + H.264 + AAC audio. Resolution & refresh rate changes can be contained
  158. # within one file with this choice, however not all software can support mid-stream format changes.
  159. # Possible values: default, avi-zmbv, mpegts-h264.
  160. # mainline compatible mapping: If set, arrange private areas, UMBs, and DOS kernel structures by default in the same way the mainline branch would do it.
  161. # If cleared, these areas are allocated dynamically which may improve available memory and emulation accuracy.
  162. # If your DOS game breaks under DOSBox-X but works with mainline DOSBox setting this option may help.
  163. # mainline compatible bios mapping: If set, arrange the BIOS area in the same way that the mainline branch would do it.
  164. # If cleared, these areas are allocated dynamically which may improve available memory and emulation accuracy.
  165. # If your DOS game breaks under DOSBox-X but works with mainline DOSBox setting this option may help.
  166. # adapter rom is ram: Map adapter ROM as RAM (mainline DOSBox 0.74 behavior). When clear, unused adapter ROM is mapped out
  167. # shell environment size: Size of the initial DOSBox shell environment block, in bytes. This does not affect the environment block of sub-processes spawned from the shell.
  168. # This option has no effect unless dynamic kernel allocation is enabled.
  169. # private area size: Set DOSBox-X private memory area size. This area contains private memory structures used by the DOS kernel.
  170. # It is discarded when you boot into another OS. Mainline DOSBox uses 32KB. Testing shows that it is possible
  171. # to run DOSBox with as little as 4KB. If DOSBox-X aborts with error "not enough memory for internal tables"
  172. # then you need to increase this value.
  173. # a20: A20 gate emulation mode.
  174. # The on/off/on_fake/off_fake options are intended for testing and debugging DOS development,
  175. # or to emulate obscure hardware, or to work around potential extended memory problems with DOS programs.
  176. # on_fake/off_fake are intended to test whether a program carries out a memory test to ensure the A20
  177. # gate is set as intended (as HIMEM.SYS does). If it goes by the gate bit alone, it WILL crash.
  178. # This parameter is also changeable from the builtin A20GATE command.
  179. # fast Emulate A20 gating by remapping the first 64KB @ 1MB boundary (fast, mainline DOSBox behavior)
  180. # mask Emulate A20 gating by masking memory I/O address (accurate)
  181. # off Lock A20 gate off (Software/OS cannot enable A20)
  182. # on Lock A20 gate on (Software/OS cannot disable A20)
  183. # off_fake Lock A20 gate off but allow bit to toggle (hope your DOS game tests the HMA!)
  184. # on_fake Lock A20 gate on but allow bit to toggle
  185. # turn off a20 gate on boot: If enabled, A20 gate is switched off when booting a guest OS.
  186. # Enabled by default. Recommended for MS-DOS when HIMEM.SYS is not installed in the guest OS.
  187. # If disabled, and MS-DOS does not load HIMEM.SYS, programs and features that rely on the 1MB wraparound will fail.
  188. # isa bus clock: ISA BCLK frequency.
  189. # WARNING: In future revisions, PCI/motherboard chipset emulation will allow the guest OS/program to alter this value at runtime.
  190. # std8.3 8.333MHz (typical 386-class or higher)
  191. # std8 8MHz
  192. # std6 6MHz
  193. # std4.77 4.77MHz (precisely 1/3 x 14.31818MHz). Bus frequency of older PC/XT systems.
  194. # oc10 10MHz
  195. # oc12 12MHz
  196. # oc15 15MHz
  197. # oc16 16MHz
  198. # <integer or float> Any integer or floating point value will be used as the clock frequency in Hz
  199. # <integer/integer ratio> If a ratio is given (num/den), the ratio will be used as the clock frequency
  200. # pci bus clock: PCI bus frequency.
  201. # WARNING: In future revisions, PCI/motherboard chipset emulation will allow the guest OS/program to alter this value at runtime.
  202. # std33.3 33.333MHz (very common setting on motherboards)
  203. # std30 30MHz (some older mid-1990's Pentium systems)
  204. # std25 25MHz
  205. # <integer or float> Any integer or floating point value will be used as the clock frequency in Hz
  206. # <integer/integer ratio> If a ratio is given (num/den), the ratio will be used as the clock frequency
  207. # call binary on reset: If set, this is the path of a binary blob to load into the ROM BIOS area and execute immediately after CPU reset.
  208. # It will be executed before the BIOS POST routine, only ONCE. The binary blob is expected either to IRET or to
  209. # jump directly to F000:FFF0 to return control to the BIOS.
  210. # This can be used for x86 assembly language experiments and automated testing against the CPU emulation.
  211. # call binary on boot: If set, this is the path of a binary blob to load into the ROM BIOS area and execute immediately before booting the DOS system.
  212. # This can be used for x86 assembly language experiments and automated testing against the CPU emulation.
  213. # rom bios allocation max: Maximum size (top down from 1MB) allowed for ROM BIOS dynamic allocation in KB
  214. # rom bios minimum size: Once ROM BIOS layout is finalized, trim total region down to a minimum amount in KB
  215. # irq delay ns: IRQ delay in nanoseconds. Set to -1 to use default, 0 to disable.
  216. # This is a more precise version of the irqdelay= setting.
  217. # There are some old DOS games and demos that have race conditions with IRQs that need a nonzero value here to work properly.
  218. # iodelay: I/O delay in nanoseconds for I/O port access. Set to -1 to use default, 0 to disable.
  219. # A value of 1000 (1us) is recommended for ISA bus type delays. If your game
  220. # or demo is not sensitive to I/O port and ISA bus timing, you can turn this option off
  221. # (set to 0) to increase game performance.
  222. # iodelay16: I/O delay for 16-bit transfers. -1 to use default, 0 to disable.
  223. # iodelay32: I/O delay for 32-bit transfers. -1 to use default, 0 to disable.
  224. # acpi: ACPI emulation, and what version of the specification to follow.
  225. # WARNING: This option is very experimental at this time and should not be enabled unless you're willing to accept the consequences.
  226. # Intended for use with ACPI-aware OSes including Linux and Windows 98/ME. This option will also slightly reduce available
  227. # system memory to make room for the ACPI tables, just as real BIOSes do, and reserve an IRQ for ACPI functions.
  228. # Possible values: off, 1.0, 1.0b, 2.0, 2.0a, 2.0b, 2.0c, 3.0, 3.0a, 3.0b, 4.0, 4.0a, 5.0, 5.0a, 6.0.
  229. # acpi rsd ptr location: Where to store the Root System Description Pointer structure. You can have it stored in the ROM BIOS area, or the Extended Bios Data Area.
  230. # Possible values: auto, bios, ebda.
  231. # acpi sci irq: IRQ to assign as ACPI system control interrupt. set to -1 to automatically assign.
  232. # acpi iobase: I/O port base for the ACPI device Power Management registers. Set to 0 for automatic assignment.
  233. # acpi reserved size: Amount of memory at top to reserve for ACPI structures and tables. Set to 0 for automatic assignment.
  234. # memsize: Amount of memory DOSBox has in megabytes.
  235. # This value is best left at its default to avoid problems with some games,
  236. # though few games might require a higher value.
  237. # There is generally no speed advantage when raising this value.
  238. # Programs that use 286 protected mode like Windows 3.0 in Standard Mode may crash with more than 15MB.
  239. # memsizekb: Amount of memory DOSBox has in kilobytes.
  240. # This value should normally be set to 0.
  241. # If nonzero, it is added to the memsize parameter.
  242. # Finer grained control of total memory may be useful in
  243. # emulating ancient DOS machines with less than 640KB of
  244. # RAM or early 386 systems with odd extended memory sizes.
  245. # dos mem limit: Limit DOS conventional memory to this amount. Does not affect extended memory.
  246. # Setting this option to a value in the range 636-639 can be used to simulate modern BIOSes
  247. # that maintain an EBDA (Extended BIOS Data Area) at the top of conventional memory.
  248. # You may also play with this option for diagnostic purposes or to stress test DOS programs in limited memory setups.
  249. #
  250. # A few DOS games & demos require this option to be set:
  251. # Majic 12 "Show": If UMBs are enabled, set this option to 639 to avoid MCB chain corruption error.
  252. # isa memory hole at 512kb: If set, emulate an ISA memory hole at the 512KB to 640KB area (0x80000-0x9FFFF).
  253. # memalias: Memory aliasing emulation, in number of valid address bits.
  254. # . Many 386/486 class motherboards and processors prior to 1995
  255. # suffered from memory aliasing for various technical reasons. If the software you are
  256. # trying to run assumes aliasing, or otherwise plays cheap tricks with paging,
  257. # enabling this option can help. Note that enabling this option can cause slight performance degredation. Set to 0 to disable.
  258. # Recommended values when enabled:
  259. # 24: 16MB aliasing. Common on 386SX systems (CPU had 24 external address bits)
  260. # or 386DX and 486 systems where the CPU communicated directly with the ISA bus (A24-A31 tied off)
  261. # 26: 64MB aliasing. Some 486s had only 26 external address bits, some motherboards tied off A26-A31
  262. # pc-98 fm board: In PC-98 mode, selects the FM music board to emulate.
  263. # Possible values: auto, off, false, board26k, board86, board86c.
  264. # pc-98 fm board irq: If set, helps to determine the IRQ of the FM board. A setting of zero means to auto-determine the IRQ.
  265. # pc-98 fm board io port: If set, helps to determine the base I/O port of the FM board. A setting of zero means to auto-determine the port number.
  266. # pc-98 buffer page flip: If set, the game's request to page flip will be delayed to vertical retrace, which can eliminate tearline artifacts.
  267. # Note that this is NOT the behavior of actual hardware. This option is provided for the user's preference.
  268. # pc-98 enable 16-color: Allow 16-color graphics mode if set, disable if not set
  269. # pc-98 enable grcg: Allow GRCG graphics functions if set, disable if not set
  270. # pc-98 enable egc: Allow EGC graphics functions if set, disable if not set
  271. # pc-98 start gdc at 5mhz: Start GDC at 5MHz if set, 2.5MHz if clear. May be required for some games.
  272. # pc-98 allow scanline effect: If set, PC-98 emulation will allow the DOS application to enable the 'scanline effect'
  273. # in 200-line graphics modes upconverted to 400-line raster display. When enabled, odd
  274. # numbered scanlines are blanked instead of doubled
  275. # pc-98 video mode: Specify the preferred PC-98 video mode.
  276. # Valid values are 15, 24, or 31 for each specific horizontal refresh rate on the platform.
  277. # 24khz is default and best supported at this time.
  278. # 15khz is not implemented at this time.
  279. # 31khz is experimental at this time.
  280. # Possible values: , 24khz, 31khz, 15khz.
  281. # pc-98 timer master frequency: 8254 timer clock frequency (NEC PC-98). Depending on the CPU frequency the clock frequency is one of two common values.
  282. # If your setting is neither of the below the closest appropriate value will be chosen.
  283. # This setting affects the master clock rate that DOS applications must divide down from to program the timer
  284. # at the correct rate, which affects timer interrupt, PC speaker, and the COM1 RS-232C serial port baud rate.
  285. # 8MHz is treated as an alias for 4MHz and 10MHz is treated as an alias for 5MHz.
  286. # 0: Use default (auto)
  287. # 4: 1.996MHz (as if 4MHz or multiple thereof CPU clock)
  288. # 5: 2.457MHz (as if 5MHz or multiple thereof CPU clock)
  289. # pc-98 allow 4 display partition graphics: According to NEC graphics controller documentation, graphics mode is supposed to support only
  290. # 2 display partitions. Some games rely on hardware flaws that allowed 4 partitions.
  291. # -1: Default (choose automatically)
  292. # 0: Disable
  293. # 1: Enable
  294. # pc-98 force ibm keyboard layout: Force to use a default keyboard layout like IBM US-English for PC-98 emulation.
  295. # Will only work with apps and games using BIOS for keyboard.
  296. # vga bios size override: VGA BIOS size override. Override the size of the VGA BIOS (normally 32KB in compatible or 12KB in non-compatible).
  297. # video bios dont duplicate cga first half rom font: If set, save 4KB of EGA/VGA ROM space by pointing to the copy in the ROM BIOS of the first 128 chars
  298. # video bios always offer 14-pixel high rom font: If set, video BIOS will always carry the 14-pixel ROM font. If clear, 14-pixel rom font will not be offered except for EGA/VGA emulation.
  299. # video bios always offer 16-pixel high rom font: If set, video BIOS will always carry the 16-pixel ROM font. If clear, 16-pixel rom font will not be offered except for VGA emulation.
  300. # video bios enable cga second half rom font: If set, and emulating CGA/PCjr/Tandy, automatically provide the second half of the 8x8 ROM font.
  301. # This setting is ignored for EGA/VGA emulation. If not set, you will need a utility like GRAFTABL.COM to load the second half of the ROM font for graphics.
  302. # NOTE: if you disable the 14 & 16 pixel high font AND the second half when machine=cga, you will disable video bios completely.
  303. # forcerate: Force the VGA framerate to a specific value(ntsc, pal, or specific hz), no matter what
  304. # sierra ramdac: Whether or not to emulate a Sierra or compatible RAMDAC at port 3C6h-3C9h.
  305. # Some DOS games expect to access port 3C6h to enable highcolor/truecolor SVGA modes on older chipsets.
  306. # Disable if you wish to emulate SVGA hardware that lacks a RAMDAC or (depending on the chipset) does
  307. # not emulate a RAMDAC that is accessible through port 3C6h. This option has no effect for non-VGA video hardware.
  308. # sierra ramdac lock 565: When emulating High Sierra highcolor RAMDAC, assume 5:6:5 at all times if set. Else,
  309. # bit 6 of the DAC command selects between 5:5:5 and 5:6:5. Set this option for demos or
  310. # games that got the command byte wrong (MFX Transgrassion 2) or any other demo that is
  311. # not rendering highcolor 16bpp correctly.
  312. # page flip debug line: VGA debugging switch. If set, an inverse line will be drawn on the exact scanline that the CRTC display offset registers were written.
  313. # This can be used to help diagnose whether or not the DOS game is page flipping properly according to vertical retrace if the display on-screen is flickering.
  314. # vertical retrace poll debug line: VGA debugging switch. If set, an inverse green dotted line will be drawn on the exact scanline that the CRTC status port (0x3DA) was read.
  315. # This can be used to help diagnose whether the DOS game is propertly waiting for vertical retrace.
  316. # cgasnow: When machine=cga, determines whether or not to emulate CGA snow in 80x25 text mode
  317. # vga 3da undefined bits: VGA status port 3BA/3DAh only defines bits 0 and 3. This setting allows you to assign a bit pattern to the undefined bits.
  318. # The purpose of this hack is to deal with demos that read and handle port 3DAh in ways that might crash if all are zero.
  319. # By default, this value is zero.
  320. # unmask timer on int 10 setmode: If set, INT 10h will unmask IRQ 0 (timer) when setting video modes.
  321. # unmask keyboard on int 16 read: If set, INT 16h will unmask IRQ 1 (keyboard) when asked to read keyboard input.
  322. # int16 keyboard polling undocumented cf behavior: If set, INT 16h function AH=01h will also set/clear the carry flag depending on whether input was available.
  323. # There are some old DOS games and demos that rely on this behavior to sense keyboard input, and this behavior
  324. # has been verified to occur on some old (early 90s) BIOSes.
  325. # allow port 92 reset: If set (default), allow the application to reset the CPU through port 92h
  326. # enable port 92: Emulate port 92h (PS/2 system control port A). If you want to emulate a system that predates the PS/2, set to 0.
  327. # enable 1st dma controller: Emulate 1st (AT) DMA controller (default). Set to 0 if you wish to emulate a system that lacks DMA (PCjr and some Tandy systems)
  328. # enable 2nd dma controller: Emulate 2nd (AT) DMA controller (default). Set to 0 if you wish to emulate a PC/XT system without 16-bit DMA.
  329. # Note: mainline DOSBox automatically disables 16-bit DMA when machine=cga or machine=hercules, while DOSBox-X does not.
  330. # allow dma address decrement: If set, allow increment & decrement modes as specified in the 8237 datasheet.
  331. # If clear, always increment the address (as if to emulate clone 8237 implementations that skipped the inc/dec bit).
  332. # enable 128k capable 16-bit dma: If true, DMA controller emulation models ISA hardware that permits 16-bit DMA to span 128KB.
  333. # If false, DMA controller emulation models PCI hardware that limits 16-bit DMA to 64KB boundaries.
  334. # If auto, the choice is made according to other factors in hardware emulation
  335. # Possible values: true, false, 1, 0, auto.
  336. # enable dma extra page registers: If set, emulate the extra page registers (I/O ports 0x80, 0x84-0x86, 0x88, 0x8C-0x8E), like actual hardware.
  337. # Note that mainline DOSBox behavior is to NOT emulate these registers.
  338. # dma page registers write-only: Normally (on AT hardware) the DMA page registers are read/write. Set this option if you want to emulate PC/XT hardware where the page registers are write-only.
  339. # enable slave pic: Enable slave PIC (IRQ 8-15). Set this to 0 if you want to emulate a PC/XT type arrangement with IRQ 0-7 and no IRQ 2 cascade.
  340. # enable pc nmi mask: Enable PC/XT style NMI mask register (0xA0). Note that this option conflicts with the secondary PIC and will be ignored if the slave PIC is enabled.
  341. # rom bios 8x8 CGA font: If set, or mainline compatible bios mapping, a legacy 8x8 CGA font (first 128 characters) is stored at 0xF000:0xFA6E. DOS programs that do not use INT 10h to locate fonts might require that font to be located there.
  342. # rom bios video parameter table: If set, or mainline compatible bios mapping, DOSBox will emulate the video parameter table and assign that to INT 1Dh. If clear, table will not be provided.
  343. # allow more than 640kb base memory: If set, and space is available, allow conventional memory to extend past 640KB.
  344. # For example, if machine=cga, conventional memory can extend out to 0xB800 and provide up to 736KB of RAM.
  345. # This allows you to emulate PC/XT style memory extensions.
  346. # vesa lfb base scanline adjust: If non-zero, the VESA BIOS will report the linear framebuffer offset by this many scanlines.
  347. # This does not affect the linear framebuffer's location. It only affects the linear framebuffer
  348. # location reported by the VESA BIOS. Set to nonzero for DOS games with sloppy VESA graphics pointer management.
  349. # MFX "Melvindale" (1996): Set this option to 2 to center the picture properly.
  350. # allow hpel effects: If set, allow the DOS demo or program to change the horizontal pel (panning) register per scanline.
  351. # Some early DOS demos use this to create waving or sinus effects on the picture. Not very many VGA
  352. # chipsets allow this, so far, only ATI chipsets are known to support this effect. Disabled by default.
  353. # allow hretrace effects: If set, allow the DOS demo or program to make the picture wavy by playing with the 'start horizontalretrace' register of the CRTC during the active picture. Some early DOS demos (Copper by Surprise!productions) need this option set for some demo effects to work. Disabled by default.
  354. # hretrace effect weight: If emulating hretrace effects, this parameter adds 'weight' to the offset to smooth it out.
  355. # the larger the number, the more averaging is applied. This is intended to emulate the inertia
  356. # of the electron beam in a CRT monitor
  357. # vesa modelist cap: IF nonzero, the VESA modelist is capped so that it contains no more than the specified number of video modes.
  358. # Set this option to a value between 8 to 32 if the DOS application has problems with long modelists or a fixed
  359. # buffer for querying modes. Such programs may crash if given the entire modelist supported by DOSBox-X.
  360. # Warcraft II by Blizzard ................ Set to a value between 8 and 16. This game has a fixed buffer that it
  361. # reads the modelist into. DOSBox-X's normal modelist is too long and
  362. # the game will overrun the buffer and crash without this setting.
  363. # vesa modelist width limit: IF nonzero, VESA modes with horizontal resolution higher than the specified pixel count will not be listed.
  364. # This is another way the modelist can be capped for DOS applications that have trouble with long modelists.
  365. # vesa modelist height limit: IF nonzero, VESA modes with vertical resolution higher than the specified pixel count will not be listed.
  366. # This is another way the modelist can be capped for DOS applications that have trouble with long modelists.
  367. # vesa vbe 1.2 modes are 32bpp: If set, truecolor (16M color) VESA BIOS modes in the 0x100-0x11F range are 32bpp. If clear, they are 24bpp.
  368. # Some DOS games and demos assume one bit depth or the other and do not enumerate VESA BIOS modes, which is why this
  369. # option exists.
  370. # allow low resolution vesa modes: If set, allow low resolution VESA modes (320x200x16/24/32bpp and so on). You could set this to false to simulate
  371. # SVGA hardware with a BIOS that does not support the lowres modes for testing purposes.
  372. # allow 32bpp vesa modes: If the DOS game or demo has problems with 32bpp VESA modes, set to 'false'
  373. # allow 24bpp vesa modes: If the DOS game or demo has problems with 24bpp VESA modes, set to 'false'
  374. # allow 16bpp vesa modes: If the DOS game or demo has problems with 16bpp VESA modes, set to 'false'
  375. # allow 15bpp vesa modes: If the DOS game or demo has problems with 15bpp VESA modes, set to 'false'
  376. # allow 8bpp vesa modes: If the DOS game or demo has problems with 8bpp VESA modes, set to 'false'
  377. # allow 4bpp vesa modes: If the DOS game or demo has problems with 4bpp VESA modes, set to 'false'
  378. # allow tty vesa modes: If the DOS game or demo has problems with text VESA modes, set to 'false'
  379. # double-buffered line compare: This setting affects the VGA Line Compare register. Set to false (default value) to emulate most VGA behavior
  380. # Set to true for the value to latch once at the start of the frame.
  381. # ignore vblank wraparound: DOSBox-X can handle active display properly if games or demos reprogram vertical blanking to end in the active picture area.
  382. # If the wraparound handling prevents the game from displaying properly, set this to false. Out of bounds vblank values will be ignored.
  383. #
  384. # enable vga resize delay: If the DOS game you are running relies on certain VGA raster tricks that affect active display area, enable this option.
  385. # This adds a delay between VGA mode changes and window updates. It also means that if you are capturing a demo or game,
  386. # that your capture will also show a few garbled frames at any point mode changes occur, which is why this option is disabled
  387. # by default. If you intend to run certain DOS games and demos like DoWhackaDo, enable this option.
  388. # resize only on vga active display width increase: If set, changes to the Display End register of the CRTC do not trigger DOSBox to resize it's window
  389. # IF the value written is less than the current value. Some demos like DoWhackaDo need this option set
  390. # because of the way it's raster effects work. If the DOSBox window rapidly changes size during a demo
  391. # try setting this option. Else, leave it turned off. Changes to other VGA CRTC registers will trigger
  392. # a DOSBox mode change as normal regardless of this setting.
  393. # enable pci bus: Enable PCI bus emulation
  394. language=
  395. title=
  396. dpi aware=true
  397. keyboard hook=false
  398. weitek=false
  399. bochs debug port e9=false
  400. machine=svga_s3
  401. vmemdelay=0
  402. vmemsize=2
  403. vmemsizekb=0
  404. captures=capture
  405. capture chroma format=auto
  406. capture format=default
  407. mainline compatible mapping=false
  408. mainline compatible bios mapping=false
  409. adapter rom is ram=false
  410. shell environment size=0
  411. private area size=32768
  412. a20=fast
  413. turn off a20 gate on boot=true
  414. isa bus clock=std8.3
  415. pci bus clock=std33.3
  416. call binary on reset=
  417. call binary on boot=
  418. rom bios allocation max=0
  419. rom bios minimum size=0
  420. irq delay ns=-1
  421. iodelay=-1
  422. iodelay16=-1
  423. iodelay32=-1
  424. acpi=off
  425. acpi rsd ptr location=auto
  426. acpi sci irq=-1
  427. acpi iobase=0
  428. acpi reserved size=0
  429. memsize=16
  430. memsizekb=0
  431. dos mem limit=0
  432. isa memory hole at 512kb=false
  433. memalias=0
  434. pc-98 fm board=auto
  435. pc-98 fm board irq=0
  436. pc-98 fm board io port=0
  437. pc-98 buffer page flip=false
  438. pc-98 enable 16-color=true
  439. pc-98 enable grcg=true
  440. pc-98 enable egc=true
  441. pc-98 start gdc at 5mhz=false
  442. pc-98 allow scanline effect=true
  443. pc-98 video mode=
  444. pc-98 timer master frequency=0
  445. pc-98 allow 4 display partition graphics=-1
  446. pc-98 force ibm keyboard layout=false
  447. vga bios size override=0
  448. video bios dont duplicate cga first half rom font=false
  449. video bios always offer 14-pixel high rom font=false
  450. video bios always offer 16-pixel high rom font=false
  451. video bios enable cga second half rom font=true
  452. forcerate=60
  453. sierra ramdac=true
  454. sierra ramdac lock 565=false
  455. page flip debug line=false
  456. vertical retrace poll debug line=false
  457. cgasnow=true
  458. vga 3da undefined bits=0
  459. unmask timer on int 10 setmode=false
  460. unmask keyboard on int 16 read=false
  461. int16 keyboard polling undocumented cf behavior=false
  462. allow port 92 reset=true
  463. enable port 92=true
  464. enable 1st dma controller=true
  465. enable 2nd dma controller=true
  466. allow dma address decrement=true
  467. enable 128k capable 16-bit dma=auto
  468. enable dma extra page registers=true
  469. dma page registers write-only=false
  470. enable slave pic=true
  471. enable pc nmi mask=true
  472. rom bios 8x8 CGA font=true
  473. rom bios video parameter table=true
  474. allow more than 640kb base memory=false
  475. vesa lfb base scanline adjust=0
  476. allow hpel effects=false
  477. allow hretrace effects=false
  478. hretrace effect weight=4.00
  479. vesa modelist cap=0
  480. vesa modelist width limit=0
  481. vesa modelist height limit=0
  482. vesa vbe 1.2 modes are 32bpp=true
  483. allow low resolution vesa modes=true
  484. allow 32bpp vesa modes=true
  485. allow 24bpp vesa modes=true
  486. allow 16bpp vesa modes=true
  487. allow 15bpp vesa modes=true
  488. allow 8bpp vesa modes=true
  489. allow 4bpp vesa modes=true
  490. allow tty vesa modes=true
  491. double-buffered line compare=false
  492. ignore vblank wraparound=true
  493. enable vga resize delay=false
  494. resize only on vga active display width increase=false
  495. enable pci bus=true
  496.  
  497. [render]
  498. # frameskip: How many frames DOSBox skips before drawing one.
  499. # aspect: Do aspect correction, if your output method doesn't support scaling this can slow things down!.
  500. # char9: Allow 9-pixel wide text mode fonts.
  501. # doublescan: If set, doublescanned output emits two scanlines for each source line, in the
  502. # same manner as the actual VGA output (320x200 is rendered as 640x400 for example).
  503. # If clear, doublescanned output is rendered at the native source resolution (320x200 as 320x200).
  504. # This affects the raster PRIOR to the software or hardware scalers. Choose wisely.
  505. #
  506. # scaler: Scaler used to enlarge/enhance low resolution modes. If 'forced' is appended,
  507. # then the scaler will be used even if the result might not be desired.
  508. # Possible values: none, normal2x, normal3x, normal4x, normal5x, advmame2x, advmame3x, advinterp2x, advinterp3x, hq2x, hq3x, 2xsai, super2xsai, supereagle, tv2x, tv3x, rgb2x, rgb3x, scan2x, scan3x, hardware_none, hardware2x, hardware3x, hardware4x, hardware5x.
  509. # autofit: Best fits image to window
  510. # - Intended for output=direct3d, fullresolution=original, aspect=true
  511. frameskip=0
  512. aspect=false
  513. char9=true
  514. doublescan=false
  515. scaler=normal2x
  516. autofit=true
  517.  
  518. [vsync]
  519. # vsyncmode: Synchronize vsync timing to the host display. Requires calibration within dosbox.
  520. # Possible values: off, on, force, host.
  521. # vsyncrate: Vsync rate used if vsync is enabled. Ignored if vsyncmode is set to host (win32).
  522. # Possible values:.
  523. vsyncmode=off
  524. vsyncrate=75
  525.  
  526. [cpu]
  527. # core: CPU Core used in emulation. auto will switch to dynamic if available and appropriate.
  528. # WARNING: Do not use dynamic or auto setting core with Windows 95 or other preemptive
  529. # multitasking OSes with protected mode paging, you should use the normal core instead.
  530. # Possible values: auto, normal, full, simple.
  531. # fpu: Enable FPU emulation
  532. # segment limits: Enforce segment limits
  533. # double fault: Emulate double fault exception
  534. # reset on triple fault: Reset CPU on triple fault condition (failure to handle double fault)
  535. # always report double fault: Always report (to log file) double faults if set. Else, a double fault is reported only once. Set this option for debugging purposes.
  536. # always report triple fault: Always report (to log file) triple faults if set. Else, a triple fault is reported only once. Set this option for debugging purposes.
  537. # enable msr: Allow RDMSR/WRMSR instructions. This option is only meaningful when cputype=pentium.
  538. # WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
  539. # enable cmpxchg8b: Enable Pentium CMPXCHG8B instruction. Enable this explicitly if using software that uses this instruction.
  540. # You must enable this option to run Windows ME because portions of the kernel rely on this instruction.
  541. # ignore undefined msr: Ignore RDMSR/WRMSR on undefined registers. Normally the CPU will fire an Invalid Opcode exception in that case.
  542. # This option is off by default, enable if using software or drivers that assumes the presence of
  543. # certain MSR registers without checking. If you are using certain versions of the 3Dfx glide drivers for MS-DOS
  544. # you will need to set this to TRUE as 3Dfx appears to have coded GLIDE2.OVL to assume the presence
  545. # of Pentium Pro/Pentium II MTRR registers.
  546. # WARNING: Leaving this option enabled while installing Windows 95/98/ME can cause crashes.
  547. # interruptible rep string op: if nonzero, REP string instructions (LODS/MOVS/STOS/INS/OUTS) are interruptible (by interrupts or other events).
  548. # if zero, REP string instructions are carried out in full before processing events and interrupts.
  549. # Set to -1 for a reasonable default setting based on cpu type and other configuration.
  550. # A setting of 0 can improve emulation speed at the expense of emulation accuracy.
  551. # A nonzero setting (1-8) may be needed for DOS games and demos that use the IRQ 0 interrupt to play digitized samples
  552. # while doing VGA palette animation at the same time (use case of REP OUTS), where the non-interruptible version
  553. # would cause an audible drop in audio pitch.
  554. # dynamic core cache block size: dynamic core cache block size. default value is 32. change this value carefully.
  555. # according to forum discussion, setting this to 1 can aid debugging, however doing so
  556. # also causes problems with 32-bit protected mode DOS games and reduces the performance
  557. # of the dynamic core.
  558. #
  559. # cputype: CPU Type used in emulation. auto emulates a 486 which tolerates Pentium instructions.
  560. # Possible values: auto, 8086, 8086_prefetch, 80186, 80186_prefetch, 286, 286_prefetch, 386, 386_prefetch, 486, 486_prefetch, pentium, pentium_mmx, ppro_slow.
  561. # cycles: Amount of instructions DOSBox tries to emulate each millisecond.
  562. # Setting this value too high results in sound dropouts and lags.
  563. # Cycles can be set in 3 ways:
  564. # 'auto' tries to guess what a game needs.
  565. # It usually works, but can fail for certain games.
  566. # 'fixed #number' will set a fixed amount of cycles. This is what you usually
  567. # need if 'auto' fails (Example: fixed 4000).
  568. # 'max' will allocate as much cycles as your computer is able to
  569. # handle.
  570. # Possible values: auto, fixed, max.
  571. # cycleup: Amount of cycles to decrease/increase with keycombos.(CTRL-F11/CTRL-F12)
  572. # cycledown: Setting it lower than 100 will be a percentage.
  573. # use dynamic core with paging on: Dynamic core is NOT compatible with the way page faults in the guest are handled in DosBox-X.
  574. # Windows 9x may crash with paging on if dynamic core is enabled. Enable at your own risk.
  575. #
  576. # ignore opcode 63: When debugging, do not report illegal opcode 0x63.
  577. # Enable this option to ignore spurious errors while debugging from within Windows 3.1/9x/ME
  578. # apmbios: Emulate Advanced Power Management BIOS calls
  579. # apmbios pnp: If emulating ISA PnP BIOS, announce APM BIOS in PnP enumeration.
  580. # Warning: this can cause Windows 95 OSR2 and later to enumerate the APM BIOS twice and cause problems.
  581. # apmbios version: What version of the APM BIOS specification to emulate.
  582. # You will need at least APM BIOS v1.1 for emulation to work with Windows 95/98/ME
  583. # Possible values: auto, 1.0, 1.1, 1.2.
  584. # apmbios allow realmode: Allow guest OS to connect from real mode.
  585. # apmbios allow 16-bit protected mode: Allow guest OS to connect from 16-bit protected mode.
  586. # apmbios allow 32-bit protected mode: Allow guest OS to connect from 32-bit protected mode.
  587. # If you want power management in Windows 95/98/ME (beyond using the APM to shutdown the computer) you MUST enable this option.
  588. # Windows 95/98/ME does not support the 16-bit real and protected mode APM BIOS entry points.
  589. # Please note at this time that 32-bit APM is unstable under Windows ME
  590. # integration device: Enable DOSBox integration I/O device. This can be used by the guest OS to match mouse pointer position, for example. EXPERIMENTAL!
  591. # integration device pnp: List DOSBox integration I/O device as part of ISA PnP enumeration. This has no purpose yet.
  592. # isapnpbios: Emulate ISA Plug & Play BIOS. Enable if using DOSBox to run a PnP aware DOS program or if booting Windows 9x.
  593. # Do not disable if Windows 9x is configured around PnP devices, you will likely confuse it.
  594. # realbig16: Allow the B (big) bit in real mode. If set, allow the DOS program to set the B bit,
  595. # then jump to realmode with B still set (aka Huge Unreal mode). Needed for Project Angel.
  596. core=normal
  597. fpu=true
  598. segment limits=true
  599. double fault=true
  600. reset on triple fault=true
  601. always report double fault=false
  602. always report triple fault=false
  603. enable msr=true
  604. enable cmpxchg8b=true
  605. ignore undefined msr=true
  606. interruptible rep string op=-1
  607. dynamic core cache block size=32
  608. cputype=pentium
  609. cycles=fixed 25000
  610. cycleup=10
  611. cycledown=20
  612. use dynamic core with paging on=false
  613. ignore opcode 63=true
  614. apmbios=false
  615. apmbios pnp=false
  616. apmbios version=auto
  617. apmbios allow realmode=true
  618. apmbios allow 16-bit protected mode=true
  619. apmbios allow 32-bit protected mode=true
  620. integration device=false
  621. integration device pnp=false
  622. isapnpbios=true
  623. realbig16=false
  624.  
  625. [keyboard]
  626. # aux: Enable emulation of the 8042 auxiliary port. PS/2 mouse emulation requires this to be enabled.
  627. # You should enable this if you will be running Windows ME or any other OS that does not use the BIOS to receive mouse events.
  628. # allow output port reset: If set (default), allow the application to reset the CPU through the keyboard controller.
  629. # This option is required to allow Windows ME to reboot properly, whereas Windows 9x and earlier
  630. # will reboot without this option using INT 19h
  631. # auxdevice: Type of PS/2 mouse attached to the AUX port
  632. # Possible values: none, 2button, 3button, intellimouse, intellimouse45.
  633. aux=false
  634. allow output port reset=true
  635. auxdevice=intellimouse
  636.  
  637. [pci]
  638. # voodoo: Enable VOODOO support.
  639. # Possible values: false, software, opengl, auto.
  640. voodoo=opengl
  641.  
  642. [mixer]
  643. # nosound: Enable silent mode, sound is still emulated though.
  644. # sample accurate: Enable sample accurate mixing, at the expense of some emulation performance. Enable this option for DOS games and demos that
  645. # require such accuracy for correct Tandy/OPL output including digitized speech. This option can also help eliminate minor
  646. # errors in Gravis Ultrasound emulation that result in random echo/attenuation effects.
  647. # swapstereo: Swaps the left and right stereo channels.
  648. # rate: Mixer sample rate, setting any device's rate higher than this will probably lower their sound quality.
  649. # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
  650. # blocksize: Mixer block size, larger blocks might help sound stuttering but sound will also be more lagged.
  651. # Possible values: 1024, 2048, 4096, 8192, 512, 256.
  652. # prebuffer: How many milliseconds of data to keep on top of the blocksize.
  653. nosound=false
  654. sample accurate=false
  655. swapstereo=false
  656. rate=44100
  657. blocksize=1024
  658. prebuffer=20
  659.  
  660. [midi]
  661. # mpu401: Type of MPU-401 to emulate.
  662. # Possible values: intelligent, uart, none.
  663. # mididevice: Device that will receive the MIDI data from MPU-401.
  664. # Possible values: default, win32, alsa, oss, coreaudio, coremidi, mt32, synth, timidity, none.
  665. # midiconfig: Special configuration options for the device driver. This is usually the id of the device you want to use.
  666. # or in the case of coreaudio or synth, you can specify a soundfont here.
  667. # When using a Roland MT-32 rev. 0 as midi output device, some games may require a delay in order to prevent 'buffer overflow' issues.
  668. # In that case, add 'delaysysex', for example: midiconfig=2 delaysysex
  669. # See the README/Manual for more details.
  670. # samplerate: Sample rate for MIDI synthesizer, if applicable.
  671. # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
  672. # mpuirq: MPU-401 IRQ. -1 to automatically choose.
  673. # mt32.reverse.stereo: Reverse stereo channels for MT-32 output
  674. # Possible values: off, on.
  675. # mt32.verbose: MT-32 debug logging
  676. # Possible values: off, on.
  677. # mt32.thread: MT-32 rendering in separate thread
  678. # Possible values: off, on.
  679. # mt32.dac: MT-32 DAC input emulation mode
  680. # Nice = 0 - default
  681. # Produces samples at double the volume, without tricks.
  682. # Higher quality than the real devices
  683. #
  684. # Pure = 1
  685. # Produces samples that exactly match the bits output from the emulated LA32.
  686. # Nicer overdrive characteristics than the DAC hacks (it simply clips samples within range)
  687. # Much less likely to overdrive than any other mode.
  688. # Half the volume of any of the other modes, meaning its volume relative to the reverb
  689. # output when mixed together directly will sound wrong. So, reverb level must be lowered.
  690. # Perfect for developers while debugging :)
  691. #
  692. # GENERATION1 = 2
  693. # Re-orders the LA32 output bits as in early generation MT-32s (according to Wikipedia).
  694. # Bit order at DAC (where each number represents the original LA32 output bit number, and XX means the bit is always low):
  695. # 15 13 12 11 10 09 08 07 06 05 04 03 02 01 00 XX
  696. #
  697. # GENERATION2 = 3
  698. # Re-orders the LA32 output bits as in later geneerations (personally confirmed on my CM-32L - KG).
  699. # Bit order at DAC (where each number represents the original LA32 output bit number):
  700. # 15 13 12 11 10 09 08 07 06 05 04 03 02 01 00 14
  701. #
  702. # Possible values: 0, 1, 2, 3, auto.
  703. # mt32.reverb.mode: MT-32 reverb mode
  704. # Possible values: 0, 1, 2, 3, auto.
  705. # mt32.reverb.time: MT-32 reverb decaying time
  706. # Possible values: 0, 1, 2, 3, 4, 5, 6, 7.
  707. # mt32.reverb.level: MT-32 reverb level
  708. # Possible values: 0, 1, 2, 3, 4, 5, 6, 7.
  709. # mt32.partials: MT-32 max partials allowed (0-256)
  710. mpu401=intelligent
  711. mididevice=default
  712. midiconfig=
  713. samplerate=44100
  714. mpuirq=-1
  715. mt32.reverse.stereo=off
  716. mt32.verbose=off
  717. mt32.thread=off
  718. mt32.dac=auto
  719. mt32.reverb.mode=auto
  720. mt32.reverb.time=5
  721. mt32.reverb.level=3
  722. mt32.partials=32
  723.  
  724. [sblaster]
  725. # sbtype: Type of Soundblaster to emulate. gb is Gameblaster.
  726. # Possible values: sb1, sb2, sbpro1, sbpro2, sb16, sb16vibra, gb, ess688, reveal_sc400, none.
  727. # sbbase: The IO address of the soundblaster.
  728. # Possible values: 220, 240, 260, 280, 2a0, 2c0, 2e0, 300.
  729. # irq: The IRQ number of the soundblaster. Set to -1 to start DOSBox with the IRQ unassigned
  730. # Possible values: 7, 5, 3, 9, 10, 11, 12.
  731. # mindma: Minimum DMA transfer left to increase attention across DSP blocks, in milliseconds. Set to -1 for default.
  732. # There are some DOS games/demos that use single-cycle DSP playback in their music tracker and they micromanage
  733. # the DMA transfer per block poorly in a way that causes popping and artifacts. Setting this option to 0 for
  734. # such DOS applications may reduce audible popping and artifacts.
  735. # irq hack: Specify a hack related to the Sound Blaster IRQ to avoid crashes in a handful of games and demos.
  736. # none Emulate IRQs normally
  737. # cs_equ_ds Do not fire IRQ unless two CPU segment registers match: CS == DS. Read Dosbox-X Wiki or source code for details.
  738. # Possible values: none, cs_equ_ds.
  739. # dma: The DMA number of the soundblaster. Set to -1 to start DOSBox with the IRQ unassigned
  740. # Possible values: 1, 5, 0, 3, 6, 7.
  741. # hdma: The High DMA number of the soundblaster. Set to -1 to start DOSBox with the IRQ unassigned
  742. # Possible values: 1, 5, 0, 3, 6, 7.
  743. # pic unmask irq: Start the DOS virtual machine with the sound blaster IRQ already unmasked at the PIC.
  744. # Some early DOS games/demos that support Sound Blaster expect the IRQ to fire but make
  745. # no attempt to unmask the IRQ. If audio cuts out no matter what IRQ you try, then try
  746. # setting this option.
  747. # Option is needed for:
  748. # Public NMI "jump" demo (1992)
  749. # enable speaker: Start the DOS virtual machine with the sound blaster speaker enabled.
  750. # Sound Blaster Pro and older cards have a speaker disable/enable command.
  751. # Normally the card boots up with the speaker disabled. If a DOS game or demo
  752. # attempts to play without enabling the speaker, set this option to true to
  753. # compensate. This setting has no meaning if emulating a Sound Blaster 16 card.
  754. # enable asp: If set, emulate the presence of the Sound Blaster 16 Advanced Sound Processor/Creative Sound Processor chip.
  755. # NOTE: This only emulates it's presence and the basic DSP commands to communicate with it. Actual ASP/CSP functions are not yet implemented.
  756. # disable filtering: By default DOSBox-X filters Sound Blaster output to emulate lowpass filters and analog output limitations.
  757. # Set this option to true to disable filtering. Note that doing so disables emulation of the Sound Blaster Pro
  758. # output filter and ESS AudioDrive lowpass filter.
  759. # dsp write buffer status must return 0x7f or 0xff: If set, force port 22Ch (DSP write buffer status) to return 0x7F or 0xFF. If not set, the port
  760. # may return 0x7F or 0xFF depending on what type of Sound Blaster is being emulated.
  761. # Set this option for some early DOS demos that make that assumption about port 22Ch.
  762. # Option is needed for:
  763. # Overload by Hysteria (1992) - Audio will crackle/saturate (8-bit overflow) except when sbtype=sb16
  764. # pre-set sbpro stereo: Start the DOS virtual machine with the Sound Blaster Pro stereo bit set (in the mixer).
  765. # A few demos support Sound Blaster Pro but forget to set this bit.
  766. # Option is needed for:
  767. # Inconexia by Iguana (1993)
  768. # sbmixer: Allow the soundblaster mixer to modify the DOSBox mixer.
  769. # oplmode: Type of OPL emulation. On 'auto' the mode is determined by sblaster type.
  770. # To emulate Adlib, set sbtype=none and oplmode=opl2. To emulate a Game Blaster, set
  771. # sbtype=none and oplmode=cms
  772. # Possible values: auto, cms, opl2, dualopl2, opl3, none, hardware, hardwaregb.
  773. # adlib force timer overflow on detect: If set, Adlib/OPL emulation will signal 'overflow' on timers after 50 I/O reads.
  774. # This is a temporary hack to work around timing bugs noted in DOSBox-X. Certain
  775. # games (Wolfenstein 3D) poll the Adlib status port a fixed number of times assuming
  776. # that the poll loop takes long enough for the Adlib timer to run out. If the game
  777. # cannot reliably detect Adlib at higher cycles counts, but can reliably detect at
  778. # lower cycles counts, set this option.
  779. # NOTE: Technically this decreases emulation accuracy, however it also reflects the
  780. # fact that DOSBox-X's I/O timing code needs some work to better match the
  781. # slowness of the ISA bus per I/O read in consideration of DOS games. So this
  782. # option is ON by default.
  783. # oplemu: Provider for the OPL emulation. compat might provide better quality (see oplrate as well).
  784. # Possible values: default, compat, fast, nuked.
  785. # oplrate: Sample rate of OPL music emulation. Use 49716 for highest quality (set the mixer rate accordingly).
  786. # Possible values: 44100, 49716, 48000, 32000, 22050, 16000, 11025, 8000.
  787. # hardwarebase: base address of the real hardware soundblaster:
  788. # 210,220,230,240,250,260,280
  789. # force dsp auto-init: Treat all single-cycle DSP commands as auto-init to keep playback going.
  790. # This option is a workaround for DOS games or demos that use single-cycle DSP playback commands and
  791. # have problems with missing the Sound Blaster IRQ under load. Do not enable unless you need this workaround.
  792. # Needed for:
  793. # - Extreme "lunatic" demo (1993)
  794. # force goldplay: Always render Sound Blaster output sample-at-a-time. Testing option. You probably don't want to enable this.
  795. # goldplay: Enable goldplay emulation.
  796. # goldplay stereo: Enable workaround for goldplay stereo playback. Many DOS demos using this technique
  797. # don't seem to know they need to double the frequency when programming the DSP time constant for Pro stereo output.
  798. # If stereo playback seems to have artifacts consider enabling this option. For accurate emulation of Sound Blaster
  799. # hardware, disable this option.
  800. # dsp require interrupt acknowledge: If set, the DSP will halt DMA playback until IRQ acknowledgement occurs even in auto-init mode (SB16 behavior).
  801. # If clear, IRQ acknowledgement will have no effect on auto-init playback (SB Pro and earlier & clone behavior)
  802. # If set to 'auto' then behavior is determined by sbtype= setting.
  803. # This is a setting for hardware accuracy in emulation. If audio briefly plays then stops then your DOS game
  804. # and it's not using IRQ (but using DMA), try setting this option to 'false'
  805. # dsp write busy delay: Amount of time in nanoseconds the DSP chip signals 'busy' after writing to the DSP (port 2xCh). Set to -1 to use card-specific defaults.
  806. # WARNING: Setting the value too high (above 20000ns) may have detrimental effects to DOS games that use IRQ 0 and DSP command 0x10 to play audio.
  807. # Setting the value way too high (above 1000000ns) can cause significant lag in DOS games.
  808. # blaster environment variable: Whether or not to set the BLASTER environment variable automatically at startup
  809. # sample rate limits: If set (default), limit DSP sample rate to what real hardware is limited to
  810. # instant direct dac: If set, direct DAC output commands are instantaneous. This option is intended as a quick fix for
  811. # games or demos that play direct DAC music/sound from the IRQ 0 timer who a) write the DSP command
  812. # and data without polling the DSP to ensure it's ready or b) can get locked into the IRQ 0 handler
  813. # waiting for DSP status when instructed to play at or beyond the DSP's maximum direct DAC sample rate.
  814. # This fix allows broken Sound Blaster code to work and should not be enabled unless necessary.
  815. # stereo control with sbpro only: Default on. If set, Sound Blaster Pro stereo is not available when emulating sb16 or sb16vibra.
  816. # If clear, sb16 emulation will honor the sbpro stereo bit. Note that Creative SB16 cards do not
  817. # honor the stereo bit, and this option allows DOSBox emulate that fact. Accuracy setting.
  818. # dsp busy cycle rate: Sound Blaster 16 DSP chips appear to go busy periodically at some high clock rate
  819. # whether the DSP is actually doing anything for the system or not. This is an accuracy
  820. # option for Sound Blaster emulation. If this option is nonzero, it will be interpreted
  821. # as the busy cycle rate in Hz. If zero, busy cycle will not be emulated. If -1, sound
  822. # blaster emulation will automatically choose a setting based on the sbtype= setting
  823. # dsp busy cycle always: If set, the DSP busy cycle always happens. If clear, DSP busy cycle only happens when
  824. # audio playback is running. Default setting is to pick according to the sound card.
  825. # dsp busy cycle duty: If emulating SB16 busy cycle, this value (0 to 100) controls the duty cycle of the busy cycle.
  826. # If this option is set to -1, Sound Blaster emulation will choose a value automatically according
  827. # to sbtype=. If 0, busy cycle emulation is disabled.
  828. # io port aliasing: If set, Sound Blaster ports alias by not decoding the LSB of the I/O port.
  829. # This option only applies when sbtype is set to sb1 or sb2 (not SBPro or SB16).
  830. # This is a hack for the Electromotive Force 'Internal Damage' demo which apparently
  831. # relies on this behavior for Sound Blaster output and should be enabled for accuracy in emulation.
  832. sbtype=sb16
  833. sbbase=220
  834. irq=7
  835. mindma=-1
  836. irq hack=none
  837. dma=1
  838. hdma=5
  839. pic unmask irq=false
  840. enable speaker=false
  841. enable asp=false
  842. disable filtering=false
  843. dsp write buffer status must return 0x7f or 0xff=false
  844. pre-set sbpro stereo=false
  845. sbmixer=true
  846. oplmode=auto
  847. adlib force timer overflow on detect=true
  848. oplemu=default
  849. oplrate=44100
  850. hardwarebase=220
  851. force dsp auto-init=false
  852. force goldplay=false
  853. goldplay=true
  854. goldplay stereo=true
  855. dsp require interrupt acknowledge=auto
  856. dsp write busy delay=-1
  857. blaster environment variable=true
  858. sample rate limits=true
  859. instant direct dac=false
  860. stereo control with sbpro only=true
  861. dsp busy cycle rate=-1
  862. dsp busy cycle always=-1
  863. dsp busy cycle duty=-1
  864. io port aliasing=true
  865.  
  866. [gus]
  867. # gus: Enable the Gravis Ultrasound emulation.
  868. # autoamp: If set, GF1 output will reduce in volume automatically if the sum of all channels exceeds full volume.
  869. # If not set, then loud music will clip to full volume just as it would on real hardware.
  870. # Enable this option for loud music if you want a more pleasing rendition without saturation and distortion.
  871. # unmask dma: Start the DOS virtual machine with the DMA channel already unmasked at the controller.
  872. # Use this for DOS applications that expect to operate the GUS but forget to unmask the DMA channel.
  873. # clear dma tc irq if excess polling: If the DOS application is seen polling the IRQ status register rapidly, automatically clear the DMA TC IRQ status.
  874. # This is a hack that should only be used with DOS applications that need it to avoid bugs in their GUS support code.
  875. # Needed for:
  876. # Warcraft II by Blizzard ............. if using GUS for music and sound, set this option to prevent the game from
  877. # hanging when you click on the buttons in the main menu.
  878. # force master irq enable: Set this option if a DOS game or demo initializes the GUS but is unable to play any music.
  879. # Usually the cause is buggy GUS support that resets the GUS but fails to set the Master IRQ enable bit.
  880. # gus panning table: Controls which table or equation is used for the Gravis Ultrasound panning emulation.
  881. # accurate emulation attempts to better reflect how the actual hardware handles panning,
  882. # while the old emulation uses a simpler idealistic mapping.
  883. # Possible values: old, accurate, default.
  884. # gusrate: Sample rate of Ultrasound emulation.
  885. # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
  886. # gus fixed render rate: If set, Gravis Ultrasound audio output is rendered at a fixed sample rate specified by 'gusrate'. This can provide better quality than real hardware,
  887. # if desired. Else, Gravis Ultrasound emulation will change the sample rate of it's output according to the number of active channels, just like real hardware.
  888. # Note: DOSBox-X defaults to 'false', while mainline DOSBox SVN is currently hardcoded to render as if this setting is 'true'.
  889. # gusmemsize: Amount of RAM on the Gravis Ultrasound in KB. Set to -1 for default.
  890. # gusbase: The IO base address of the Gravis Ultrasound.
  891. # Possible values: 240, 220, 260, 280, 2a0, 2c0, 2e0, 300, 210, 230, 250.
  892. # gusirq: The IRQ number of the Gravis Ultrasound.
  893. # Possible values: 5, 3, 7, 9, 10, 11, 12.
  894. # gusdma: The DMA channel of the Gravis Ultrasound.
  895. # Possible values: 3, 0, 1, 5, 6, 7.
  896. # gustype: Type of Gravis Ultrasound to emulate.
  897. # classic Original Gravis Ultrasound chipset
  898. # classic37 Original Gravis Ultrasound with ICS Mixer (rev 3.7)
  899. # max Gravis Ultrasound MAX emulation (with CS4231 codec)
  900. # interwave Gravis Ultrasound Plug & Play (interwave)
  901. # Possible values: classic, classic37, max, interwave.
  902. # ultradir: Path to Ultrasound directory. In this directory
  903. # there should be a MIDI directory that contains
  904. # the patch files for GUS playback. Patch sets used
  905. # with Timidity should work fine.
  906. gus=false
  907. autoamp=false
  908. unmask dma=false
  909. clear dma tc irq if excess polling=false
  910. force master irq enable=false
  911. gus panning table=default
  912. gusrate=44100
  913. gus fixed render rate=false
  914. gusmemsize=-1
  915. gusbase=240
  916. gusirq=5
  917. gusdma=3
  918. gustype=classic
  919. ultradir=C:\ULTRASND
  920.  
  921. [innova]
  922. # innova: Enable the Innovation SSI-2001 emulation.
  923. # samplerate: Sample rate of Innovation SSI-2001 emulation
  924. # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
  925. # sidbase: SID base port (typically 280h).
  926. # Possible values: 240, 220, 260, 280, 2a0, 2c0, 2e0, 300.
  927. # quality: Set SID emulation quality level (0 to 3).
  928. # Possible values: 0, 1, 2, 3.
  929. innova=false
  930. samplerate=22050
  931. sidbase=280
  932. quality=0
  933.  
  934. [speaker]
  935. # pcspeaker: Enable PC-Speaker emulation.
  936. # initial frequency: PC speaker PIT timer is programmed to this frequency on startup. If the DOS game
  937. # or demo causes a long audible beep at startup (leaving the gate open) try setting
  938. # this option to 0 to silence the PC speaker until reprogrammed by the demo.
  939. # Set to 0 for some early Abaddon demos including "Torso" and "Cycling".
  940. # pcrate: Sample rate of the PC-Speaker sound generation.
  941. # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
  942. # tandy: Enable Tandy Sound System emulation. For 'auto', emulation is present only if machine is set to 'tandy'.
  943. # Possible values: auto, on, off.
  944. # tandyrate: Sample rate of the Tandy 3-Voice generation.
  945. # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
  946. # disney: Enable Disney Sound Source emulation. (Covox Voice Master and Speech Thing compatible).
  947. # ps1audio: Enable PS1 audio emulation.
  948. # Possible values: on, off.
  949. # ps1audiorate: Sample rate of the PS1 audio emulation.
  950. # Possible values: 44100, 48000, 32000, 22050, 16000, 11025, 8000, 49716.
  951. pcspeaker=true
  952. initial frequency=-1
  953. pcrate=44100
  954. tandy=auto
  955. tandyrate=44100
  956. disney=false
  957. ps1audio=off
  958. ps1audiorate=22050
  959.  
  960. [joystick]
  961. # joysticktype: Type of joystick to emulate: auto (default), none,
  962. # 2axis (supports two joysticks),
  963. # 4axis (supports one joystick, first joystick used),
  964. # 4axis_2 (supports one joystick, second joystick used),
  965. # fcs (Thrustmaster), ch (CH Flightstick).
  966. # none disables joystick emulation.
  967. # auto chooses emulation depending on real joystick(s).
  968. # (Remember to reset dosbox's mapperfile if you saved it earlier)
  969. # Possible values: auto, 2axis, 4axis, 4axis_2, fcs, ch, none.
  970. # timed: enable timed intervals for axis. Experiment with this option, if your joystick drifts (away).
  971. # autofire: continuously fires as long as you keep the button pressed.
  972. # swap34: swap the 3rd and the 4th axis. can be useful for certain joysticks.
  973. # buttonwrap: enable button wrapping at the number of emulated buttons.
  974. joysticktype=auto
  975. timed=true
  976. autofire=false
  977. swap34=false
  978. buttonwrap=false
  979.  
  980. [serial]
  981. # serial1: set type of device connected to com port.
  982. # Can be disabled, dummy, modem, nullmodem, directserial.
  983. # Additional parameters must be in the same line in the form of
  984. # parameter:value. Parameter for all types is irq (optional).
  985. # for directserial: realport (required), rxdelay (optional).
  986. # (realport:COM1 realport:ttyS0).
  987. # for modem: listenport (optional).
  988. # for nullmodem: server, rxdelay, txdelay, telnet, usedtr,
  989. # transparent, port, inhsocket, nonlocal (all optional).
  990. # connections are limited to localhost unless you specify nonlocal:1
  991. # Example: serial1=modem listenport:5000
  992. # Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log.
  993. # serial2: see serial1
  994. # Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log.
  995. # serial3: see serial1
  996. # Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log.
  997. # serial4: see serial1
  998. # Possible values: dummy, disabled, modem, nullmodem, serialmouse, directserial, log.
  999. serial1=dummy
  1000. serial2=dummy
  1001. serial3=disabled
  1002. serial4=disabled
  1003.  
  1004. [parallel]
  1005. # parallel1: parallel1-3 -- set type of device connected to lpt port.
  1006. # Can be:
  1007. # reallpt (direct parallel port passthrough),
  1008. # file (records data to a file or passes it to a device),
  1009. # printer (virtual dot-matrix printer, see [printer] section)
  1010. # disney (attach Disney Sound Source emulation to this port)
  1011. # Additional parameters must be in the same line in the form of
  1012. # parameter:value.
  1013. # for reallpt:
  1014. # Windows:
  1015. # realbase (the base address of your real parallel port).
  1016. # Default: 378
  1017. # ecpbase (base address of the ECP registers, optional).
  1018. # Linux: realport (the parallel port device i.e. /dev/parport0).
  1019. # for file:
  1020. # dev:<devname> (i.e. dev:lpt1) to forward data to a device,
  1021. # or append:<file> appends data to the specified file.
  1022. # Without the above parameters data is written to files in the capture dir.
  1023. # Additional parameters: timeout:<milliseconds> = how long to wait before
  1024. # closing the file on inactivity (default:500), addFF to add a formfeed when
  1025. # closing, addLF to add a linefeed if the app doesn't, cp:<codepage number>
  1026. # to perform codepage translation, i.e. cp:437
  1027. # for printer:
  1028. # printer still has it's own configuration section above.
  1029. # parallel2: see parallel1
  1030. # parallel3: see parallel1
  1031. # dongle: Enable dongle
  1032. parallel1=disabled
  1033. parallel2=disabled
  1034. parallel3=disabled
  1035. dongle=false
  1036.  
  1037. [dos]
  1038. # xms: Enable XMS support.
  1039. # hma: Report through XMS that HMA exists (not necessarily available)
  1040. # hma allow reservation: Allow TSR and application (anything other than the DOS kernel) to request control of the HMA.
  1041. # They will not be able to request control however if the DOS kernel is configured to occupy the HMA (DOS=HIGH)
  1042. # hard drive data rate limit: Slow down (limit) hard disk throughput. This setting controls the limit in bytes/second.
  1043. # Set to 0 to disable the limit, or -1 to use a reasonable default.
  1044. # hma minimum allocation: Minimum allocation size for HMA in bytes (equivalent to /HMAMIN= parameter).
  1045. # log console: If set, log DOS CON output to the log file.
  1046. # dos in hma: Report that DOS occupies HMA (equiv. DOS=HIGH)
  1047. # dos sda size: SDA (swappable data area) size, in bytes. Set to 0 to use a reasonable default.
  1048. # hma free space: Controls the amount of free space available in HMA. This setting is not meaningful unless the
  1049. # DOS kernel occupies HMA and the emulated DOS version is at least 5.0.
  1050. # cpm compatibility mode: This controls how the DOS kernel sets up the CP/M compatibility code in the PSP segment.
  1051. # Several options are provided to emulate one of several undocumented behaviors related to the CP/M entry point.
  1052. # If set to auto, DOSBox-X will pick the best option to allow it to work properly.
  1053. # Unless set to 'off', this option will require the DOS kernel to occupy the first 256 bytes of the HMA memory area
  1054. # to prevent crashes when the A20 gate is switched on.
  1055. # auto Pick the best option
  1056. # off Turn off the CP/M entry point (program will abort if called)
  1057. # msdos2 MS-DOS 2.x behavior, offset field also doubles as data segment size
  1058. # msdos5 MS-DOS 5.x behavior, entry point becomes one of two fixed addresses
  1059. # direct Non-standard behavior, encode the CALL FAR directly to the entry point rather than indirectly
  1060. # Possible values: auto, off, msdos2, msdos5, direct.
  1061. # share: Report SHARE.EXE as resident. Does not actually emulate SHARE functions.
  1062. # write plain iretf for debug interrupts: If true (default), the DOS kernel will create an alternate interrupt handler for debug interrupts INT 1 and INT 3
  1063. # that contain ONLY an IRETF instruction. If false, INT 1 and INT 3 will use the same default interrupt handler in
  1064. # the DOS kernel, which contains a callback instruction followed by IRETF. Some DOS games/demos assume they are being
  1065. # debugged if the debug interrupts point to anything other than an IRETF instruction. Set this option to false if
  1066. # you need notification that INT 1/INT 3 was not handled.
  1067. # minimum dos initial private segment: In non-mainline mapping mode, where DOS structures are allocated from base memory, this sets the
  1068. # minimum segment value. Recommended value is 0x70. You may reduce the value down to 0x50 if freeing
  1069. # up more memory is important. Set to 0 for default.
  1070. # minimum mcb segment: Minimum segment value to begin memory allocation from, in hexadecimal. Set to 0 for default.
  1071. # You can increase available DOS memory by reducing this value down to as low as 0x51, however
  1072. # setting it to low can cause some DOS programs to crash or run erratically, and some DOS games
  1073. # and demos to cause intermittent static noises when using Sound Blaster output. DOS programs
  1074. # compressed with Microsoft EXEPACK will not run if the minimum MCB segment is below 64KB.
  1075. # minimum mcb free: Minimum free segment value to leave free. At startup, the DOS kernel will allocate memory
  1076. # up to this point. This can be used to deal with EXEPACK issues or DOS programs that cannot
  1077. # be loaded too low in memory. This differs from 'minimum mcb segment' in that this affects
  1078. # the lowest free block instead of the starting point of the mcb chain.
  1079. # enable dummy device mcb: If set (default), allocate a fake device MCB at the base of conventional memory.
  1080. # Clearing this option can reclaim a small amount of conventional memory at the expense of
  1081. # some minor DOS compatibility.
  1082. # enable loadfix padding: If set (default), allocate a small 1KB region at the base of conventional memory.
  1083. # Clearing this option can reclaim a small amount of conventional memory, but can also
  1084. # cause some DOS games to break especially if dynamic kernel allocation is enabled.
  1085. # enable dummy environment block: If set (default), allocate a dummy environment block at the base of conventional memory.
  1086. # You can clear this option to reclaim a small amount of conventional memory.
  1087. # maximum environment block size on exec: Maximum environment block size to copy for child processes. Set to -1 for default.
  1088. # additional environment block size on exec: When executing a program, compute the size of the parent block then add this amount to allow for a few additional variables.
  1089. # If the subprocesses will never add/modify the environment block, you can free up a few additional bytes by setting this to 0.
  1090. # Set to -1 for default setting.
  1091. # enable a20 on windows init: If set, DOSBox will enable the A20 gate when Windows 3.1/9x broadcasts the INIT message
  1092. # at startup. Windows 3.1 appears to make assumptions at some key points on startup about
  1093. # A20 that don't quite hold up and cause Windows 3.1 to crash when you set A20 emulation
  1094. # to a20=mask as opposed to a20=fast. This option is enabled by default.
  1095. # zero memory on xms memory allocation: If set, memory returned by XMS allocation call is zeroed first. This is NOT what
  1096. # DOS actually does, but if set, can help certain DOS games and demos cope with problems
  1097. # related to uninitialized variables in extended memory. When enabled this option may
  1098. # incur a slight to moderate performance penalty.
  1099. # dosv: Enable DOS/V emulation and specify which version to emulate. This option is intended for
  1100. # use with games or software originating from Asia that use the double byte character set
  1101. # encodings and the DOS/V extensions to display Japanese, Chinese, or Korean text.
  1102. # Note that enabling DOS/V replaces 80x25 text mode (INT 10h mode 3) with a EGA/VGA graphics
  1103. # mode that emulates text mode to display the characters and may be incompatible with non-Asian
  1104. # software that assumes direct access to the text mode via segment 0xB800.
  1105. # WARNING: This option is very experimental at this time.
  1106. # Possible values: off, japanese, chinese, korean.
  1107. # ems: Enable EMS support. The default (=true) provides the best
  1108. # compatibility but certain applications may run better with
  1109. # other choices, or require EMS support to be disabled (=false)
  1110. # to work at all.
  1111. # Possible values: true, emsboard, emm386, false.
  1112. # vcpi: If set and expanded memory is enabled, also emulate VCPI.
  1113. # unmask timer on disk io: If set, INT 21h emulation will unmask IRQ 0 (timer interrupt) when the application opens/closes/reads/writes files.
  1114. # zero int 67h if no ems: If ems=false, leave interrupt vector 67h zeroed out (default true).
  1115. # This is a workaround for games or demos that try to detect EMS by whether or not INT 67h is 0000:0000 rather than a proper test.
  1116. # This option also affects whether INT 67h is zeroed when booting a guest OS
  1117. # emm386 startup active: If set and expanded memory is set to emulate emm386, start the DOS machine with EMM386.EXE active
  1118. # (running the 16-bit DOS environment from within Virtual 8086 mode). If you will be running anything
  1119. # that involves a DOS extender you will also need to enable the VCPI interface as well.
  1120. # zero memory on ems memory allocation: If set, memory returned by EMS allocation call is zeroed first. This is NOT what
  1121. # DOS actually does, but if set, can help certain DOS games and demos cope with problems
  1122. # related to uninitialized variables in expanded memory. When enabled this option may
  1123. # incur a slight to moderate performance penalty.
  1124. # ems system handle memory size: Amount of memory associated with system handle, in KB
  1125. # ems system handle on even megabyte: If set, try to allocate the EMM system handle on an even megabyte.
  1126. # If the DOS game or demo fiddles with the A20 gate while using EMM386.EXE emulation in virtual 8086 mode, setting this option may help prevent crashes.
  1127. # However, forcing allocation on an even megabyte will also cause some extended memory fragmentation and reduce the
  1128. # overall amount of extended memory available to the DOS game depending on whether it expects large contiguous chunks
  1129. # of extended memory.
  1130. # umb: Enable UMB support.
  1131. # umb start: UMB region starting segment
  1132. # umb end: UMB region last segment
  1133. # kernel allocation in umb: If set, dynamic kernel allocation=1, and private area in umb=1, all kernel structures will be allocated from the private area in UMB.
  1134. # If you intend to run Windows 3.1 in DOSBox, you must set this option to false else Windows 3.1 will not start.
  1135. # dynamic kernel allocation: If set, DOS kernel structures are allocated dynamically. If clear, DOS kernel structures are fixed at specific segments (mainline DOSBox behavior)
  1136. # keep umb on boot: If emulating UMBs, keep the UMB around after boot (Mainline DOSBox behavior). If clear, UMB is unmapped when you boot an operating system.
  1137. # keep private area on boot: If set, keep the DOSBox private area around after boot (Mainline DOSBox behavior). If clear, unmap and discard the private area when you boot an operating system.
  1138. # private area in umb: If set, keep private DOS segment in upper memory block, usually segment 0xC800 (Mainline DOSBox behavior)
  1139. # If clear, place private DOS segment at the base of system memory (just below the MCB)
  1140. # ver: Set DOS version. Specify as major.minor format. A single number is treated as the major version (LFN patch compat). Common settings are:
  1141. # auto (or unset) Pick a DOS kernel version automatically
  1142. # 3.3 MS-DOS 3.3 emulation (not tested!)
  1143. # 5.0 MS-DOS 5.0 emulation (recommended for DOS gaming)
  1144. # 6.22 MS-DOS 6.22 emulation
  1145. # 7.0 Windows 95 (pure DOS mode) emulation
  1146. #
  1147. # automount: Enable automatic mount.
  1148. # int33: Enable INT 33H (mouse) support.
  1149. # int 13 extensions: Enable INT 13h extensions (functions 0x40-0x48). You will need this enabled if the virtual hard drive image is 8.4GB or larger.
  1150. # biosps2: Emulate BIOS INT 15h PS/2 mouse services
  1151. # Note that some OS's like Microsoft Windows neither use INT 33h nor
  1152. # probe the AUX port directly and depend on this BIOS interface exclusively
  1153. # for PS/2 mouse support. In other cases there is no harm in leaving this enabled
  1154. # int15 wait force unmask irq: Some demos or games mistakingly use INT 15h AH=0x86 (WAIT) while leaving the IRQs needed for it masked.
  1155. # If this option is set (by default), the necessary IRQs will be unmasked when INT 15 AH=0x86 is used so that the game or demo does not hang.
  1156. # int15 mouse callback does not preserve registers: Set to true if the guest OS or DOS program assigns an INT 15h mouse callback,
  1157. # but does not properly preserve CPU registers. Diagnostic function only (default off).
  1158. # keyboardlayout: Language code of the keyboard layout (or none).
  1159. # dbcs: Enable DBCS table.
  1160. # CAUTION: Some software will crash without the DBCS table, including the Open Watcom installer.
  1161. #
  1162. # filenamechar: Enable filename char table
  1163. # collating and uppercase: Enable collating and uppercase table
  1164. # files: Number of file handles available to DOS programs. (equivalent to "files=" in config.sys)
  1165. # con device use int 16h to detect keyboard input: If set, use INT 16h to detect keyboard input (MS-DOS 6.22 behavior). If clear, detect keyboard input by
  1166. # peeking into the BIOS keyboard buffer (Mainline DOSBox behavior). You will need to set this
  1167. # option for programs that hook INT 16h to handle keyboard input ahead of the DOS console.
  1168. # Microsoft Scandisk needs this option to respond to keyboard input correctly.
  1169. # zero memory on int 21h memory allocation: If set, memory returned by the INT 21h allocation call is zeroed first. This is NOT what
  1170. # DOS actually does, but if set, can help certain DOS games and demos cope with problems
  1171. # related to uninitialized variables in the data or stack segment. If you intend to run a
  1172. # game or demo known to have this problem (Second Unreal, for example), set to true, else
  1173. # set to false. When enabled this option may incur a slight to moderate performance penalty.
  1174. xms=false
  1175. hma=true
  1176. hma allow reservation=true
  1177. hard drive data rate limit=-1
  1178. hma minimum allocation=0
  1179. log console=false
  1180. dos in hma=true
  1181. dos sda size=0
  1182. hma free space=34816
  1183. cpm compatibility mode=auto
  1184. share=true
  1185. write plain iretf for debug interrupts=true
  1186. minimum dos initial private segment=0
  1187. minimum mcb segment=0
  1188. minimum mcb free=0
  1189. enable dummy device mcb=false
  1190. enable loadfix padding=false
  1191. enable dummy environment block=false
  1192. maximum environment block size on exec=-1
  1193. additional environment block size on exec=-1
  1194. enable a20 on windows init=false
  1195. zero memory on xms memory allocation=false
  1196. dosv=off
  1197. ems=false
  1198. vcpi=true
  1199. unmask timer on disk io=false
  1200. zero int 67h if no ems=true
  1201. emm386 startup active=false
  1202. zero memory on ems memory allocation=false
  1203. ems system handle memory size=384
  1204. ems system handle on even megabyte=false
  1205. umb=false
  1206. umb start=0
  1207. umb end=0
  1208. kernel allocation in umb=false
  1209. dynamic kernel allocation=true
  1210. keep umb on boot=false
  1211. keep private area on boot=false
  1212. private area in umb=true
  1213. ver=
  1214. automount=true
  1215. int33=true
  1216. int 13 extensions=true
  1217. biosps2=true
  1218. int15 wait force unmask irq=true
  1219. int15 mouse callback does not preserve registers=false
  1220. keyboardlayout=auto
  1221. dbcs=true
  1222. filenamechar=true
  1223. collating and uppercase=true
  1224. files=127
  1225. con device use int 16h to detect keyboard input=true
  1226. zero memory on int 21h memory allocation=false
  1227.  
  1228. [ipx]
  1229. # ipx: Enable ipx over UDP/IP emulation.
  1230. ipx=false
  1231.  
  1232. [ne2000]
  1233. # ne2000: Enable Ethernet passthrough. Requires [Win]Pcap.
  1234. # nicbase: The base address of the NE2000 board.
  1235. # nicirq: The interrupt it uses. Note serial2 uses IRQ3 as default.
  1236. # macaddr: The physical address the emulator will use on your network.
  1237. # If you have multiple DOSBoxes running on your network,
  1238. # this has to be changed for each. AC:DE:48 is an address range reserved for
  1239. # private use, so modify the last three number blocks.
  1240. # I.e. AC:DE:48:88:99:AB.
  1241. # realnic: Specifies which of your network interfaces is used.
  1242. # Write 'list' here to see the list of devices in the
  1243. # Status Window. Then make your choice and put either the
  1244. # interface number (2 or something) or a part of your adapters
  1245. # name, e.g. VIA here.
  1246. ne2000=false
  1247. nicbase=300
  1248. nicirq=3
  1249. macaddr=AC:DE:48:88:99:AA
  1250. realnic=list
  1251.  
  1252. [fdc, primary]
  1253. # enable: Enable floppy controller interface
  1254. # pnp: List floppy controller in ISA PnP BIOS enumeration
  1255. # irq: IRQ used by floppy controller. Set to 0 for default.
  1256. # WARNING: Setting the IRQ to non-standard values will not work unless the guest OS is using the ISA PnP BIOS to detect the floppy controller.
  1257. # Setting the IRQ to one already occupied by another device or IDE controller will trigger "resource conflict" errors in Windows 95.
  1258. # Normally, floppy controllers use IRQ 6.
  1259. # io: Base I/O port for floppy controller. Set to 0 for default.
  1260. # WARNING: Setting the I/O port to non-standard values will not work unless the guest OS is using the ISA PnP BIOS to detect the IDE controller.
  1261. # Standard I/O ports are 3F0 and 370.
  1262. # dma: DMA channel for floppy controller. Set to -1 for default.
  1263. # WARNING: Setting the DMA channel to non-standard values will not work unless the guest OS is using the ISA PnP BIOS to detect the IDE controller.
  1264. # Standard DMA channel is 2.
  1265. # int13fakev86io: If set, and int13fakeio is set, certain INT 13h commands will
  1266. # cause floppy emulation to issue fake CPU I/O traps (GPF) in
  1267. # virtual 8086 mode and a fake IRQ signal. you must enable this option
  1268. # if you want 32-bit floppy access in Windows 95 to work with DOSBox.
  1269. # instant mode: If set, all floppy operations are 'instantaneous', they are carried
  1270. # out without any delay. Real hardware of course has motor, command
  1271. # and data I/O delays and so this option is off by default for realistic
  1272. # emulation.
  1273. # auto-attach to int 13h: If set, DOSBox-X will automatically attach a disk image as being
  1274. # inserted into a floppy drive attached to the controller when imgmount is used
  1275. # to mount a disk image to drive 0/1 or A/B. If not set, you must specify
  1276. # the -fdc option to imgmount to attach drive A/B to the floppy controller
  1277. # manually. You must use the -fdc option regardless if loading floppies into
  1278. # drives attached to any other FDC than the primary controller
  1279. # mode: Floppy controller mode. What the controller acts like.
  1280. # ps2 PS/2 mode (most common)
  1281. # ps2_model30 PS/2 model 30
  1282. # at AT mode
  1283. # xt PC/XT mode
  1284. # chip: Floppy controller chipset
  1285. # 82077aa Intel 82077AA chipset
  1286. # 82072 Intel 82072 chipset
  1287. # nec_uPD765 NEC uPD765 chipset
  1288. # none No chipset (For PC/XT mode)
  1289. enable=false
  1290. pnp=true
  1291. irq=0
  1292. io=0
  1293. dma=-1
  1294. int13fakev86io=false
  1295. instant mode=false
  1296. auto-attach to int 13h=true
  1297. mode=ps2
  1298. chip=82077aa
  1299.  
  1300. [ide, primary]
  1301. # enable: Enable IDE interface
  1302. # pnp: List IDE device in ISA PnP BIOS enumeration
  1303. # irq: Alternate I/O port for IDE controller (alt status, etc). Set to 0 for default.
  1304. # WARNING: Setting the I/O port to non-standard values will not work unless the guest OS is using the ISA PnP BIOS to detect the IDE controller.
  1305. # For best compatability set this value to io+0x206, for example, io=1F0 altio=3F6.
  1306. # The primary IDE controller will not claim port 3F7 if the primary floppy controller is enabled due to I/O port overlap in the 3F0-3F7 range.
  1307. # int13fakeio: If set, force IDE state change on certain INT 13h commands.
  1308. # IDE registers will be changed as if BIOS had carried out the action.
  1309. # If you are running Windows 3.11 or Windows 3.11 Windows for Workgroups
  1310. # you must enable this option (and use -reservecyl 1) if you want 32-bit
  1311. # disk access to work correctly in DOSBox.
  1312. # int13fakev86io: If set, and int13fakeio is set, certain INT 13h commands will
  1313. # cause IDE emulation to issue fake CPU I/O traps (GPF) in
  1314. # virtual 8086 mode and a fake IRQ signal. you must enable this option
  1315. # if you want 32-bit disk access in Windows 95 to work with DOSBox.
  1316. # enable pio32: If set, 32-bit I/O reads and writes are handled directly (much like PCI IDE implementations)
  1317. # If clear, 32-bit I/O will be handled as if two 16-bit I/O (much like ISA IDE implementations)
  1318. # ignore pio32: If 32-bit I/O is enabled, attempts to read/write 32-bit I/O will be ignored entirely.
  1319. # In this way, you can have DOSBox emulate one of the strange quirks of 1995-1997 era
  1320. # laptop hardware
  1321. # cd-rom spinup time: Emulated CD-ROM time in ms to spin up if CD is stationary.
  1322. # Set to 0 to use controller or CD-ROM drive-specific default.
  1323. # cd-rom spindown timeout: Emulated CD-ROM time in ms that drive will spin down automatically when not in use
  1324. # Set to 0 to use controller or CD-ROM drive-specific default.
  1325. # cd-rom insertion delay: Emulated CD-ROM time in ms that drive will report "medium not present"
  1326. # to emulate the time it takes for someone to take out a CD and insert a new one when
  1327. # DOSBox is instructed to swap or change CDs.
  1328. # When running Windows 95 or higher a delay of 4000ms is recommended to ensure that
  1329. # auto-insert notification triggers properly.
  1330. # Set to 0 to use controller or CD-ROM drive-specific default.
  1331. enable=true
  1332. pnp=true
  1333. irq=0
  1334. io=0
  1335. altio=0
  1336. int13fakeio=false
  1337. int13fakev86io=true
  1338. enable pio32=false
  1339. ignore pio32=false
  1340. cd-rom spinup time=0
  1341. cd-rom spindown timeout=0
  1342. cd-rom insertion delay=4000
  1343.  
  1344. [ide, secondary]
  1345. enable=true
  1346. pnp=true
  1347. irq=0
  1348. io=0
  1349. altio=0
  1350. int13fakeio=false
  1351. int13fakev86io=false
  1352. enable pio32=false
  1353. ignore pio32=false
  1354. cd-rom spinup time=0
  1355. cd-rom spindown timeout=0
  1356. cd-rom insertion delay=0
  1357.  
  1358. [ide, tertiary]
  1359. enable=false
  1360. pnp=true
  1361. irq=0
  1362. io=0
  1363. altio=0
  1364. int13fakeio=false
  1365. int13fakev86io=false
  1366. enable pio32=false
  1367. ignore pio32=false
  1368. cd-rom spinup time=0
  1369. cd-rom spindown timeout=0
  1370. cd-rom insertion delay=0
  1371.  
  1372. [ide, quaternary]
  1373. enable=false
  1374. pnp=true
  1375. irq=0
  1376. io=0
  1377. altio=0
  1378. int13fakeio=false
  1379. int13fakev86io=false
  1380. enable pio32=false
  1381. ignore pio32=false
  1382. cd-rom spinup time=0
  1383. cd-rom spindown timeout=0
  1384. cd-rom insertion delay=0
  1385.  
  1386. [ide, quinternary]
  1387. enable=false
  1388. pnp=true
  1389. irq=0
  1390. io=0
  1391. altio=0
  1392. int13fakeio=false
  1393. int13fakev86io=false
  1394. enable pio32=false
  1395. ignore pio32=false
  1396. cd-rom spinup time=0
  1397. cd-rom spindown timeout=0
  1398. cd-rom insertion delay=0
  1399.  
  1400. [ide, sexternary]
  1401. enable=false
  1402. pnp=true
  1403. irq=0
  1404. io=0
  1405. altio=0
  1406. int13fakeio=false
  1407. int13fakev86io=false
  1408. enable pio32=false
  1409. ignore pio32=false
  1410. cd-rom spinup time=0
  1411. cd-rom spindown timeout=0
  1412. cd-rom insertion delay=0
  1413.  
  1414. [ide, septernary]
  1415. enable=false
  1416. pnp=true
  1417. irq=0
  1418. io=0
  1419. altio=0
  1420. int13fakeio=false
  1421. int13fakev86io=false
  1422. enable pio32=false
  1423. ignore pio32=false
  1424. cd-rom spinup time=0
  1425. cd-rom spindown timeout=0
  1426. cd-rom insertion delay=0
  1427.  
  1428. [ide, octernary]
  1429. enable=false
  1430. pnp=true
  1431. irq=0
  1432. io=0
  1433. altio=0
  1434. int13fakeio=false
  1435. int13fakev86io=false
  1436. enable pio32=false
  1437. ignore pio32=false
  1438. cd-rom spinup time=0
  1439. cd-rom spindown timeout=0
  1440. cd-rom insertion delay=0
  1441.  
  1442. [autoexec]
  1443. # Lines in this section will be run at startup.
  1444. # You can put your MOUNT lines here.
  1445. imgmount c ~/Desktop/c2.img
  1446. #imgmount d -t iso ~/Desktop/stg1.iso
  1447. #imgmount e -t iso ~/Desktop/stg1.iso
  1448. boot ~/Desktop/c2.img
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement