remogatto-ffi-swig-generator 0.1.0

data/.gitignore

@@ -0,0 +1,8 @@
+pkg/
+generated/
+*.gem
+*.xml
+*#
+.#*
+announcement.txt
+

data/History.txt

@@ -0,0 +1,25 @@
+== 0.2.1 / 2009-03-06
+
+* 1 minor enhancement
+  * Removed old lib/ffi-generator.rb file.
+
+== 0.2.0 / 2009-03-05
+
+* 1 major enhancement
+  * Added support for callbacks.
+  * Changed the package name from ffi-generator to ffi-swig-generator
+
+* 1 minor enhancement
+  * C functions with one void argument are correctly generated as FFI
+    functions with no arguments.
+
+== 0.1.0 / 2009-02-16
+
+* a bunch of minor fixes
+  * fix the gem build process
+  * new interface file for the wiiuse example
+
+== 0.0.1 / 2009-02-13
+
+* 1 major enhancement
+  * Birthday!

data/README.rdoc

@@ -0,0 +1,99 @@
+ffi-swig-generator
+    by Andrea Fazzi
+    http://github.com/remogatto/ffi-swig-generator/tree/master
+
+== DESCRIPTION:
+
+ffi-swig-generator is a ruby-ffi wrapper code generator based on SWIG
+interface files.
+
+ffi-swig-generator is able to traverse a XML parse tree file generated
+by the +swig+ command and to produce a ruby-ffi interface file from
+it.
+
+ffi-swig-generator is shipped with a command line tool (ffi-gen) and a rake
+task that automates the code generation process.
+
+ffi-swig-generator XML capabilities are provided by nokogiri.
+
+== FEATURES/PROBLEMS:
+
+* The program is able to generate:
+  * all C native types
+  * #define constants
+  * typedefs
+  * struct, union, array and enum types
+  * callbacks (pointers to functions) 
+* Naive indentation of the generated code
+
+== SYNOPSIS:
+
+From command line:
+
+  ffi-gen mylib.xml mylib.rb
+
+From a Rakefile:
+
+  require 'ffi-swig-generator'
+  FFI::Generator::Task.new :input_fn => 'my_interface_dir/*.i' output_dir => 'my_output_dir'
+
+== REQUIREMENTS:
+
+* rake >= 0.8.3
+* nokogiri >= 1.1.1
+* swig >= 1.3
+
+== DOWNLOAD/INSTALL:
+
+To download and install the gem from github:
+
+  [sudo] gem sources -a http://gems.github.com
+  [sudo] gem install remogatto-ffi-swig-generator
+
+To download the develpment trunk:
+
+  git clone git://github.com/remogatto/ffi-swig-generator.git
+
+== EXAMPLES:
+
+See the examples in examples/ folder.
+
+libc.i is an interface file containing some excerpt of libc functions.
+
+wiiuse.i is a enough complex example of a C header file interface. It
+reproduces the content of wiiuse.h, the header file of the wiiuse
+library. wiiuse is a C library that handles the connection with
+Nintendo Wiimote devices. The interface file is almost a mere
+copy/paste from the original header file.
+
+== QUICK START:
+
+  git clone git://github.com/remogatto/ffi-swig-generator.git
+  sudo apt-get install swig
+  sudo gem install nokogiri rake
+  cd ffi-swig-generator/examples && rake ffi:generate
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Andrea Fazzi
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,42 @@
+
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+begin
+  require 'bones'
+  Bones.setup
+rescue LoadError
+  begin
+    load 'tasks/setup.rb'
+  rescue LoadError
+    raise RuntimeError, '### please install the "bones" gem ###'
+  end
+end
+
+ensure_in_path 'lib'
+require 'ffi-generator'
+
+task :default => 'spec:run'
+
+PROJ.name = 'ffi-swig-generator'
+PROJ.authors = 'Andrea Fazzi'
+PROJ.email = 'andrea.fazzi@alcacoop.it'
+PROJ.url = 'http://github.com/remogatto/ffi-swig-generator/tree/master'
+PROJ.version = FFI::Generator::VERSION
+PROJ.rubyforge.name = 'ffi-swig-generator'
+
+PROJ.readme_file = 'README.rdoc'
+
+PROJ.ann.paragraphs << 'FEATURES' << 'SYNOPSIS' << 'REQUIREMENTS' << 'DOWNLOAD' << 'EXAMPLES'
+PROJ.ann.email[:from] = 'andrea.fazzi@alca.le.it'
+PROJ.ann.email[:to] << 'dev@ruby-ffi.kenai.com' << 'users@ruby-ffi.kenai.com'
+PROJ.ann.email[:server] = 'smtp.gmail.com'
+
+PROJ.ruby_opts = []
+PROJ.spec.opts << '--color'
+
+depend_on 'rake'
+depend_on 'nokogiri'
+
+# EOF

