You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+22-9Lines changed: 22 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@ built for RetroArch/Libretro aiming for simplicity and ease of use.
21
21
*[Gamepad mapper](#gamepad-mapper)
22
22
*[3dfx Voodoo Emulation](#3dfx-voodoo-emulation)
23
23
*[Multiplayer](#multiplayer)
24
-
*[MIDI playback with SoundFonts](#midi-playback-with-soundfonts)
24
+
*[MIDI playback with SoundFonts or MT-32](#midi-playback-with-soundfonts-or-mt-32)
25
25
*[Cheats support](#cheats-support)
26
26
*[Save states](#save-states)
27
27
*[Rewind support](#rewind-support)
@@ -84,10 +84,12 @@ any CD-ROM images available they will appear as the E: drive.
84
84
85
85
There are two core options related to this feature:
86
86
87
-
-`System > Advanced > Discard Disk Modifications`: If set, while running an installed operating system,
88
-
modifications to the C: drive will not be saved permanently. This allows the content to be closed any
89
-
time without worry of file system or registry corruption. Make sure to finish setting up the OS
90
-
by setting the screen resolution and installing device drivers first before setting this option.
87
+
-`System > Advanced > OS Disk Modifications`: When running an installed operating system, modifications
88
+
to the C: drive will be made on the disk image by default. Setting it to 'Discard' will never save any
89
+
changes made on C: but allows the content to be closed any time without worry of file system or registry
90
+
corruption. The third option 'Save Difference Per Content' will store any changes made to the C: drive
91
+
into a file in the frontends save directory, but the OS disk image must never be modified again once used,
92
+
otherwise existing differences become unusable.
91
93
-`System > Advanced > Force Normal Core in OS`: If you encounter program errors or crashes inside the
92
94
installed operating system, this option can be used to switch to a more compatible but slower
93
95
mode. The option can be toggled on and off as needed.
@@ -125,6 +127,14 @@ For the right stick the shoulder buttons L/R will be used as left/right mouse bu
125
127
The X button is the middle mouse button and L2/R2 can be used to speed up or slow down mouse movement.
126
128
There is also the core option `Input > Mouse Sensitivity` to increase/decrease mouse movement speed.
127
129
130
+
The behavior of a real mouse or touch screen can be controlled by the `Input > Mouse Input Mode` option.
131
+
- Virtual mouse (default) (best used when the frontend [grabs the mouse input](#playing-with-keyboard-and-mouse))
132
+
- Direct controlled mouse (not supported by all games)
133
+
- Touchpad mode (drag to move, tap to click, etc., best for touch screens)
134
+
- Off (ignore mouse/touch inputs)
135
+
136
+
In Windows 3.x it is possible to use [this driver](https://github.com/NattyNarwhal/vmwmouse) for direct controlled mouse support.
137
+
128
138
### Keyboard emulation
129
139
For games that don't have automated controller mappings or are not detected successfully the core will map
130
140
generic keyboard keys to all buttons. Use the "Controller Mapper" screen in the start menu or the
@@ -143,7 +153,7 @@ By pressing L3 on the gamepad (usually by pushing in the left analog stick) the
143
153
The cursor can be controlled with the controller (or mouse or keyboard) and L2/R2 will speed up or slow down
144
154
the move speed.
145
155
If the cursor is moved above the middle of the screen the keyboard will move to the top.
146
-
The button can be remapped in the controls menu and there is also a core options to disable it entirely.
156
+
The button can be remapped in the controls menu and there is also a core option to disable it entirely.
147
157
148
158
The L3 button can be changed to a different button with the [Gamepad mapper](#gamepad-mapper).
149
159
@@ -180,10 +190,13 @@ or connect a multiplayer game with a supported frontend (RetroArch 1.16 and newe
180
190
181
191
To use the NE2000 card make sure to configure the Windows 95/98 driver to use base address port set to 0x300 and base IRQ set to 10.
182
192
183
-
### MIDI playback with SoundFonts
193
+
### MIDI playback with SoundFonts or MT-32
184
194
If DOSBox Pure finds one or more `.SF2` sound font file in the `system` directory of the frontend, one of them
185
-
can be selected via the `Audio > MIDI SoundFont` core option.
186
-
This sound font will then be used to play General Midi and Sound Canvas music.
195
+
can be selected via the `Audio > MIDI SoundFont` core option. This sound font will then be used to play General Midi and Sound Canvas music.
196
+
197
+
If the `system` directory contains a pair of `_control.rom` and `_pcm.rom` files, an MT-32 synthesizer can be emulated with them.
198
+
199
+
Alternatively if the content mounted to the C: drive contains a file named DOSBOX.SF2 or MT32_CONTROL.ROM/MT32_PCM.ROM, it will be used as a per-game override to the core option.
187
200
188
201
### Cheats support
189
202
DOSBox Pure exposes its memory for cheats in the libretro frontend.
0 commit comments