From 4848431a5abfc3e611911865dd621be311cc5a97 Mon Sep 17 00:00:00 2001 From: Peter Veenstra Date: Tue, 28 Sep 2004 20:11:23 +0000 Subject: [PATCH] Added keymapper documentation Imported-from: https://svn.code.sf.net/p/dosbox/code-0/dosbox/trunk@1999 --- README | 102 ++++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 83 insertions(+), 19 deletions(-) diff --git a/README b/README index 9f528b1f..4779335f 100644 --- a/README +++ b/README @@ -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: