valter/dosbox-staging
1
0
Fork 0
Code Releases Activity

Add and document KeyMapper reloading

Browse source 
This is accomplished by clearing all the binds on the events, and
then re-parsing the file.

This allows batch scripts to change keybindings, and is useful for DOS
game menus, who can now change the mappings per-game.
ie: config -set sdl mapperfile=~/.dosbox/mario-and-luigi.map
or: config -r -conf ~/.dosbox/mario-and-luigi.conf
(with a mapperfile=mario-and-luigi.map line in mario-and-luigi.conf)

Warning: Because internal changes don't have access to the
current_config_path, paths set with config -set are relative to the
CWD. Relevant source lines are src/misc/setup.cpp lines 349 and 917

I'm unsure if this interacts well with the CAPS and NUMLOCK code at the
bottom of MAPPER_Init, as those now get run every time the mapper
reloads. If it does misbehave, those if statements can probably be
moved to the MAPPER_StartUp function, although it is called a bit earlier
than MAPPER_Init.

A natural extension of this would be to add the ability to change the
mapperfile from within the MAPPER UI.
This commit is contained in:
Nopey Nope 2020-01-30 10:27:03 -08:00 • committed by Patryk Obara
parent 2363ef9178
commit 7dbf5cece4
2 changed files with 38 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

18
README
View file

@ -712,23 +712,25 @@ CONFIG -get "section property"
config -set "cpu cycles=10000"
3. To turn EMS memory emulation off:
config -set "dos ems=false"
4. To check which cpu core is being used.
4. To change the key mappings
config -set "sdl mapperfile=/path/to/mapper-file.map"
5. To check which cpu core is being used.
config -get "cpu core"
5. To view the list of possible cpu cores:
6. To view the list of possible cpu cores:
config -help cpu core
6. To change the machine type and restart:
7. To change the machine type and restart:
config -set "machine cga"
config -wc -r
7. To configure the autoexec section to auto-mount a directory at start:
8. To configure the autoexec section to auto-mount a directory at start:
config -axadd "mount c c:\dosgames" "c:"
config -wc
8. To create a specific config file in the config directory:
9. To create a specific config file in the config directory:
config -set "dos ems=false"
config -set "cpu cycles=10000"
config -set "core dynamic"
config -axadd "mount c c:\dosgames" "c:" "cd my_game" "my_game"
config -wc my_config.conf
9. To restart DOSBox from a specific config file in the config directory:
10. To restart DOSBox from a specific config file in the config directory:
config -r -conf my_config.conf
LOADFIX [-size] [program] [program-parameters]
@ -1207,6 +1209,10 @@ the configuration file (the mapperfile= entry). At startup, DOSBox will load
your mapperfile, if it is present in the DOSBox configuration file.
Additionally, the mapperfile configuration entry can by changed with the CONFIG
program, and will take effect immediately.
config -set "sdl mapperfile=/path/to/mapper-file.map"
===================
8. Keyboard Layout: