Skip to content

Commit c7df812

Browse files
committed
Update README
1 parent 2475766 commit c7df812

1 file changed

Lines changed: 22 additions & 9 deletions

File tree

README.md

Lines changed: 22 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ built for RetroArch/Libretro aiming for simplicity and ease of use.
2121
* [Gamepad mapper](#gamepad-mapper)
2222
* [3dfx Voodoo Emulation](#3dfx-voodoo-emulation)
2323
* [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)
2525
* [Cheats support](#cheats-support)
2626
* [Save states](#save-states)
2727
* [Rewind support](#rewind-support)
@@ -84,10 +84,12 @@ any CD-ROM images available they will appear as the E: drive.
8484

8585
There are two core options related to this feature:
8686

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.
9193
- `System > Advanced > Force Normal Core in OS`: If you encounter program errors or crashes inside the
9294
installed operating system, this option can be used to switch to a more compatible but slower
9395
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
125127
The X button is the middle mouse button and L2/R2 can be used to speed up or slow down mouse movement.
126128
There is also the core option `Input > Mouse Sensitivity` to increase/decrease mouse movement speed.
127129

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+
128138
### Keyboard emulation
129139
For games that don't have automated controller mappings or are not detected successfully the core will map
130140
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
143153
The cursor can be controlled with the controller (or mouse or keyboard) and L2/R2 will speed up or slow down
144154
the move speed.
145155
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.
147157

148158
The L3 button can be changed to a different button with the [Gamepad mapper](#gamepad-mapper).
149159

@@ -180,10 +190,13 @@ or connect a multiplayer game with a supported frontend (RetroArch 1.16 and newe
180190

181191
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.
182192

183-
### MIDI playback with SoundFonts
193+
### MIDI playback with SoundFonts or MT-32
184194
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.
187200

188201
### Cheats support
189202
DOSBox Pure exposes its memory for cheats in the libretro frontend.

0 commit comments

Comments
 (0)