GE - Revision history

Matlo at 14:38, 10 June 2016

2016-06-10T14:38:29Z

Matlo: /* Run the test */

2015-05-16T10:01:46Z

‎Run the test

Matlo: /* Build the test */

2015-05-16T10:01:28Z

‎Build the test

Matlo: /* Build the static library */

2014-09-03T10:39:31Z

‎Build the static library

Matlo: /* The GIMX Event Library */

2014-09-03T10:39:11Z

‎The GIMX Event Library

Matlo: /* The GIMX Event Library */

2014-08-04T15:44:08Z

‎The GIMX Event Library

Matlo: /* Example */

2014-08-04T15:29:32Z

‎Example

Matlo at 13:31, 23 May 2014

2014-05-23T13:31:47Z

Matlo: /* Build the test */

2013-11-25T21:38:01Z

‎Build the test

Matlo: /* Run the test */

2013-11-25T21:37:53Z

‎Run the test

← Older revision		Revision as of 14:38, 10 June 2016
Line 1:		Line 1:
		+	'''Warning: this page is outdated. The GIMX Event Library is superseded by the [[gasync]] library.'''
		+
	=The GIMX Event Library=		=The GIMX Event Library=

@@ Line 59: / Line 59: @@
 ==Run the test==
-  cd ~/GIMX/event/test
+  cd ~/GIMX/shared/event/test
   ./GE_test
 The test displays all keyboards, mice and joysticks, and it then displays all input events.
 Press Escape or Ctrl+c to exit.

@@ Line 55: / Line 55: @@
 ==Build the test==
-  cd ~/GIMX/event/test
+  cd ~/GIMX/shared/event/test
   make

@@ Line 50: / Line 50: @@
 ==Build the static library==
   cd ~
-  git clone -b dev --single-branch --depth 1 <nowiki>https://github.com/matlo/GIMX.git</nowiki>
+  git clone -b master --single-branch --depth 1 <nowiki>https://github.com/matlo/GIMX.git</nowiki>
   cd GIMX/shared/event
   make

@@ Line 3: / Line 3: @@
 GE is a cross-platform event library for handling input from keyboards, mice, and joysticks.<br />
 It can be used in Windows or Linux.<br />
-It is released under the [http://www.gnu.org/licenses/gpl.html GPLv3 license] and is available in the [https://github.com/matlo/GIMX/tree/dev/shared/event GIMX git repository].<br />
+It is released under the [http://www.gnu.org/licenses/gpl.html GPLv3 license] and is available in the [https://github.com/matlo/GIMX GIMX git repository].<br />
 GE supports multiple mice, keyboards and joysticks, which means the source of each event can be identified.<br />
 In Linux, it interfaces with [http://en.wikipedia.org/wiki/Evdev evdev] or [http://en.wikipedia.org/wiki/X.Org_Server X], and allows to write "interrupt-based" event processing.<br />
 In Windows, it interfaces with the RawInput API or the SDL library to get keyboard and mouse events. To get joystick events it uses the SDL 2.0 library, which handles standard joysticks and Xinput gamepads. RawInput event processing is "interrupt-based", whereas SDL 2.0 event processing is "polling-based".<br />
-This page only gives a pseudo-code example. Check the [https://github.com/matlo/GIMX/tree/dev/shared/event/test/ test directory] for a complete example.
+This page only gives a pseudo-code example. Check the [https://github.com/matlo/GIMX/tree/master/shared/event/test/ test directory] for a complete example.
 To use GE in Linux, make sure to have [[Development_on_Linux#Set_Input_Device_Permissions_.28required_since_r1277.29|read access to the input devices]].

@@ Line 23: / Line 23: @@
    int main(int argc, char* argv[])
+   {
-     if (!GE_initialize())
+     if (!GE_initialize(GE_MKB_SOURCE_PHYSICAL)) //or GE_MKB_SOURCE_WINDOW_SYSTEM
+     {
        //handle the error

@@ Line 3: / Line 3: @@
 GE is a cross-platform event library for handling input from keyboards, mice, and joysticks.<br />
 It can be used in Windows or Linux.<br />
-It is released under the [http://www.gnu.org/licenses/gpl.html GPLv3 license] and is available in the [https://github.com/matlo/GIMX/tree/master/shared/event GIMX git repository].<br />
+It is released under the [http://www.gnu.org/licenses/gpl.html GPLv3 license] and is available in the [https://github.com/matlo/GIMX/tree/dev/shared/event GIMX git repository].<br />
 GE supports multiple mice, keyboards and joysticks, which means the source of each event can be identified.<br />
 In Linux, it directly interfaces with [http://en.wikipedia.org/wiki/Evdev evdev], and allows to write "interrupt-based" event processing.<br />
-In Windows, it uses a modified SDL library, and allows to write "polling-based" event processing.<br />
+In Windows, it interfaces with the RawInput API to get keyboard and mouse events. To get joystick events it uses the SDL 2.0 library, which handles standard joysticks and Xinput gamepads. RawInput event processing is "interrupt-based", whereas SDL 2.0 event processing is "polling-based".<br />
-This page only gives pseudo-code examples. Check the [https://github.com/matlo/GIMX/tree/master/shared/event/test/ test directory] to read complete examples.
+This page only gives a pseudo-code example. Check the [https://github.com/matlo/GIMX/tree/dev/shared/event/test/ test directory] for a complete example.
 To use GE in Linux, make sure to have [[Development_on_Linux#Set_Input_Device_Permissions_.28required_since_r1277.29|read access to the input devices]].
-==Interrupt-driven, with periodic task==
+=Example=
    #include <GE.h>
@@ Line 30: / Line 28: @@
+     }
-    struct timespec period = {.tv_sec = 0, .tv_nsec = 10000000};
+     GE_TimerStart(10000); //microseconds
      GE_SetCallback(process_event);
-     while(!done)
+     GE_grab(); //grab the mouse pointer
      while(!done)
+     {
-      t0 = get_time();
+       GE_PumpEvents();//returns when timer fires
        //do something periodically
+     }
@@ Line 129: / Line 50: @@
 ==Build the static library==
   cd ~
-  git clone -b master --single-branch --depth 1 <nowiki>https://github.com/matlo/GIMX.git</nowiki>
+  git clone -b dev --single-branch --depth 1 <nowiki>https://github.com/matlo/GIMX.git</nowiki>
   cd GIMX/shared/event
   make
@@ Line 138: / Line 59: @@
 ==Run the test==
   cd ~/GIMX/event/test
-  ./windows_test
+  ./GE_test
 The test displays all keyboards, mice and joysticks, and it then displays all input events.
 Press Escape or Ctrl+c to exit.