Keyboard Plus Plus Files

Kpp 1.2

Foreword.
I do not know how to program in C, so forgive me for inefficiencies of my software.

What is used for?
If you plan to put an emulator of personal computer in an arcade cabinet or a mediacenter very often you do not have a keyboard available.
Many ZxSpectrum C64 amiga etc games require the pressure of a "x" button to activate the joystick and pressing another button to start playing.
KPP was developed to solve this problem.
Staying in a comfortable chair by pressing a button on the joypad you can simulate the necessary keystrokes.


Start Kpp
Run the emulator in full screen.

Pressing Button 3 joystick change the emulator to windowed mode and keyboard appear.
You move the selection with joystick and with the pressure of button 1 you will simulate keystroke.
Button 2 hold down the key (usefull for simulate shift + something)
Pressing the 3rd butt exit from keyboard mode and come back to fullscreen.

Emulators supported:
ZXSpin
EmuZWin
Vice
Hoxs64
Stella
FS-UAE (hope soon!)
WinUAE

Paramteri riga di comando:

kpp -kill chiude il programma.

CONFIG
Go in tray area and right click on kpp icon and select config.
here you can config the Joy port the press button the hold button and the activate button.
Exit:
No:		always running
If no emu: 	exit only if when run there is no emu running
After v:	exit when there is no emulator only after that 
		the emulator was run one time (not yet supported)

Force res:
No:		Show the picture at his resolution 	
Auto:		Not yet implemented
xxxx:		show at xxxx resolution

Fade:	fade in and fade out of the keyboard
Transparency: Set transparency keyboard
Use pow. Use joypad pow to move instead joystick.
Remember key remember last key selected

Emulators
Emu:	Just the emulator name
Class:	The class name of the emulator window (you can find with spy++ from visual studio 2010 express or similar tools)
Keyboard: the keyboard layout file for this emu.

Keyboard keyb file structure

ZXSpin
a,2,012,037,054,036
b,4,088,037,142,037,142,073,088,073
VK_RETURN,6,572,261,665,261,665,174,604,174,604,217,572,217
ENDKEYB
BMP=Keyboards\Amiga500.bmp
SWITCH=VK_LCONTROL&VK_F12

Explanation:
line 1 	is name of the emu
line 2 	example of definition of one key with 2 points:
	a is the key
	2 is the number of points
	012,037 is the coords ot the bottom left point
	054,036 is widht and heigt.
	this is the most used format more quick you just need 
	to change coords if all the keys are similar
line 3	example of defintion of one ky with 4 points
	b is the key
	4 is the number of points
	088,037,142,037,142,073,088,073 are the coords
	of all 4 points
line 4	example of defintion of one ky with 6 points
	usefull for return key
line 5	ENDKEYB needed to say that the definition of keys is finished
line 6	BMP=Keyboards\Amiga500.bmp image of the keyboard
line 7 	SWITCH=VK_LCONTROL&VK_F12 scancode for fullscreen switch


here some example of scancode are similar to the win32 one
with some differences
VK_ESC  instead of VK_ESCAPE
VK_LALT instead of VK_LMENU
VK_RALT instead of VK_RMENU
VK_CAPS instead of VK_CAPITAL

here some example for "non developers"
VK_RETURN
VK_LSHIFT
VK_LCONTROL
VK_ESC
VK_LCONTROL&VK_F12
MK_VK_LALT&VK_F4
VK_LALT&VK_RETURN


To Do.
Add others emulators
Add other methods to identify emulator (Caption or process name)
Add autofit to Force Res
Add jpg and png

Enrico Antongiovanni
enry@inwind.it

Thanks:

Dr. Alessandro Pedretti:
Consulence and optimization.

Dr. Roberto Cordone:
For second Cordon's theorem.