kmoody/libretro
1
0 Fork 0
mirror of https://github.com/Abdess/retroarch_system.git synced 2026-11-04 00:53:47 -06:00
Code Issues Packages Projects Releases Wiki Activity

docs: follow the dosbox-staging clap rework

Browse Source 
Sound Canvas models are now looked up only inside the Nuked-SC55.clap library (src/midi/soundcanvas.cpp:77-93), and a generic clap MIDI device runs a user-named plugin (src/midi/clap.cpp:52-82). ROM files and hashes unchanged.
This commit is contained in:
Abdessamad Derraz committed 2026-10-26 23:10:38 +01:00
1 parent 7560564a09
commit e08dcd7014
1 file changed
+13 -7
Download Patch File Download Diff File Expand all files Collapse all files
emulators/dosbox-staging.yml
+13 -7
View File
@@ -3,8 +3,8 @@ type: standalone
core_classification: enhanced_fork core_classification: enhanced_fork
source: "https://github.com/dosbox-staging/dosbox-staging" source: "https://github.com/dosbox-staging/dosbox-staging"
upstream: "https://github.com/dosbox-staging/dosbox-staging" upstream: "https://github.com/dosbox-staging/dosbox-staging"
source_commit: "400bc406cac0b2e7cd3e5f93e34d6fb9f08c80bd" source_commit: "fa1856c057902be3e08856675d6cc1e7ffe43db6"
profiled_date: "2026-08-08" profiled_date: "2026-10-26"
core_version: "0.84.0-alpha" core_version: "0.84.0-alpha"
display_name: "DOS (DOSBox Staging)" display_name: "DOS (DOSBox Staging)"
cores: cores:
@@ -45,7 +45,7 @@ notes: |
MIDI devices that need external data are mt32, soundcanvas and fluidsynth. MIDI devices that need external data are mt32, soundcanvas and fluidsynth.
A device that fails to initialise throws, MIDI_Init warns and retries with A device that fails to initialise throws, MIDI_Init warns and retries with
mididevice = port, then disables MIDI output. Emulation continues either way. mididevice = port, then disables MIDI output. Emulation continues either way.
ref: src/midi/midi.cpp:794-850 ref: src/midi/midi.cpp:803-859
MT-32/CM-32L: libmt32emu identifies every candidate by file size then SHA1, MT-32/CM-32L: libmt32emu identifies every candidate by file size then SHA1,
so file names carry no meaning. A directory scan caches which ROM ids each so file names carry no meaning. A directory scan caches which ROM ids each
@@ -76,15 +76,21 @@ notes: |
directory candidates, canonicalises the ones that exist and exports them as directory candidates, canonicalises the ones that exist and exports them as
SOUNDCANVAS_ROM_PATH. The plugin appends the per-model subdirectory, hashes SOUNDCANVAS_ROM_PATH. The plugin appends the per-model subdirectory, hashes
every file under 4 MB it finds there and matches SHA256 against its table. every file under 4 MB it finds there and matches SHA256 against its table.
ref: src/midi/soundcanvas.cpp:326-373, src/misc/support.cpp:351-379, ref: src/midi/soundcanvas.cpp:254-301, src/misc/support.cpp:351-379,
Nuked-SC55-CLAP nuked_sc55.cpp:117-215, Nuked-SC55-CLAP nuked_sc55.cpp:117-215,
Nuked-SC55-CLAP rom_loader.cpp:32-63, Nuked-SC55-CLAP rom_loader.cpp:32-63,
Nuked-SC55-CLAP rom_io.cpp:271-564 Nuked-SC55-CLAP rom_io.cpp:271-564
soundcanvas_model = auto resolves sc55_121, sc55_120, sc55_110, sc55_100, soundcanvas_model = auto resolves sc55_121, sc55_120, sc55_110, sc55_100,
sc55_200, sc55mk2_101, sc55mk2_100 in that order by matching plugin names. sc55_200, sc55mk2_101, sc55mk2_100 in that order, each looked up by plugin
name inside the plugin library file Nuked-SC55.clap only.
The plugin publishes six descriptors: SC-55 v1.00, v1.10, v1.20, v1.21, The plugin publishes six descriptors: SC-55 v1.00, v1.10, v1.20, v1.21,
v2.00 and SC-55mk2 v1.01. v2.00 and SC-55mk2 v1.01.
ref: src/midi/soundcanvas.cpp:55-71, 80-147, Nuked-SC55-CLAP plugin.cpp:23-90 ref: src/midi/soundcanvas.cpp:52-68, 77-138, Nuked-SC55-CLAP plugin.cpp:23-90
mididevice = clap runs a CLAP synthesizer plugin the user names with
clap_library or clap_plugin in the [clap] section, from the same plugins
directories. It is chosen by configuration and identified by name only.
ref: src/midi/clap.cpp:52-82
FluidSynth: the soundfont setting names a file, tried as given and with .sf2 FluidSynth: the soundfont setting names a file, tried as given and with .sf2
appended, in soundfont_dir, then in the platform locations. Those are appended, in soundfont_dir, then in the platform locations. Those are
@@ -96,7 +102,7 @@ notes: |
SoundFont name from the RIFF INFO chunk and the stem of the file, symbolic SoundFont name from the RIFF INFO chunk and the stem of the file, symbolic
links resolved, select reverb, chorus and filter presets for four known links resolved, select reverb, chorus and filter presets for four known
banks. banks.
ref: src/midi/fluidsynth.cpp:107-230, 673-690, 776-843, 1058-1081 ref: src/midi/fluidsynth.cpp:107-230, 672-689, 756-823, 1038-1061
Bundled data ships with the program and is read from the resources directory Bundled data ships with the program and is read from the resources directory
next to the executable: FreeDOS codepages and keyboard layouts, translations, next to the executable: FreeDOS codepages and keyboard layouts, translations,