mirror of
https://github.com/brl/mutter.git
synced 2024-09-20 14:35:48 -04:00
41e85f3073
ClutterEvent is not really gobject-introspection friendly because of the whole discriminated union thing. In particular, if you get a ClutterEvent in a signal handler, you probably can't access the event-type-specific fields, and you probably can't call methods like clutter_key_event_symbol() either, because you can't cast the ClutterEvent to a ClutterKeyEvent. The cleanest solution is to turn every accessor into ClutterEvent methods, accepting a ClutterEvent* and internally checking the event type. Fixes bug: http://bugzilla.openedhand.com/show_bug.cgi?id=1585
484 lines
13 KiB
C
484 lines
13 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;
|
|
|
|
/**
|
|
* 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; /* Future use */
|
|
};
|
|
|
|
/**
|
|
* 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; /* future use */
|
|
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; /* Future use */
|
|
};
|
|
|
|
/**
|
|
* 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; /* future use */
|
|
};
|
|
|
|
/**
|
|
* 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; /* unused 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);
|
|
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);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __CLUTTER_EVENT_H__ */
|