scummvm/backends/keymapper/hardware-key.h

/* ScummVM - Graphic Adventure Engine
*
* ScummVM is the legal property of its developers, whose names
* are too numerous to list here. Please refer to the COPYRIGHT
* file distributed with this source distribution.
*
* 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 2
* 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, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*
*/

#ifndef COMMON_HARDWARE_KEY_H
#define COMMON_HARDWARE_KEY_H

#include "common/scummsys.h"

#ifdef ENABLE_KEYMAPPER

#include "common/textconsole.h"

namespace Common {

/**
* Describes an available hardware key
*/
struct HardwareKey {
	/** unique id used for saving/loading to config */
	String id;

	/** Human readable description */
	String description;

	/**
	* The KeyState that is generated by the back-end
	* when this hardware key is pressed.
	*/
	KeyState key;

	HardwareKey(String i, KeyState ky = KeyState(), String desc = "")
		: id(i), key(ky), description(desc) { }
};

/**
 * Entry in a static table of available non-modifier keys
 */
struct KeyTableEntry {
	const char *hwId;
	KeyCode keycode;
	uint16 ascii;
	const char *desc;
	bool shiftable;
};

/**
 * Entry in a static table of available key modifiers
 */
struct ModifierTableEntry {
	byte flag;
	const char *id;
	const char *desc;
	bool shiftable;
};

/**
 * Simple class to encapsulate a device's set of HardwareKeys.
 * Each device should instantiate this and call addHardwareKey a number of times
 * in its constructor to define the device's available keys.
 */
class HardwareKeySet {
public:

	/**
	 * Add hardware keys to the set out of key and modifier tables.
	 * @param keys       table of available keys
	 * @param modifiers  table of available modifiers
	 */
	HardwareKeySet(const KeyTableEntry keys[], const ModifierTableEntry modifiers[]) {
		addHardwareKeys(keys, modifiers);
	}

	HardwareKeySet() { }

	virtual ~HardwareKeySet() {
		List<const HardwareKey *>::const_iterator it;

		for (it = _keys.begin(); it != _keys.end(); it++)
			delete *it;
	}

	void addHardwareKey(const HardwareKey *key) {
		checkForKey(key);
		_keys.push_back(key);
	}

	const HardwareKey *findHardwareKey(String id) const {
		List<const HardwareKey *>::const_iterator it;

		for (it = _keys.begin(); it != _keys.end(); it++) {
			if ((*it)->id == id)
				return (*it);
		}
		return 0;
	}

	const HardwareKey *findHardwareKey(const KeyState& keystate) const {
		List<const HardwareKey *>::const_iterator it;

		for (it = _keys.begin(); it != _keys.end(); it++) {
			if ((*it)->key == keystate)
				return (*it);
		}
		return 0;
	}

	const List<const HardwareKey *> &getHardwareKeys() const {
		return _keys;
	}

	uint size() const {
		return _keys.size();
	}

	/**
	 * Add hardware keys to the set out of key and modifier tables.
	 * @param keys       table of available keys
	 * @param modifiers  table of available modifiers
	 */
	void addHardwareKeys(const KeyTableEntry keys[], const ModifierTableEntry modifiers[]) {
		const KeyTableEntry *key;
		const ModifierTableEntry *mod;
		char fullKeyId[50];
		char fullKeyDesc[100];
		uint16 ascii;

		for (mod = modifiers; mod->id; mod++) {
			for (key = keys; key->hwId; key++) {
				ascii = key->ascii;

				if (mod->shiftable && key->shiftable) {
					snprintf(fullKeyId, 50, "%s%c", mod->id, toupper(key->hwId[0]));
					snprintf(fullKeyDesc, 100, "%s%c", mod->desc, toupper(key->desc[0]));
					ascii = toupper(key->ascii);
				} else if (mod->shiftable) {
					snprintf(fullKeyId, 50, "S+%s%s", mod->id, key->hwId);
					snprintf(fullKeyDesc, 100, "Shift+%s%s", mod->desc, key->desc);
				} else {
					snprintf(fullKeyId, 50, "%s%s", mod->id, key->hwId);
					snprintf(fullKeyDesc, 100, "%s%s", mod->desc, key->desc);
				}

				addHardwareKey(new HardwareKey(fullKeyId, KeyState(key->keycode, ascii, mod->flag), fullKeyDesc));
			}
		}
	}

private:

	void checkForKey(const HardwareKey *key) {
		List<const HardwareKey *>::iterator it;

		for (it = _keys.begin(); it != _keys.end(); it++) {
			if ((*it)->id == key->id)
				error("Error adding HardwareKey '%s' - id of %s already in use!", key->description.c_str(), key->id.c_str());
			else if ((*it)->key == key->key)
				error("Error adding HardwareKey '%s' - key already in use!", key->description.c_str());
		}
	}

	List<const HardwareKey *> _keys;
};

} // End of namespace Common

#endif // #ifdef ENABLE_KEYMAPPER

#endif // #ifndef COMMON_HARDWARE_KEY_H