64 lines
2.0 KiB
C
64 lines
2.0 KiB
C
/* Copyright (C) 2009 Wildfire Games.
|
|
* This file is part of 0 A.D.
|
|
*
|
|
* 0 A.D. 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.
|
|
*
|
|
* 0 A.D. 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 0 A.D. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/**
|
|
* =========================================================================
|
|
* File : input.h
|
|
* Project : 0 A.D.
|
|
* Description : SDL input redirector; dispatches to multiple handlers and
|
|
* : allows record/playback of events.
|
|
* =========================================================================
|
|
*/
|
|
|
|
// license: GPL; see lib/license.txt
|
|
|
|
#ifndef INCLUDED_INPUT
|
|
#define INCLUDED_INPUT
|
|
|
|
|
|
#include "lib/external_libraries/sdl_fwd.h"
|
|
|
|
// input handler return values.
|
|
enum InReaction
|
|
{
|
|
// (the handlers' return values are checked and these
|
|
// 'strange' values might bring errors to light)
|
|
|
|
// pass the event to the next handler in the chain
|
|
IN_PASS = 4,
|
|
|
|
// we've handled it; no other handlers will receive this event.
|
|
IN_HANDLED = 2
|
|
};
|
|
|
|
typedef InReaction (*InHandler)(const SDL_Event_*);
|
|
|
|
// register an input handler, which will receive all subsequent events first.
|
|
// events are passed to other handlers if handler returns IN_PASS.
|
|
extern void in_add_handler(InHandler handler);
|
|
|
|
// send event to each handler (newest first) until one returns true
|
|
extern void in_dispatch_event(const SDL_Event_* event);
|
|
|
|
extern void in_dispatch_recorded_events();
|
|
|
|
extern LibError in_record(const char* fn);
|
|
extern LibError in_playback(const char* fn);
|
|
extern void in_stop(void);
|
|
|
|
#endif // #ifndef INCLUDED_INPUT
|