n0p's home page
  (http://n0p.8bit.fm) Mirror
I need
your help!

Start > DOSBox PPC > DOSBox 0.63 > Creating toolbars

How to create custom toolbars - by Si Griffin si_griffin(at)yahoo(dot)com

Quick Reference:

Size: Change the size of the key mapper.
Fine: Move the key mapper one pixel at a time.
Step: Move the key mapper in units determined by size.
Render: Saves the selected key at the position of the key mapper.
Load Bitmap: Load your pre-created toolbar image.
Load Map: Load a previously saved toolbar map.
Save Map: Save the current toolbar map.
Save Toolbar: Create a toolbar from the current bitmap and toolbar map.
Lock: The current key will lock when pressed (useful for Shift and Ctrl)
Scrollable area: Select which key you wish to map.


Creating a Toolbar :

1. Using the art package of your choice, create the bitmap image to be used in
DOSBox PPC. It should be 320 pixels wide. The portion of the screen set aside for
the toolbar is 40 pixels high. You can create taller toolbars, but these will either
need to be scrollable or will obstruct the screen in forced keyboard mode.

2. Load the bitmap image into tbedit.

3. From the list on the right select the key you wish to map.

4. Drag the key mapper so that its top left corner is alligned with the top left corner
of the key to be mapped (use the Fine movement buttons as necessary).

5. Use the Size buttons to set the key mapper to the size of the key to be mapped.

6. Click Render.

7. Repeat steps 3-6 until the entire toolbar is mapped.

8. Click Save Map (important if you wish to change the bitmap later without having to
remap the whole toolbar!).

9. Click Save Toolbar and save it as game.dbk

10. Move the new game.dbk to the directory containing the DOSBox exe on your PDA
(remembering to back up the existing game toolbar first!).

11. Access your toolbar by clicking on the next toolbar button on the default DOSBoxPPC
keyboard (the arrow on the right hand side).

Hints and Tips:

* The Step buttons are ideal for moving to adjacent keys.
* Remember to include a next or previous toolbar key if you wish to get back to the
default keyboard.

Special Keycodes:

KBD_CCI - increase cycles
KBD_CCD - decrease cycles.
KBD_IFS - increase frameskip.
KBD_DFS - decrease frameskip.
KBD_LMC left mouse button.
KBD_RMC- right mouse button.
KBD_MMC middle mouse button.
KBD_NT next toolbar.
KBD_PT prev. toolbar.
KBD_EXIT exit.
KBD_SC scrollbar area.