From cd8a8e625562d72b478f8218a2ac2ba076e0a15d Mon Sep 17 00:00:00 2001 From: Drew Fisher Date: Wed, 16 Nov 2011 19:52:50 -0800 Subject: [PATCH] More doxygen. Signed-off-by: Drew Fisher --- doc/Doxyfile | 9 +++++---- doc/DoxygenMainpage.h | 32 ++++++++++++++++++++++++++++++++ libtouchmouse/libtouchmouse.h | 4 +++- 3 files changed, 40 insertions(+), 5 deletions(-) create mode 100644 doc/DoxygenMainpage.h diff --git a/doc/Doxyfile b/doc/Doxyfile index 2ea923a..f2405b9 100644 --- a/doc/Doxyfile +++ b/doc/Doxyfile @@ -629,7 +629,8 @@ WARN_LOGFILE = # directories like "/usr/src/myproject". Separate the files or directories # with spaces. -INPUT = ../libtouchmouse/ +INPUT = ../libtouchmouse/ \ + ../doc/ # This tag can be used to specify the character encoding of the source files # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is @@ -647,13 +648,13 @@ INPUT_ENCODING = UTF-8 # *.hxx *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.dox *.py # *.f90 *.f *.for *.vhd *.vhdl -FILE_PATTERNS = +FILE_PATTERNS = *.h # The RECURSIVE tag can be used to turn specify whether or not subdirectories # should be searched for input files as well. Possible values are YES and NO. # If left blank NO is used. -RECURSIVE = NO +RECURSIVE = YES # The EXCLUDE tag can be used to specify files and/or directories that should # excluded from the INPUT source files. This way you can easily exclude a @@ -1186,7 +1187,7 @@ SERVER_BASED_SEARCH = NO # If the GENERATE_LATEX tag is set to YES (the default) Doxygen will # generate Latex output. -GENERATE_LATEX = YES +GENERATE_LATEX = NO # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. # If a relative path is entered the value of OUTPUT_DIRECTORY will be diff --git a/doc/DoxygenMainpage.h b/doc/DoxygenMainpage.h new file mode 100644 index 0000000..42c158a --- /dev/null +++ b/doc/DoxygenMainpage.h @@ -0,0 +1,32 @@ +/** +@mainpage libtouchmouse +@author Drew Fisher (drew.m.fisher@gmail.com) + +An open-source, cross-platform driver for the Microsoft TouchMouse + +Sources: http://github.com/zarvox/libtouchmouse + +@section libtouchmouseIntro Introduction + +libtouchmouse is a userspace driver for the Microsoft TouchMouse built on HIDAPI +(http://www.signal11.us/oss/hidapi/). While the TouchMouse will work as a +basic mouse on all platforms that implement USB mice through HID, this driver +is interesting in that it provides access to the device's raw touch image matrix. + +@section libtouchmouseUsage Usage + +libtouchmouse is properly used in the following manner: + +- Initialize the library with touchmouse_init() +- Enumerate devices with touchmouse_enumerate_devices() +- Open a device (or multiple devices) with touchmouse_open() +- Free the device enumeration with touchmouse_free_enumeration() +- Put the device in full image updates mode with touchmouse_set_device_mode() +- Set a callback for the device with touchmouse_set_image_update_callback() +- Repeatedly call touchmouse_process_events_timeout(), which will call your callback function to get image updates. You may wish to do this in a blocking manner in a thread. +- When done with the device, (optionally) set the device back in default mode with touchmouse_set_device_mode() and close the device with touchmouse_close() +- Deinitialize the library with touchmouse_shutdown() + +See the examples for usage examples that you're free to copy and modify at will. + +*/ diff --git a/libtouchmouse/libtouchmouse.h b/libtouchmouse/libtouchmouse.h index adc9dc6..87a4d73 100644 --- a/libtouchmouse/libtouchmouse.h +++ b/libtouchmouse/libtouchmouse.h @@ -2,13 +2,15 @@ #define __LIBTOUCHMOUSE_H__ #include -// Win32 needs symbols exported. #ifndef _WIN32 + /// Win32 needs symbols exported. #define TOUCHMOUSEAPI #else #ifdef __cplusplus + /// Win32 needs symbols exported. #define TOUCHMOUSEAPI extern "C" __declspec(dllexport) #else + /// Win32 needs symbols exported. #define TOUCHMOUSEAPI __declspec(dllexport) #endif #endif -- 2.39.5