/src/ois/includes/mac/MacHIDManager.h

  1/*
  2 The zlib/libpng License
  3 
  4 Copyright (c) 2007 Phillip
  5 
  6 This software is provided 'as-is', without any express or implied warranty. In no event will
  7 the authors be held liable for any damages arising from the use of this software.
  8 
  9 Permission is granted to anyone to use this software for any purpose, including commercial
 10 applications, and to alter it and redistribute it freely, subject to the following
 11 restrictions:
 12 
 13 1. The origin of this software must not be misrepresented; you must not claim that
 14 you wrote the original software. If you use this software in a product,
 15 an acknowledgment in the product documentation would be appreciated but is
 16 not required.
 17 
 18 2. Altered source versions must be plainly marked as such, and must not be
 19 misrepresented as being the original software.
 20 
 21 3. This notice may not be removed or altered from any source distribution.
 22 */
 23#ifndef OIS_MacHIDManager_Header
 24#define OIS_MacHIDManager_Header
 25
 26#include "OISPrereqs.h"
 27#include "mac/MacPrereqs.h"
 28#include "OISFactoryCreator.h"
 29
 30#import <CoreFoundation/CFString.h>
 31#import <IOKit/IOKitLib.h>
 32#import <IOKit/IOCFPlugIn.h>
 33#import <IOKit/hid/IOHIDLib.h>
 34#import <IOKit/hid/IOHIDKeys.h>
 35#import <Kernel/IOKit/hidsystem/IOHIDUsageTables.h>
 36
 37namespace OIS
 38{
 39	//Information needed to create Mac HID Devices
 40	class HidInfo
 41	{
 42	public:
 43		HidInfo() : type(OISUnknown), numButtons(0), numHats(0), numAxes(0), inUse(false), interface(0)
 44		{
 45		}
 46
 47		//Useful tracking information
 48		Type type;
 49		std::string vendor;
 50		std::string productKey;
 51		std::string combinedKey;
 52
 53		//Retain some count information for recreating devices without having to reparse
 54		int numButtons;
 55		int numHats;
 56		int numAxes;
 57		bool inUse;
 58
 59		//Used for opening a read/write/tracking interface to device
 60		IOHIDDeviceInterface **interface;
 61	};
 62
 63	typedef std::vector<HidInfo*> HidInfoList;
 64		
 65	class MacHIDManager : public FactoryCreator
 66	{
 67	public:
 68		MacHIDManager();
 69		~MacHIDManager();
 70
 71		void initialize();
 72		
 73		void iterateAndOpenDevices(io_iterator_t iterator);
 74		io_iterator_t lookUpDevices(int usage, int page);
 75
 76		//FactoryCreator Overrides
 77		/** @copydoc FactoryCreator::deviceList */
 78		DeviceList freeDeviceList();
 79
 80		/** @copydoc FactoryCreator::totalDevices */
 81		int totalDevices(Type iType);
 82
 83		/** @copydoc FactoryCreator::freeDevices */
 84		int freeDevices(Type iType);
 85
 86		/** @copydoc FactoryCreator::vendorExist */
 87		bool vendorExist(Type iType, const std::string & vendor);
 88
 89		/** @copydoc FactoryCreator::createObject */
 90		Object* createObject(InputManager* creator, Type iType, bool bufferMode, const std::string & vendor = "");
 91
 92		/** @copydoc FactoryCreator::destroyObject */
 93		void destroyObject(Object* obj);
 94
 95	private:
 96		HidInfo* enumerateDeviceProperties(CFMutableDictionaryRef propertyMap);
 97		void parseDeviceProperties(CFDictionaryRef properties);
 98		void parseDevicePropertiesGroup(CFDictionaryRef properties);
 99
100		HidInfoList mDeviceList;		
101	};
102}
103#endif