From b278e8b1013c5012de214b7a4efef555ef7dd94c Mon Sep 17 00:00:00 2001
From: mcmartin <mcmartin@8092fc87-c524-0410-9efc-e669fe64eaf9>
Date: Tue, 15 Oct 2002 10:47:06 +0000
Subject: [PATCH] Extremely basic "key jammer", mostly lifted from SDL docs.

git-svn-id: svn://svn.code.sf.net/p/sc2/code/trunk@124 8092fc87-c524-0410-9efc-e669fe64eaf9
---
 tools/keys/Makefile   |   5 ++
 tools/keys/keyjam.c   | 120 ++++++++++++++++++++++++++++++++++++++++++
 tools/keys/keyjam.txt |  10 ++++
 3 files changed, 135 insertions(+)
 create mode 100644 tools/keys/Makefile
 create mode 100644 tools/keys/keyjam.c
 create mode 100644 tools/keys/keyjam.txt

diff --git a/tools/keys/Makefile b/tools/keys/Makefile
new file mode 100644
index 000000000..6dbea7f4c
--- /dev/null
+++ b/tools/keys/Makefile
@@ -0,0 +1,5 @@
+all: keyjam.c
+	gcc `sdl-config --cflags` `sdl-config --libs` -o keyjam keyjam.c
+
+clean:
+	rm -f keyjam
diff --git a/tools/keys/keyjam.c b/tools/keys/keyjam.c
new file mode 100644
index 000000000..bb875f45b
--- /dev/null
+++ b/tools/keys/keyjam.c
@@ -0,0 +1,120 @@
+#include "SDL.h"
+
+/* Function Prototypes */
+void PrintKeyInfo( SDL_KeyboardEvent *key );
+void PrintModifiers( SDLMod mod );
+
+    /* main */
+int main( int argc, char *argv[] ){
+        
+    SDL_Event event;
+    int quit = 0;
+        
+    /* Initialise SDL */
+    if( SDL_Init( SDL_INIT_VIDEO ) < 0){
+	fprintf( stderr, "Could not initialise SDL: %s\n", SDL_GetError() );
+	exit( -1 );
+    }
+
+    /* Set a video mode */
+    if( !SDL_SetVideoMode( 320, 200, 0, 0 ) ){
+	fprintf( stderr, "Could not set video mode: %s\n", SDL_GetError() );
+	SDL_Quit();
+	exit( -1 );
+    }
+
+    /* Enable Unicode translation */
+    SDL_EnableUNICODE( 1 );
+
+    /* Loop until an SDL_QUIT event is found */
+    while( !quit ){
+
+	/* Poll for events */
+	while( SDL_PollEvent( &event ) ){
+                
+	    switch( event.type ){
+		/* Keyboard event */
+		/* Pass the event data onto PrintKeyInfo() */
+	    case SDL_KEYDOWN:
+	    case SDL_KEYUP:
+		PrintKeyInfo( &event.key );
+		break;
+
+		/* SDL_QUIT event (window close) */
+	    case SDL_QUIT:
+		quit = 1;
+		break;
+
+	    default:
+		break;
+	    }
+
+	}
+
+    }
+
+    /* Clean up */
+    SDL_Quit();
+    exit( 0 );
+}
+
+/* Print all information about a key event */
+void PrintKeyInfo( SDL_KeyboardEvent *key ){
+    /* Is it a release or a press? */
+    if( key->type == SDL_KEYUP )
+	printf( "Release:- " );
+    else
+	printf( "Press:- " );
+
+    /* Print the hardware scancode first */
+    printf( "Scancode: 0x%02X", key->keysym.scancode );
+    /* Print the name of the key */
+    printf( ", Name: %s", SDL_GetKeyName( key->keysym.sym ) );
+    /* We want to print the unicode info, but we need to make */
+    /* sure its a press event first (remember, release events */
+    /* don't have unicode info                                */
+    if( key->type == SDL_KEYDOWN ){
+	/* If the Unicode value is less than 0x80 then the    */
+	/* unicode value can be used to get a printable       */
+	/* representation of the key, using (char)unicode.    */
+	printf(", Unicode: " );
+	if( key->keysym.unicode < 0x80 && key->keysym.unicode > 0 ){
+	    printf( "%c (0x%04X)", (char)key->keysym.unicode,
+		    key->keysym.unicode );
+	}
+	else{
+	    printf( "? (0x%04X)", key->keysym.unicode );
+	}
+    }
+    printf( "\n" );
+    /* Print modifier info */
+    PrintModifiers( key->keysym.mod );
+}
+
+/* Print modifier info */
+void PrintModifiers( SDLMod mod ){
+    printf( "Modifers: " );
+
+    /* If there are none then say so and return */
+    if( mod == KMOD_NONE ){
+	printf( "None\n" );
+	return;
+    }
+
+    /* Check for the presence of each SDLMod value */
+    /* This looks messy, but there really isn't    */
+    /* a clearer way.                              */
+    if( mod & KMOD_NUM ) printf( "NUMLOCK " );
+    if( mod & KMOD_CAPS ) printf( "CAPSLOCK " );
+    if( mod & KMOD_LCTRL ) printf( "LCTRL " );
+    if( mod & KMOD_RCTRL ) printf( "RCTRL " );
+    if( mod & KMOD_RSHIFT ) printf( "RSHIFT " );
+    if( mod & KMOD_LSHIFT ) printf( "LSHIFT " );
+    if( mod & KMOD_RALT ) printf( "RALT " );
+    if( mod & KMOD_LALT ) printf( "LALT " );
+    if( mod & KMOD_CTRL ) printf( "CTRL " );
+    if( mod & KMOD_SHIFT ) printf( "SHIFT " );
+    if( mod & KMOD_ALT ) printf( "ALT " );
+    printf( "\n" );
+}
+
diff --git a/tools/keys/keyjam.txt b/tools/keys/keyjam.txt
new file mode 100644
index 000000000..d1b146937
--- /dev/null
+++ b/tools/keys/keyjam.txt
@@ -0,0 +1,10 @@
+This is a lightly adapted version of the SDL documentation's example
+of keyboard access.  It may be used to determine Key Jamming
+information.
+
+It will spawn a little window, then give information in the console.
+To exit the program, close the little window.
+
+Obvious enhancements to this will be to have the little window *be*
+the key jamming interface, and a KEYS.EXE-like real-time status
+report.