184df2a5fa
The input device API is split halfway thorugh the backends in a very weird way. The data structures are private, as they should, but most of the information should be available in the main API since it's generic enough. The device type enumeration, for instance, should be common across every backend; the accessors for device type and id should live in the core API. The internal API should always use ClutterInputDevice and not the private X11 implementation when dealing with public structures like ClutterEvent. By adding accessors for the device type and id, and by moving the device type enumeration into the core API we can cut down the amount of symbols private and/or visible only to the X11 backends; this way when other backends start implementing multi-pointer support we can share the same API across the code.
516 lines
14 KiB
C
516 lines
14 KiB
C
/*
|
|
* Clutter.
|
|
*
|
|
* An OpenGL based 'interactive canvas' library.
|
|
*
|
|
* Authored By Matthew Allum <mallum@openedhand.com>
|
|
*
|
|
* Copyright (C) 2006 OpenedHand
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
#error "Only <clutter/clutter.h> can be included directly."
|
|
#endif
|
|
|
|
#ifndef __CLUTTER_EVENT_H__
|
|
#define __CLUTTER_EVENT_H__
|
|
|
|
#include <glib-object.h>
|
|
#include <clutter/clutter-types.h>
|
|
|
|
#define CLUTTER_TYPE_EVENT (clutter_event_get_type ())
|
|
|
|
/**
|
|
* CLUTTER_PRIORITY_EVENTS:
|
|
*
|
|
* Priority for event handling.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
#define CLUTTER_PRIORITY_EVENTS (G_PRIORITY_DEFAULT)
|
|
|
|
/**
|
|
* CLUTTER_CURRENT_TIME:
|
|
*
|
|
* Default value for "now".
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
#define CLUTTER_CURRENT_TIME 0L
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* ClutterModifierType:
|
|
* @CLUTTER_SHIFT_MASK: Mask applied by the Shift key
|
|
* @CLUTTER_LOCK_MASK: Mask applied by the Caps Lock key
|
|
* @CLUTTER_CONTROL_MASK: Mask applied by the Control key
|
|
* @CLUTTER_MOD1_MASK: Mask applied by the first Mod key
|
|
* @CLUTTER_MOD2_MASK: Mask applied by the second Mod key
|
|
* @CLUTTER_MOD3_MASK: Mask applied by the third Mod key
|
|
* @CLUTTER_MOD4_MASK: Mask applied by the fourth Mod key
|
|
* @CLUTTER_MOD5_MASK: Mask applied by the fifth Mod key
|
|
* @CLUTTER_BUTTON1_MASK: Mask applied by the first pointer button
|
|
* @CLUTTER_BUTTON2_MASK: Mask applied by the second pointer button
|
|
* @CLUTTER_BUTTON3_MASK: Mask applied by the third pointer button
|
|
* @CLUTTER_BUTTON4_MASK: Mask applied by the fourth pointer button
|
|
* @CLUTTER_BUTTON5_MASK: Mask applied by the fifth pointer button
|
|
* @CLUTTER_SUPER_MASK: Mask applied by the Super key
|
|
* @CLUTTER_HYPER_MASK: Mask applied by the Hyper key
|
|
* @CLUTTER_META_MASK: Mask applied by the Meta key
|
|
* @CLUTTER_RELEASE_MASK: Mask applied during release
|
|
* @CLUTTER_MODIFIER_MASK: A mask covering all modifier types
|
|
*
|
|
* Masks applied to a #ClutterEvent by modifiers.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
typedef enum {
|
|
CLUTTER_SHIFT_MASK = 1 << 0,
|
|
CLUTTER_LOCK_MASK = 1 << 1,
|
|
CLUTTER_CONTROL_MASK = 1 << 2,
|
|
CLUTTER_MOD1_MASK = 1 << 3,
|
|
CLUTTER_MOD2_MASK = 1 << 4,
|
|
CLUTTER_MOD3_MASK = 1 << 5,
|
|
CLUTTER_MOD4_MASK = 1 << 6,
|
|
CLUTTER_MOD5_MASK = 1 << 7,
|
|
CLUTTER_BUTTON1_MASK = 1 << 8,
|
|
CLUTTER_BUTTON2_MASK = 1 << 9,
|
|
CLUTTER_BUTTON3_MASK = 1 << 10,
|
|
CLUTTER_BUTTON4_MASK = 1 << 11,
|
|
CLUTTER_BUTTON5_MASK = 1 << 12,
|
|
|
|
/* bits 15 to 25 are currently unused; bit 29 is used internally */
|
|
|
|
CLUTTER_SUPER_MASK = 1 << 26,
|
|
CLUTTER_HYPER_MASK = 1 << 27,
|
|
CLUTTER_META_MASK = 1 << 28,
|
|
|
|
CLUTTER_RELEASE_MASK = 1 << 30,
|
|
|
|
CLUTTER_MODIFIER_MASK = 0x5c001fff
|
|
} ClutterModifierType;
|
|
|
|
/**
|
|
* ClutterEventFlags:
|
|
* @CLUTTER_EVENT_NONE: No flag set
|
|
* @CLUTTER_EVENT_FLAG_SYNTHETIC: Synthetic event
|
|
*
|
|
* Flags for the #ClutterEvent
|
|
*
|
|
* Since: 0.6
|
|
*/
|
|
typedef enum {
|
|
CLUTTER_EVENT_NONE = 0,
|
|
CLUTTER_EVENT_FLAG_SYNTHETIC = 1 << 0,
|
|
} ClutterEventFlags;
|
|
|
|
/**
|
|
* ClutterEventType:
|
|
* @CLUTTER_NOTHING: Empty event
|
|
* @CLUTTER_KEY_PRESS: Key press event
|
|
* @CLUTTER_KEY_RELEASE: Key release event
|
|
* @CLUTTER_MOTION: Pointer motion event
|
|
* @CLUTTER_ENTER: Actor enter event
|
|
* @CLUTTER_LEAVE: Actor leave event
|
|
* @CLUTTER_BUTTON_PRESS: Pointer button press event
|
|
* @CLUTTER_BUTTON_RELEASE: Pointer button release event
|
|
* @CLUTTER_SCROLL: Pointer scroll event
|
|
* @CLUTTER_STAGE_STATE: Stage stage change event
|
|
* @CLUTTER_DESTROY_NOTIFY: Destroy notification event
|
|
* @CLUTTER_CLIENT_MESSAGE: Client message event
|
|
* @CLUTTER_DELETE: Stage delete event
|
|
*
|
|
* Types of events.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
typedef enum
|
|
{
|
|
CLUTTER_NOTHING = 0,
|
|
CLUTTER_KEY_PRESS,
|
|
CLUTTER_KEY_RELEASE,
|
|
CLUTTER_MOTION,
|
|
CLUTTER_ENTER,
|
|
CLUTTER_LEAVE,
|
|
CLUTTER_BUTTON_PRESS,
|
|
CLUTTER_BUTTON_RELEASE,
|
|
CLUTTER_SCROLL,
|
|
CLUTTER_STAGE_STATE,
|
|
CLUTTER_DESTROY_NOTIFY,
|
|
CLUTTER_CLIENT_MESSAGE,
|
|
CLUTTER_DELETE
|
|
} ClutterEventType;
|
|
|
|
/**
|
|
* ClutterScrollDirection:
|
|
* @CLUTTER_SCROLL_UP: Scroll up
|
|
* @CLUTTER_SCROLL_DOWN: Scroll down
|
|
* @CLUTTER_SCROLL_LEFT: Scroll left
|
|
* @CLUTTER_SCROLL_RIGHT: Scroll right
|
|
*
|
|
* Direction of a pointer scroll event.
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
typedef enum
|
|
{
|
|
CLUTTER_SCROLL_UP,
|
|
CLUTTER_SCROLL_DOWN,
|
|
CLUTTER_SCROLL_LEFT,
|
|
CLUTTER_SCROLL_RIGHT
|
|
} ClutterScrollDirection;
|
|
|
|
/**
|
|
* ClutterStageState:
|
|
* @CLUTTER_STAGE_STATE_FULLSCREEN: Fullscreen mask
|
|
* @CLUTTER_STAGE_STATE_OFFSCREEN: Offscreen mask
|
|
* @CLUTTER_STAGE_STATE_ACTIVATED: Activated mask
|
|
*
|
|
* Stage state masks
|
|
*
|
|
* Since: 0.4
|
|
*/
|
|
typedef enum
|
|
{
|
|
CLUTTER_STAGE_STATE_FULLSCREEN = (1<<1),
|
|
CLUTTER_STAGE_STATE_OFFSCREEN = (1<<2),
|
|
CLUTTER_STAGE_STATE_ACTIVATED = (1<<3)
|
|
} ClutterStageState;
|
|
|
|
typedef union _ClutterEvent ClutterEvent;
|
|
|
|
typedef struct _ClutterAnyEvent ClutterAnyEvent;
|
|
typedef struct _ClutterButtonEvent ClutterButtonEvent;
|
|
typedef struct _ClutterKeyEvent ClutterKeyEvent;
|
|
typedef struct _ClutterMotionEvent ClutterMotionEvent;
|
|
typedef struct _ClutterScrollEvent ClutterScrollEvent;
|
|
typedef struct _ClutterStageStateEvent ClutterStageStateEvent;
|
|
typedef struct _ClutterCrossingEvent ClutterCrossingEvent;
|
|
|
|
/**
|
|
* ClutterInputDevice:
|
|
*
|
|
* Generic representation of an input device. The
|
|
* actual contents of this structure depend on the
|
|
* backend used.
|
|
*/
|
|
typedef struct _ClutterInputDevice ClutterInputDevice;
|
|
|
|
/**
|
|
* ClutterInputDeviceType:
|
|
* @CLUTTER_POINTER_DEVICE: A pointer device
|
|
* @CLUTTER_KEYBOARD_DEVICE: A keyboard device
|
|
* @CLUTTER_EXTENSION_DEVICE: A generic extension device
|
|
* @CLUTTER_N_DEVICE_TYPES: The number of device types
|
|
*
|
|
* The types of input devices available.
|
|
*
|
|
* The #ClutterInputDeviceType enumeration can be extended at later
|
|
* date; not every platform supports every input device type.
|
|
*
|
|
* Since: 1.0
|
|
*/
|
|
typedef enum {
|
|
CLUTTER_POINTER_DEVICE,
|
|
CLUTTER_KEYBOARD_DEVICE,
|
|
CLUTTER_EXTENSION_DEVICE,
|
|
|
|
CLUTTER_N_DEVICE_TYPES
|
|
} ClutterInputDeviceType;
|
|
|
|
/**
|
|
* ClutterAnyEvent:
|
|
* @type: event type
|
|
* @time: event time
|
|
* @flags: event flags
|
|
* @source: event source actor
|
|
*
|
|
* Common members for a #ClutterEvent
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
struct _ClutterAnyEvent
|
|
{
|
|
ClutterEventType type;
|
|
guint32 time;
|
|
ClutterEventFlags flags;
|
|
ClutterStage *stage;
|
|
ClutterActor *source;
|
|
};
|
|
|
|
/**
|
|
* ClutterKeyEvent:
|
|
* @type: event type
|
|
* @time: event time
|
|
* @flags: event flags
|
|
* @stage: event source stage
|
|
* @source: event source actor
|
|
* @modifier_state: key modifiers
|
|
* @keyval: raw key value
|
|
* @hardware_keycode: raw hardware key value
|
|
* @unicode_value: Unicode representation
|
|
* @device: reserved for future use
|
|
*
|
|
* Key event
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
struct _ClutterKeyEvent
|
|
{
|
|
ClutterEventType type;
|
|
guint32 time;
|
|
ClutterEventFlags flags;
|
|
ClutterStage *stage;
|
|
ClutterActor *source;
|
|
|
|
ClutterModifierType modifier_state;
|
|
guint keyval;
|
|
guint16 hardware_keycode;
|
|
gunichar unicode_value;
|
|
ClutterInputDevice *device;
|
|
};
|
|
|
|
/**
|
|
* ClutterButtonEvent:
|
|
* @type: event type
|
|
* @time: event time
|
|
* @flags: event flags
|
|
* @stage: event source stage
|
|
* @source: event source actor
|
|
* @x: event X coordinate, relative to the stage
|
|
* @y: event Y coordinate, relative to the stage
|
|
* @modifier_state: button modifiers
|
|
* @button: event button
|
|
* @click_count: number of button presses within the default time
|
|
* and radius
|
|
* @axes: reserved for future use
|
|
* @device: reserved for future use
|
|
*
|
|
* Button event.
|
|
*
|
|
* The event coordinates are relative to the stage that received the
|
|
* event, and can be transformed into actor-relative coordinates by
|
|
* using clutter_actor_transform_stage_point().
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
struct _ClutterButtonEvent
|
|
{
|
|
ClutterEventType type;
|
|
guint32 time;
|
|
ClutterEventFlags flags;
|
|
ClutterStage *stage;
|
|
ClutterActor *source;
|
|
|
|
gfloat x;
|
|
gfloat y;
|
|
ClutterModifierType modifier_state;
|
|
guint32 button;
|
|
guint click_count;
|
|
gdouble *axes; /* Future use */
|
|
ClutterInputDevice *device;
|
|
};
|
|
|
|
/**
|
|
* ClutterCrossingEvent:
|
|
* @type: event type
|
|
* @time: event time
|
|
* @flags: event flags
|
|
* @stage: event source stage
|
|
* @source: event source actor
|
|
* @x: event X coordinate
|
|
* @y: event Y coordinate
|
|
* @related: actor related to the crossing
|
|
* @device: reserved for future use
|
|
*
|
|
* Event for the movement of the pointer across different actors
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
struct _ClutterCrossingEvent
|
|
{
|
|
ClutterEventType type;
|
|
guint32 time;
|
|
ClutterEventFlags flags;
|
|
ClutterStage *stage;
|
|
ClutterActor *source;
|
|
|
|
gfloat x;
|
|
gfloat y;
|
|
ClutterInputDevice *device;
|
|
ClutterActor *related;
|
|
};
|
|
|
|
/**
|
|
* ClutterMotionEvent:
|
|
* @type: event type
|
|
* @time: event time
|
|
* @flags: event flags
|
|
* @stage: event source stage
|
|
* @source: event source actor
|
|
* @x: event X coordinate
|
|
* @y: event Y coordinate
|
|
* @modifier_state: button modifiers
|
|
* @axes: reserved for future use
|
|
* @device: reserved for future use
|
|
*
|
|
* Event for the pointer motion
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
struct _ClutterMotionEvent
|
|
{
|
|
ClutterEventType type;
|
|
guint32 time;
|
|
ClutterEventFlags flags;
|
|
ClutterStage *stage;
|
|
ClutterActor *source;
|
|
|
|
gfloat x;
|
|
gfloat y;
|
|
ClutterModifierType modifier_state;
|
|
gdouble *axes; /* Future use */
|
|
ClutterInputDevice *device;
|
|
};
|
|
|
|
/**
|
|
* ClutterScrollEvent:
|
|
* @type: event type
|
|
* @time: event time
|
|
* @flags: event flags
|
|
* @stage: event source stage
|
|
* @source: event source actor
|
|
* @x: event X coordinate
|
|
* @y: event Y coordinate
|
|
* @direction: direction of the scrolling
|
|
* @modifier_state: button modifiers
|
|
* @axes: reserved for future use
|
|
* @device: reserved for future use
|
|
*
|
|
* Scroll wheel (or similar device) event
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
struct _ClutterScrollEvent
|
|
{
|
|
ClutterEventType type;
|
|
guint32 time;
|
|
ClutterEventFlags flags;
|
|
ClutterStage *stage;
|
|
ClutterActor *source;
|
|
|
|
gfloat x;
|
|
gfloat y;
|
|
ClutterScrollDirection direction;
|
|
ClutterModifierType modifier_state;
|
|
gdouble *axes; /* future use */
|
|
ClutterInputDevice *device;
|
|
};
|
|
|
|
/**
|
|
* ClutterStageStateEvent:
|
|
* @type: event type
|
|
* @time: event time
|
|
* @flags: event flags
|
|
* @stage: event source stage
|
|
* @source: event source actor (unused)
|
|
* @changed_mask: bitwise OR of the changed flags
|
|
* @new_state: bitwise OR of the current state flags
|
|
*
|
|
* Event signalling a change in the #ClutterStage state.
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
struct _ClutterStageStateEvent
|
|
{
|
|
ClutterEventType type;
|
|
guint32 time;
|
|
ClutterEventFlags flags;
|
|
ClutterStage *stage;
|
|
ClutterActor *source; /* XXX: should probably be the stage itself */
|
|
|
|
ClutterStageState changed_mask;
|
|
ClutterStageState new_state;
|
|
};
|
|
|
|
/**
|
|
* ClutterEvent:
|
|
* @type: event type
|
|
*
|
|
* Generic event wrapper.
|
|
*
|
|
* Since: 0.2
|
|
*/
|
|
union _ClutterEvent
|
|
{
|
|
ClutterEventType type;
|
|
|
|
ClutterAnyEvent any;
|
|
ClutterButtonEvent button;
|
|
ClutterKeyEvent key;
|
|
ClutterMotionEvent motion;
|
|
ClutterScrollEvent scroll;
|
|
ClutterStageStateEvent stage_state;
|
|
ClutterCrossingEvent crossing;
|
|
};
|
|
|
|
GType clutter_event_get_type (void) G_GNUC_CONST;
|
|
|
|
gboolean clutter_events_pending (void);
|
|
ClutterEvent * clutter_event_get (void);
|
|
ClutterEvent * clutter_event_peek (void);
|
|
void clutter_event_put (ClutterEvent *event);
|
|
|
|
ClutterEvent * clutter_event_new (ClutterEventType type);
|
|
ClutterEvent * clutter_event_copy (ClutterEvent *event);
|
|
void clutter_event_free (ClutterEvent *event);
|
|
|
|
ClutterEventType clutter_event_type (ClutterEvent *event);
|
|
ClutterEventFlags clutter_event_get_flags (ClutterEvent *event);
|
|
guint32 clutter_event_get_time (ClutterEvent *event);
|
|
ClutterModifierType clutter_event_get_state (ClutterEvent *event);
|
|
gint clutter_event_get_device_id (ClutterEvent *event);
|
|
ClutterInputDeviceType clutter_event_get_device_type (ClutterEvent *event);
|
|
ClutterInputDevice * clutter_event_get_device (ClutterEvent *event);
|
|
ClutterActor * clutter_event_get_source (ClutterEvent *event);
|
|
ClutterStage * clutter_event_get_stage (ClutterEvent *event);
|
|
|
|
void clutter_event_get_coords (ClutterEvent *event,
|
|
gfloat *x,
|
|
gfloat *y);
|
|
|
|
guint clutter_event_get_key_symbol (ClutterEvent *event);
|
|
guint16 clutter_event_get_key_code (ClutterEvent *event);
|
|
guint32 clutter_event_get_key_unicode (ClutterEvent *event);
|
|
|
|
guint32 clutter_event_get_button (ClutterEvent *event);
|
|
guint clutter_event_get_click_count (ClutterEvent *event);
|
|
|
|
ClutterActor * clutter_event_get_related (ClutterEvent *event);
|
|
|
|
ClutterScrollDirection clutter_event_get_scroll_direction (ClutterEvent *event);
|
|
|
|
guint32 clutter_keysym_to_unicode (guint keyval);
|
|
|
|
guint32 clutter_get_current_event_time (void);
|
|
|
|
ClutterInputDeviceType clutter_input_device_get_device_type (ClutterInputDevice *device);
|
|
gint clutter_input_device_get_device_id (ClutterInputDevice *device);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __CLUTTER_EVENT_H__ */
|