Files
86Box-docs/settings/sound.rst
2025-08-27 03:21:11 -05:00

62 lines
3.7 KiB
ReStructuredText

.. include:: /include.rst
|sound| Sound
=============
The **Sound** page contains settings related to the emulated machine's audio hardware.
Parallel port sound devices such as the **Disney Sound Source** and **Covox Speech Thing** are not present on this page; they can be configured through the :ref:`Ports page <settings/ports:LPT1-4 Device>`.
Sound card #1-#4
----------------
Sound cards to emulate. Up to 4 different sound cards are supported. Only cards supported by the machine's expansion buses will be listed. On machines equipped with an on-board sound chip, the *Internal device* option for sound card #1 enables the on-board sound.
The *Configure* button opens a new window with settings specific to the selected sound card, such as the I/O ports, IRQ and DMA channels for ISA cards.
Emulation for the Yamaha OPL series of synthesizers (used by many of the emulated cards) is provided by a modified `Nuked OPL3 <https://github.com/nukeykt/Nuked-OPL3>`_ or `ymfm <https://github.com/aaronsgiles/ymfm>`_ library, per the :ref:`selection below <settings/sound:FM synth driver>`. MOS Technology 6581 SID emulation for the Innovation SSI-2001 and The Entertainer is provided by the reSIDfp component of the `libsidplayfp <https://github.com/libsidplayfp/libsidplayfp>`_ library. General Instrument AY-3-8913 emulation for the Mindscape Music Board is provided by the `Ayumi <http://sovietov.com/app/ayumi/ayumi.html>`_ library.
You can also select an external OPL sound card by choosing the sound cards that have **(External Device)** at the end of their name.
See more information in the :ref:`External OPL audio device documentation </hardware/externalopl:External OPL Audio Support>`.
MIDI Out Device
---------------
Device to output MIDI music to, for sound cards equipped with an external MIDI output.
* **None:** don't output MIDI music.
* **FluidSynth:** a software soundfont synthesizer. Selecting a soundfont file is required; there will be no synthesizer output if no soundfont is configured.
* **Roland MT-32**/**CM-32L Emulation:** emulate a Roland synthesizer module. Emulation is provided by the `Munt <http://munt.sourceforge.net>`_ library.
* **System MIDI:** output to a MIDI device on the host system, such as the Windows software synthesizer or a USB MIDI adapter.
The *Configure* button opens a new window with settings specific to the selected output device, such as the soundfont to use for *FluidSynth* and the host MIDI device to use for *System MIDI*.
MIDI In Device
--------------
Device to receive MIDI music from, for sound cards equipped with an external MIDI input.
* **None:** don't receive MIDI music.
* **System MIDI:** receive from a MIDI device on the host system, such as a USB MIDI adapter.
The *Configure* button opens a new window with settings specific to the selected input device, such as the host MIDI device to use for *System MIDI*.
Standalone MPU-401
------------------
Emulate a standalone **Roland MIDI Processing Unit** ISA card, which allows for MIDI input and output without a MPU-401-equipped sound card, and for running the few applications which require *intelligent mode* capability.
The I/O port and IRQ can be configured through the *Configure* button.
Use FLOAT32 sound
-----------------
Use the 32-bit floating point (instead of 16-bit integer) data type for audio output, which is less prone to clipping but may not work at all on some host systems. Try disabling this if you're getting no audio output from 86Box at all.
FM synth driver
---------------
Yamaha OPL2/3 emulation back-end to use. **Nuked** is the default, while **YMFM** may improve emulation performance at the cost of accuracy.
.. note:: **YMFM** is always used for OPL4 emulation on sound cards equipped with that synthesizer.