data/bin/ffi-gen

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(
+    File.join(File.dirname(__FILE__), %w[.. lib ffi-generator]))
+
+FFI::Generator::Application.run
+

data/examples/Rakefile

@@ -0,0 +1,4 @@
+require File.expand_path(File.join(File.dirname(__FILE__), %w[.. lib ffi-generator]))
+
+FFI::Generator::Task.new :input_fn => 'interfaces/*.i', :output_dir => 'generated'
+

data/examples/interfaces/libc.i

@@ -0,0 +1,26 @@
+%module libc
+
+%{
+require 'rubygems'
+require 'ffi'
+
+module LibC
+  extend FFI::Library
+%}
+
+typedef unsigned int size_t;
+
+struct timeval {
+  unsigned long tv_sec;
+  unsigned long tv_usec;
+};
+
+size_t strlen (const char *s);
+char * strcat (char *restrict to, const char *restrict from);
+int strcmp (const char *s1, const char *s2);
+
+int gettimeofday (struct timeval *tp, struct timezone *tzp);
+
+%{
+end
+%}

data/examples/interfaces/wiiuse.i

@@ -0,0 +1,672 @@
+%module wiiuse
+
+%{
+require 'ffi'
+
+module Wiiuse
+  extend FFI::Library
+  ffi_lib 'wiiuse'
+%}
+
+/*
+ *	wiiuse
+ *
+ *	Written By:
+ *		Michael Laforest	< para >
+ *		Email: < thepara (--AT--) g m a i l [--DOT--] com >
+ *
+ *	Copyright 2006-2007
+ *
+ *	This file is part of wiiuse.
+ *
+ *	This program is free software; you can redistribute it and/or modify
+ *	it under the terms of the GNU General Public License as published by
+ *	the Free Software Foundation; either version 3 of the License, or
+ *	(at your option) any later version.
+ *
+ *	This program is distributed in the hope that it will be useful,
+ *	but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *	GNU General Public License for more details.
+ *
+ *	You should have received a copy of the GNU General Public License
+ *	along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ *	$Header$
+ *
+ */
+
+/**
+ *	@file
+ *
+ *	@brief API header file.
+ *
+ *	If this file is included from inside the wiiuse source
+ *	and not from a third party program, then wiimote_internal.h
+ *	is also included which extends this file.
+ */
+
+#ifndef WIIUSE_H_INCLUDED
+#define WIIUSE_H_INCLUDED
+
+#ifdef _WIN32			      
+/* windows */
+#include <windows.h>
+
+/**
+ *	@enum win32_bt_stack_t
+ *	@brief	Available bluetooth stacks for Windows.
+ */
+typedef enum win_bt_stack_t {
+  WIIUSE_STACK_UNKNOWN,
+  WIIUSE_STACK_MS,
+  WIIUSE_STACK_BLUESOLEIL
+} win_bt_stack_t;
+
+#else						
+/* nix */
+#include <bluetooth/bluetooth.h>
+#endif
+
+#ifdef WIIUSE_INTERNAL_H_INCLUDED
+#define WCONST
+#else
+#define WCONST		const
+#endif
+
+/* led bit masks */
+#define WIIMOTE_LED_NONE				0x00
+#define WIIMOTE_LED_1					0x10
+#define WIIMOTE_LED_2					0x20
+#define WIIMOTE_LED_3					0x40
+#define WIIMOTE_LED_4					0x80
+
+/* button codes */
+#define WIIMOTE_BUTTON_TWO				0x0001
+#define WIIMOTE_BUTTON_ONE				0x0002
+#define WIIMOTE_BUTTON_B				0x0004
+#define WIIMOTE_BUTTON_A				0x0008
+#define WIIMOTE_BUTTON_MINUS			0x0010
+#define WIIMOTE_BUTTON_ZACCEL_BIT6		0x0020
+#define WIIMOTE_BUTTON_ZACCEL_BIT7		0x0040
+#define WIIMOTE_BUTTON_HOME				0x0080
+#define WIIMOTE_BUTTON_LEFT				0x0100
+#define WIIMOTE_BUTTON_RIGHT			0x0200
+#define WIIMOTE_BUTTON_DOWN				0x0400
+#define WIIMOTE_BUTTON_UP				0x0800
+#define WIIMOTE_BUTTON_PLUS				0x1000
+#define WIIMOTE_BUTTON_ZACCEL_BIT4		0x2000
+#define WIIMOTE_BUTTON_ZACCEL_BIT5		0x4000
+#define WIIMOTE_BUTTON_UNKNOWN			0x8000
+#define WIIMOTE_BUTTON_ALL				0x1F9F
+
+/* nunchul button codes */
+#define NUNCHUK_BUTTON_Z				0x01
+#define NUNCHUK_BUTTON_C				0x02
+#define NUNCHUK_BUTTON_ALL				0x03
+
+/* classic controller button codes */
+#define CLASSIC_CTRL_BUTTON_UP			0x0001
+#define CLASSIC_CTRL_BUTTON_LEFT		0x0002
+#define CLASSIC_CTRL_BUTTON_ZR			0x0004
+#define CLASSIC_CTRL_BUTTON_X			0x0008
+#define CLASSIC_CTRL_BUTTON_A			0x0010
+#define CLASSIC_CTRL_BUTTON_Y			0x0020
+#define CLASSIC_CTRL_BUTTON_B			0x0040
+#define CLASSIC_CTRL_BUTTON_ZL			0x0080
+#define CLASSIC_CTRL_BUTTON_FULL_R		0x0200
+#define CLASSIC_CTRL_BUTTON_PLUS		0x0400
+#define CLASSIC_CTRL_BUTTON_HOME		0x0800
+#define CLASSIC_CTRL_BUTTON_MINUS		0x1000
+#define CLASSIC_CTRL_BUTTON_FULL_L		0x2000
+#define CLASSIC_CTRL_BUTTON_DOWN		0x4000
+#define CLASSIC_CTRL_BUTTON_RIGHT		0x8000
+#define CLASSIC_CTRL_BUTTON_ALL			0xFEFF
+
+/* guitar hero 3 button codes */
+#define GUITAR_HERO_3_BUTTON_STRUM_UP	0x0001
+#define GUITAR_HERO_3_BUTTON_YELLOW		0x0008
+#define GUITAR_HERO_3_BUTTON_GREEN		0x0010
+#define GUITAR_HERO_3_BUTTON_BLUE		0x0020
+#define GUITAR_HERO_3_BUTTON_RED		0x0040
+#define GUITAR_HERO_3_BUTTON_ORANGE		0x0080
+#define GUITAR_HERO_3_BUTTON_PLUS		0x0400
+#define GUITAR_HERO_3_BUTTON_MINUS		0x1000
+#define GUITAR_HERO_3_BUTTON_STRUM_DOWN	0x4000
+#define GUITAR_HERO_3_BUTTON_ALL		0xFEFF
+
+
+/* wiimote option flags */
+#define WIIUSE_SMOOTHING				0x01
+#define WIIUSE_CONTINUOUS				0x02
+#define WIIUSE_ORIENT_THRESH			0x04
+#define WIIUSE_INIT_FLAGS				(WIIUSE_SMOOTHING | WIIUSE_ORIENT_THRESH)
+
+#define WIIUSE_ORIENT_PRECISION			100.0f
+
+/* expansion codes */
+#define EXP_NONE						0
+#define EXP_NUNCHUK						1
+#define EXP_CLASSIC						2
+#define EXP_GUITAR_HERO_3				3
+
+/* IR correction types */
+typedef enum ir_position_t {
+  WIIUSE_IR_ABOVE,
+  WIIUSE_IR_BELOW
+} ir_position_t;
+
+/**
+ *	@enum WIIUSE_EVENT_TYPE
+ *	@brief Events that wiiuse can generate from a poll.
+ */
+typedef enum WIIUSE_EVENT_TYPE {
+  WIIUSE_NONE = 0,
+  WIIUSE_EVENT,
+  WIIUSE_STATUS,
+  WIIUSE_CONNECT,
+  WIIUSE_DISCONNECT,
+  WIIUSE_UNEXPECTED_DISCONNECT,
+  WIIUSE_READ_DATA,
+  WIIUSE_NUNCHUK_INSERTED,
+  WIIUSE_NUNCHUK_REMOVED,
+  WIIUSE_CLASSIC_CTRL_INSERTED,
+  WIIUSE_CLASSIC_CTRL_REMOVED,
+  WIIUSE_GUITAR_HERO_3_CTRL_INSERTED,
+  WIIUSE_GUITAR_HERO_3_CTRL_REMOVED
+} WIIUSE_EVENT_TYPE;
+
+
+/**
+ *	@enum aspect_t
+ *	@brief Screen aspect ratio.
+ */
+typedef enum aspect_t {
+  WIIUSE_ASPECT_4_3,
+  WIIUSE_ASPECT_16_9
+} aspect_t;
+
+
+/**
+ *	@brief Check if a button is pressed.
+ *	@param dev		Pointer to a wiimote_t or expansion structure.
+ *	@param button	The button you are interested in.
+ *	@return 1 if the button is pressed, 0 if not.
+ */
+#define IS_PRESSED(dev, button)		((dev->btns & button) == button)
+
+/**
+ *	@brief Check if a button is being held.
+ *	@param dev		Pointer to a wiimote_t or expansion structure.
+ *	@param button	The button you are interested in.
+ *	@return 1 if the button is held, 0 if not.
+ */
+#define IS_HELD(dev, button)			((dev->btns_held & button) == button)
+
+/**
+ *	@brief Check if a button is released on this event.					\n\n
+ *			This does not mean the button is not pressed, it means		\n
+ *			this button was just now released.
+ *	@param dev		Pointer to a wiimote_t or expansion structure.
+ *	@param button	The button you are interested in.
+ *	@return 1 if the button is released, 0 if not.
+ *
+ */
+#define IS_RELEASED(dev, button)		((dev->btns_released & button) == button)
+
+/**
+ *	@brief Check if a button has just been pressed this event.
+ *	@param dev		Pointer to a wiimote_t or expansion structure.
+ *	@param button	The button you are interested in.
+ *	@return 1 if the button is pressed, 0 if not.
+ */
+#define IS_JUST_PRESSED(dev, button)	(IS_PRESSED(dev, button) && !IS_HELD(dev, button))
+
+/**
+ *	@brief Return the IR sensitivity level.
+ *	@param wm		Pointer to a wiimote_t structure.
+ *	@param lvl		[out] Pointer to an int that will hold the level setting.
+ *	If no level is set 'lvl' will be set to 0.
+ */
+#define WIIUSE_GET_IR_SENSITIVITY(dev, lvl)				\
+  do {									\
+    if ((wm->state & 0x0200) == 0x0200) 		*lvl = 1;	\
+    else if ((wm->state & 0x0400) == 0x0400) 	*lvl = 2;		\
+    else if ((wm->state & 0x0800) == 0x0800) 	*lvl = 3;		\
+    else if ((wm->state & 0x1000) == 0x1000) 	*lvl = 4;		\
+    else if ((wm->state & 0x2000) == 0x2000) 	*lvl = 5;		\
+    else									*lvl = 0; \
+  } while (0)
+
+#define WIIUSE_USING_ACC(wm)			((wm->state & 0x020) == 0x020)
+#define WIIUSE_USING_EXP(wm)			((wm->state & 0x040) == 0x040)
+#define WIIUSE_USING_IR(wm)				((wm->state & 0x080) == 0x080)
+#define WIIUSE_USING_SPEAKER(wm)		((wm->state & 0x100) == 0x100)
+
+#define WIIUSE_IS_LED_SET(wm, num)		((wm->leds & WIIMOTE_LED_##num) == WIIMOTE_LED_##num)
+
+/*
+ *	Largest known payload is 21 bytes.
+ *	Add 2 for the prefix and round up to a power of 2.
+ */
+#define MAX_PAYLOAD			32
+
+/*
+ *	This is left over from an old hack, but it may actually
+ *	be a useful feature to keep so it wasn't removed.
+ */
+#ifdef WIN32
+#define WIIMOTE_DEFAULT_TIMEOUT		10
+#define WIIMOTE_EXP_TIMEOUT			10
+#endif
+
+typedef unsigned char byte;
+typedef char sbyte;
+
+struct wiimote_t;
+struct vec3b_t;
+struct orient_t;
+struct gforce_t;
+
+
+/**
+ *      @brief Callback that handles a read event.
+ *
+ *      @param wm               Pointer to a wiimote_t structure.
+ *      @param data             Pointer to the filled data block.
+ *      @param len              Length in bytes of the data block.
+ *
+ *      @see wiiuse_init()
+ *
+ *      A registered function of this type is called automatically by the wiiuse
+ *      library when the wiimote has returned the full data requested by a previous
+ *      call to wiiuse_read_data().
+ */
+typedef void (*wiiuse_read_cb)(struct wiimote_t* wm, byte* data, unsigned short len);
+
+
+/**
+ *	@struct read_req_t
+ *	@brief Data read request structure.
+ */
+struct read_req_t {
+  wiiuse_read_cb cb;			/**< read data callback											*/
+  byte* buf;					/**< buffer where read data is written							*/
+  unsigned int addr;			/**< the offset that the read started at						*/
+  unsigned short size;		/**< the length of the data read								*/
+  unsigned short wait;		/**< num bytes still needed to finish read						*/
+  byte dirty;					/**< set to 1 if not using callback and needs to be cleaned up	*/
+
+  struct read_req_t* next;	/**< next read request in the queue								*/
+};
+
+
+/**
+ *	@struct vec2b_t
+ *	@brief Unsigned x,y byte vector.
+ */
+typedef struct vec2b_t {
+  byte x, y;
+} vec2b_t;
+
+
+/**
+ *	@struct vec3b_t
+ *	@brief Unsigned x,y,z byte vector.
+ */
+typedef struct vec3b_t {
+  byte x, y, z;
+} vec3b_t;
+
+
+/**
+ *	@struct vec3f_t
+ *	@brief Signed x,y,z float struct.
+ */
+typedef struct vec3f_t {
+  float x, y, z;
+} vec3f_t;
+
+
+/**
+ *	@struct orient_t
+ *	@brief Orientation struct.
+ *
+ *	Yaw, pitch, and roll range from -180 to 180 degrees.
+ */
+typedef struct orient_t {
+  float roll;						/**< roll, this may be smoothed if enabled	*/
+  float pitch;					/**< pitch, this may be smoothed if enabled	*/
+  float yaw;
+
+  float a_roll;					/**< absolute roll, unsmoothed				*/
+  float a_pitch;					/**< absolute pitch, unsmoothed				*/
+} orient_t;
+
+
+/**
+ *	@struct gforce_t
+ *	@brief Gravity force struct.
+ */
+typedef struct gforce_t {
+  float x, y, z;
+} gforce_t;
+
+
+/**
+ *	@struct accel_t
+ *	@brief Accelerometer struct. For any device with an accelerometer.
+ */
+typedef struct accel_t {
+  struct vec3b_t cal_zero;		/**< zero calibration					*/
+  struct vec3b_t cal_g;			/**< 1g difference around 0cal			*/
+
+  float st_roll;					/**< last smoothed roll value			*/
+  float st_pitch;					/**< last smoothed roll pitch			*/
+  float st_alpha;					/**< alpha value for smoothing [0-1]	*/
+} accel_t;
+
+
+/**
+ *	@struct ir_dot_t
+ *	@brief A single IR source.
+ */
+typedef struct ir_dot_t {
+  byte visible;					/**< if the IR source is visible		*/
+
+  unsigned int x;					/**< interpolated X coordinate			*/
+  unsigned int y;					/**< interpolated Y coordinate			*/
+
+  short rx;						/**< raw X coordinate (0-1023)			*/
+  short ry;						/**< raw Y coordinate (0-767)			*/
+
+  byte order;						/**< increasing order by x-axis value	*/
+
+  byte size;						/**< size of the IR dot (0-15)			*/
+} ir_dot_t;
+
+
+/**
+ *	@struct ir_t
+ *	@brief IR struct. Hold all data related to the IR tracking.
+ */
+typedef struct ir_t {
+  struct ir_dot_t dot[4];			/**< IR dots							*/
+  byte num_dots;					/**< number of dots at this time		*/
+
+  enum aspect_t aspect;			/**< aspect ratio of the screen			*/
+
+  enum ir_position_t pos;			/**< IR sensor bar position				*/
+
+  unsigned int vres[2];			/**< IR virtual screen resolution		*/
+  int offset[2];					/**< IR XY correction offset			*/
+  int state;						/**< keeps track of the IR state		*/
+
+  int ax;							/**< absolute X coordinate				*/
+  int ay;							/**< absolute Y coordinate				*/
+
+  int x;							/**< calculated X coordinate			*/
+  int y;							/**< calculated Y coordinate			*/
+
+  float distance;					/**< pixel distance between first 2 dots*/
+  float z;						/**< calculated distance				*/
+} ir_t;
+
+
+/**
+ *	@struct joystick_t
+ *	@brief Joystick calibration structure.
+ *
+ *	The angle \a ang is relative to the positive y-axis into quadrant I
+ *	and ranges from 0 to 360 degrees.  So if the joystick is held straight
+ *	upwards then angle is 0 degrees.  If it is held to the right it is 90,
+ *	down is 180, and left is 270.
+ *
+ *	The magnitude \a mag is the distance from the center to where the
+ *	joystick is being held.  The magnitude ranges from 0 to 1.
+ *	If the joystick is only slightly tilted from the center the magnitude
+ *	will be low, but if it is closer to the outter edge the value will
+ *	be higher.
+ */
+typedef struct joystick_t {
+  struct vec2b_t max;				/**< maximum joystick values	*/
+  struct vec2b_t min;				/**< minimum joystick values	*/
+  struct vec2b_t center;			/**< center joystick values		*/
+
+  float ang;						/**< angle the joystick is being held		*/
+  float mag;						/**< magnitude of the joystick (range 0-1)	*/
+} joystick_t;
+
+
+/**
+ *	@struct nunchuk_t
+ *	@brief Nunchuk expansion device.
+ */
+typedef struct nunchuk_t {
+  struct accel_t accel_calib;		/**< nunchuk accelerometer calibration		*/
+  struct joystick_t js;			/**< joystick calibration					*/
+
+  int* flags;						/**< options flag (points to wiimote_t.flags) */
+
+  byte btns;						/**< what buttons have just been pressed	*/
+  byte btns_held;					/**< what buttons are being held down		*/
+  byte btns_released;				/**< what buttons were just released this	*/
+
+  float orient_threshold;			/**< threshold for orient to generate an event */
+  int accel_threshold;			/**< threshold for accel to generate an event */
+
+  struct vec3b_t accel;			/**< current raw acceleration data			*/
+  struct orient_t orient;			/**< current orientation on each axis		*/
+  struct gforce_t gforce;			/**< current gravity forces on each axis	*/
+} nunchuk_t;
+
+
+/**
+ *	@struct classic_ctrl_t
+ *	@brief Classic controller expansion device.
+ */
+typedef struct classic_ctrl_t {
+  short btns;						/**< what buttons have just been pressed	*/
+  short btns_held;				/**< what buttons are being held down		*/
+  short btns_released;			/**< what buttons were just released this	*/
+
+  float r_shoulder;				/**< right shoulder button (range 0-1)		*/
+  float l_shoulder;				/**< left shoulder button (range 0-1)		*/
+
+  struct joystick_t ljs;			/**< left joystick calibration				*/
+  struct joystick_t rjs;			/**< right joystick calibration				*/
+} classic_ctrl_t;
+
+
+/**
+ *	@struct guitar_hero_3_t
+ *	@brief Guitar Hero 3 expansion device.
+ */
+typedef struct guitar_hero_3_t {
+  short btns;						/**< what buttons have just been pressed	*/
+  short btns_held;				/**< what buttons are being held down		*/
+  short btns_released;			/**< what buttons were just released this	*/
+
+  float whammy_bar;				/**< whammy bar (range 0-1)					*/
+
+  struct joystick_t js;			/**< joystick calibration					*/
+} guitar_hero_3_t;
+
+
+/**
+ *	@struct expansion_t
+ *	@brief Generic expansion device plugged into wiimote.
+ */
+union union_t {
+  struct nunchuk_t nunchuk;
+  struct classic_ctrl_t classic;
+  struct guitar_hero_3_t gh3;
+};
+
+typedef struct expansion_t {
+  int type;						/**< type of expansion attached				*/
+  union_t controller;  
+} expansion_t;
+
+/**
+ *	@struct wiimote_state_t
+ *	@brief Significant data from the previous event.
+ */
+typedef struct wiimote_state_t {
+  /* expansion_t */
+  float exp_ljs_ang;
+  float exp_rjs_ang;
+  float exp_ljs_mag;
+  float exp_rjs_mag;
+  unsigned short exp_btns;
+  struct orient_t exp_orient;
+  struct vec3b_t exp_accel;
+  float exp_r_shoulder;
+  float exp_l_shoulder;
+
+  /* ir_t */
+  int ir_ax;
+  int ir_ay;
+  float ir_distance;
+
+  struct orient_t orient;
+  unsigned short btns;
+
+  struct vec3b_t accel;
+} wiimote_state_t;
+
+
+struct bdaddr_t {
+  unsigned char b[6];
+};
+
+/**
+ *	@struct wiimote_t
+ *	@brief Wiimote structure.
+ */
+typedef struct wiimote_t {
+  WCONST int unid;						/**< user specified id						*/
+
+#ifndef WIN32			
+  WCONST struct bdaddr_t bdaddr;				/**< bt address								*/
+  WCONST char bdaddr_str[18];			/**< readable bt address					*/
+  WCONST int out_sock;				/**< output socket							*/
+  WCONST int in_sock;					/**< input socket 							*/
+#else				
+  WCONST HANDLE dev_handle;			/**< HID handle								*/
+  WCONST OVERLAPPED hid_overlap;		/**< overlap handle							*/
+  WCONST enum win_bt_stack_t stack;	/**< type of bluetooth stack to use			*/
+  WCONST int timeout;					/**< read timeout							*/
+  WCONST byte normal_timeout;			/**< normal timeout							*/
+  WCONST byte exp_timeout;			/**< timeout for expansion handshake		*/
+#endif
+
+  WCONST int state;						/**< various state flags					*/
+  WCONST byte leds;						/**< currently lit leds						*/
+  WCONST float battery_level;				/**< battery level							*/
+
+  WCONST int flags;						/**< options flag							*/
+
+  WCONST byte handshake_state;			/**< the state of the connection handshake	*/
+
+  WCONST struct read_req_t* read_req;		/**< list of data read requests				*/
+  WCONST struct accel_t accel_calib;		/**< wiimote accelerometer calibration		*/
+  WCONST struct expansion_t exp;			/**< wiimote expansion device				*/
+
+  WCONST struct vec3b_t accel;			/**< current raw acceleration data			*/
+  WCONST struct orient_t orient;			/**< current orientation on each axis		*/
+  WCONST struct gforce_t gforce;			/**< current gravity forces on each axis	*/
+
+  WCONST struct ir_t ir;					/**< IR data								*/
+
+  WCONST unsigned short btns;				/**< what buttons have just been pressed	*/
+  WCONST unsigned short btns_held;		/**< what buttons are being held down		*/
+  WCONST unsigned short btns_released;	/**< what buttons were just released this	*/
+
+  WCONST float orient_threshold;			/**< threshold for orient to generate an event */
+  WCONST int accel_threshold;				/**< threshold for accel to generate an event */
+
+  WCONST struct wiimote_state_t lstate;	/**< last saved state						*/
+
+  WCONST WIIUSE_EVENT_TYPE event;			/**< type of event that occured				*/
+  WCONST byte event_buf[MAX_PAYLOAD];		/**< event buffer							*/
+} wiimote;
+
+
+/*****************************************
+ *
+ *	Include API specific stuff
+ *
+ *****************************************/
+
+#ifdef _WIN32
+#define WIIUSE_EXPORT_DECL __declspec(dllexport)
+#define WIIUSE_IMPORT_DECL __declspec(dllimport)
+#else
+#define WIIUSE_EXPORT_DECL
+#define WIIUSE_IMPORT_DECL
+#endif
+
+#ifdef WIIUSE_COMPILE_LIB
+#define WIIUSE_EXPORT WIIUSE_EXPORT_DECL
+#else
+#define WIIUSE_EXPORT WIIUSE_IMPORT_DECL
+#endif
+
+#ifdef __cplusplus				\
+extern "C" {
+#endif
+
+/* wiiuse.c */
+WIIUSE_EXPORT extern const char* wiiuse_version();
+
+WIIUSE_EXPORT extern struct wiimote_t** wiiuse_init(int wiimotes);
+WIIUSE_EXPORT extern void wiiuse_disconnected(struct wiimote_t* wm);
+WIIUSE_EXPORT extern void wiiuse_cleanup(struct wiimote_t** wm, int wiimotes);
+WIIUSE_EXPORT extern void wiiuse_rumble(struct wiimote_t* wm, int status);
+WIIUSE_EXPORT extern void wiiuse_toggle_rumble(struct wiimote_t* wm);
+WIIUSE_EXPORT extern void wiiuse_set_leds(struct wiimote_t* wm, int leds);
+WIIUSE_EXPORT extern void wiiuse_motion_sensing(struct wiimote_t* wm, int status);
+WIIUSE_EXPORT extern int wiiuse_read_data(struct wiimote_t* wm, byte* buffer, unsigned int offset, unsigned short len);
+WIIUSE_EXPORT extern int wiiuse_write_data(struct wiimote_t* wm, unsigned int addr, byte* data, byte len);
+WIIUSE_EXPORT extern void wiiuse_status(struct wiimote_t* wm);
+WIIUSE_EXPORT extern struct wiimote_t* wiiuse_get_by_id(struct wiimote_t** wm, int wiimotes, int unid);
+WIIUSE_EXPORT extern int wiiuse_set_flags(struct wiimote_t* wm, int enable, int disable);
+WIIUSE_EXPORT extern float wiiuse_set_smooth_alpha(struct wiimote_t* wm, float alpha);
+WIIUSE_EXPORT extern void wiiuse_set_bluetooth_stack(struct wiimote_t** wm, int wiimotes, enum win_bt_stack_t type);
+WIIUSE_EXPORT extern void wiiuse_set_orient_threshold(struct wiimote_t* wm, float threshold);
+WIIUSE_EXPORT extern void wiiuse_resync(struct wiimote_t* wm);
+WIIUSE_EXPORT extern void wiiuse_set_timeout(struct wiimote_t** wm, int wiimotes, byte normal_timeout, byte exp_timeout);
+WIIUSE_EXPORT extern void wiiuse_set_accel_threshold(struct wiimote_t* wm, int threshold);
+
+/* connect.c */
+WIIUSE_EXPORT extern int wiiuse_find(struct wiimote_t** wm, int max_wiimotes, int timeout);
+WIIUSE_EXPORT extern int wiiuse_connect(struct wiimote_t** wm, int wiimotes);
+WIIUSE_EXPORT extern void wiiuse_disconnect(struct wiimote_t* wm);
+
+/* events.c */
+WIIUSE_EXPORT extern int wiiuse_poll(struct wiimote_t** wm, int wiimotes);
+
+/* ir.c */
+WIIUSE_EXPORT extern void wiiuse_set_ir(struct wiimote_t* wm, int status);
+WIIUSE_EXPORT extern void wiiuse_set_ir_vres(struct wiimote_t* wm, unsigned int x, unsigned int y);
+WIIUSE_EXPORT extern void wiiuse_set_ir_position(struct wiimote_t* wm, enum ir_position_t pos);
+WIIUSE_EXPORT extern void wiiuse_set_aspect_ratio(struct wiimote_t* wm, enum aspect_t aspect);
+WIIUSE_EXPORT extern void wiiuse_set_ir_sensitivity(struct wiimote_t* wm, int level);
+
+/* nunchuk.c */
+WIIUSE_EXPORT extern void wiiuse_set_nunchuk_orient_threshold(struct wiimote_t* wm, float threshold);
+WIIUSE_EXPORT extern void wiiuse_set_nunchuk_accel_threshold(struct wiimote_t* wm, int threshold);
+
+
+#ifdef __cplusplus				\
+}
+#endif
+
+
+#endif /* WIIUSE_H_INCLUDED */
+
+%{
+end
+%}
+