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

Added keymapper documentation

Browse source 
Imported-from: https://svn.code.sf.net/p/dosbox/code-0/dosbox/trunk@1999
This commit is contained in:
Peter Veenstra 2004-09-28 20:11:23 +00:00
parent 6c6c6f031c
commit 4848431a5a
1 changed files with 83 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

102
README
View file

@ -25,13 +25,14 @@ INDEX:
3. Usage
4. Internal Programs
5. Special Keys
6. System Requirements
7. To run resource-demanding games
8. The config file
9. The language file
10. Building your own version of DOSBox
11. Special thanks
12. Contact
6. Keymapper
7. System Requirements
8. To run resource-demanding games
9. The config file
10. The language file
11. Building your own version of DOSBox
12. Special thanks
13. Contact
==============
@ -53,7 +54,7 @@ Q: I've got a Z instead of a C at the prompt.
Q: My CD-ROM doesn't work.
Q: The mouse doesn't work.
Q: The sound stutters.
Q: I can't type \ in DOSBox.
Q: I can't type \ or : in DOSBox.
Q: The game/application can't find its CD-ROM.
Q: The game/application runs much too slow!
Q: I would like to change the memory size/cpu speed/ems/soundblaster IRQ.
@ -101,14 +102,15 @@ A: You're using too much cpu power to keep DOSBox running at the current speed.
You can either lower the cycles or skip frames or get a faster machine.
You can also increase the prebuffer in the configfile
Q: I can't type \ in DOSBox.
Q: I can't type \ or : in DOSBox.
A: This is a known problem. It only occurs if your keyboard layout isn't US.
Some possible fixes:
1. Switch your keyboard layout.
2. Use / instead.
3. Add the commands you want to execute to dosbox.conf
4. Start the keymapper (CTRL-F1 or add -startmapper switch to dosbox)
5. for \ try the keys around enter. For : try shift and the keys between
enter and "l" (US keyboard layout).
Q: The game/application can't find its CD-ROM.
A: Be sure to mount the CD-ROM with -t cdrom switch. Also try adding the
@ -549,8 +551,70 @@ This maximum will vary from computer to computer, there is no standard.
=============
6. Keymapper:
=============
When you start the keymapper (either with CTRL-F1 or -startmapper as a
commandline argument) you are presented with a virtual keyboard.
This virtual keyboard corresponds with the keys DOSBox will report to its
applications. If you click on a key with your mouse, you can see in the
lowerleft corner which key on your keyboard corresponds with it.
Event: EVENT
BIND: BIND
Add Del
mod1 hold Next
mod2
mod3
EVENT
The key DOSBox will report to the applications being emulated.
BIND
The key on your keyboard (as reported by SDL) which is connected to the
EVENT.
mod1,2,3
Modfiers. These are keys you need to have pressed as well, while pressing
BIND. mod1 = CTRL and mod2 = ALT. These are generally only used when you
want to change the special keys of DOSBox.
Add
Add a new BIND to this EVENT. Basicly add a key from your keyboard which
will produce the key EVENT in DOSBox.
Del
Delete the BIND to this EVENT. If an EVENT has no BINDS than it's not
possible to type this key in DOSBox.
Next
Cycle through the list of keys(BINDS) which map to this EVENT.
Example:
Q1. You want to have the X on your keyboard to type a Z in DOSBox.
A. With your mouse click on the Z on the keyboard mapper. Click "Add".
Now press the X key on your keyboard.
Q2. If you click "Next" a few times you will notice that the Z on your
keyboard also produces an Z in DOSBox.
A. Therefore select the Z again and click "Next" till you have the Z on
your keyboard. Now click "Del".
Q3. If you try it out in DOSBox you will notice that pressing X makes ZX
appear.
A. The X on your keyboard is still mapped to the X as well! Click on
the X in the keyboard mapper and search with "Next" till you find the
mapped key X. Click "Del".
If you change the default mapping you can save your changes by pressing
"Save". DOSBox will save the mapping to location specified in the configfile
(mapperfile=mapper.txt). At startup DOSBox will load your mapperfile if it's
present in the configfile.
=======================
6. System requirements:
7. System requirements:
=======================
Fast machine. My guess would be pentium-2 400+ to get decent emulation
@ -562,7 +626,7 @@ it up somewhat.
===================================
7. To run resource-demanding games:
8. To run resource-demanding games:
===================================
DOSBox emulates the CPU, the sound and graphic cards, and some other
@ -593,7 +657,7 @@ to further reduce load on your CPU.
===================
8. The Config File:
9. The Config File:
===================
A config file can be generated by CONFIG.COM, which can be found on the
@ -613,9 +677,9 @@ current directory for dosbox.conf. Then it will look for ~/.dosboxrc (Linux),
=====================
9. The Language File:
=====================
======================
10. The Language File:
======================
A language file can be generated by CONFIG.COM.
Read it and you will hopefully understand how to change it.
@ -626,7 +690,7 @@ There's a language= entry that can be changed with the filename.
========================================
10. Building your own version of DOSBox:
11. Building your own version of DOSBox:
========================================
Download the source.
@ -635,7 +699,7 @@ Check the INSTALL in the source distribution.
===================
11. Special Thanks:
12. Special Thanks:
===================
Vlad R. of the vdmsound project for excellent sound blaster info.
@ -649,7 +713,7 @@ The Beta Testers.
============
12. Contact:
13. Contact:
============
See the site: