Difference between revisions of "Mapper"

From DOSBoxWiki
Jump to navigationJump to search
(we needed this in the Wiki, an explanation of the keymapper functionality)
 
Line 13: Line 13:
  
 
Q1. You want to have the X on your keyboard to type a Z in DOSBox.
 
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.
+
     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.
 
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".
+
     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.
 
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".
+
    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.
 
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.

Revision as of 13:17, 4 April 2008

Keymapper

When you start the keymapper (either with CTRL-F1 or -startmapper as a commandline argument to the DOSBox executable) 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: 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: Modifiers. 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.

Examples

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.