| Clutter 0.8.8 Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
#define CLUTTER_CURRENT_TIME #define CLUTTER_PRIORITY_EVENTS enum ClutterModifierType; enum ClutterScrollDirection; enum ClutterStageState; enum ClutterEventType; union ClutterEvent; enum ClutterEventFlags; ClutterButtonEvent; ClutterKeyEvent; ClutterMotionEvent; ClutterScrollEvent; ClutterStageStateEvent; ClutterCrossingEvent; ClutterInputDevice; ClutterEvent * clutter_event_new (ClutterEventType type); ClutterEvent * clutter_event_copy (ClutterEvent *event); void clutter_event_free (ClutterEvent *event); ClutterEventType clutter_event_type (ClutterEvent *event); void clutter_event_get_coords (ClutterEvent *event, gint *x, gint *y); ClutterModifierType clutter_event_get_state (ClutterEvent *event); guint32 clutter_event_get_time (ClutterEvent *event); ClutterActor* clutter_event_get_source (ClutterEvent *event); ClutterStage* clutter_event_get_stage (ClutterEvent *event); ClutterEvent * clutter_event_get (void); ClutterEvent * clutter_event_peek (void); void clutter_event_put (ClutterEvent *event); gboolean clutter_events_pending (void); guint32 clutter_button_event_button (ClutterButtonEvent *buttev); guint clutter_key_event_symbol (ClutterKeyEvent *keyev); guint16 clutter_key_event_code (ClutterKeyEvent *keyev); guint32 clutter_key_event_unicode (ClutterKeyEvent *keyev); guint32 clutter_keysym_to_unicode (guint keyval); gint clutter_event_get_device_id (ClutterEvent *event); ClutterInputDevice* clutter_get_input_device_for_id (gint id);
#define CLUTTER_PRIORITY_EVENTS (G_PRIORITY_DEFAULT)
Priority for event handling.
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
} ClutterModifierType;
Masks applied to a ClutterEvent by modifiers.
| Mask applied by the Shift key | |
| Mask applied by the Caps Lock key | |
| Mask applied by the Control key | |
| Mask applied by the first Mod key | |
| Mask applied by the second Mod key | |
| Mask applied by the third Mod key | |
| Mask applied by the fourth Mod key | |
| Mask applied by the fifth Mod key | |
| Mask applied by the first pointer button | |
| Mask applied by the second pointer button | |
| Mask applied by the third pointer button | |
| Mask applied by the fourth pointer button | |
| Mask applied by the fifth pointer button |
Since 0.4
typedef enum
{
CLUTTER_SCROLL_UP,
CLUTTER_SCROLL_DOWN,
CLUTTER_SCROLL_LEFT,
CLUTTER_SCROLL_RIGHT
} ClutterScrollDirection;
Direction of a pointer scroll event.
| Scroll up | |
| Scroll down | |
| Scroll left | |
| Scroll right |
Since 0.4
typedef enum
{
CLUTTER_STAGE_STATE_FULLSCREEN = (1<<1),
CLUTTER_STAGE_STATE_OFFSCREEN = (1<<2),
CLUTTER_STAGE_STATE_ACTIVATED = (1<<3)
} ClutterStageState;
Stage state masks
| Fullscreen mask | |
| Offscreen mask | |
| Activated mask |
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;
Types of events.
| Empty event | |
| Key press event | |
| Key release event | |
| Pointer motion event | |
| Actor enter event | |
| Actor leave event | |
| Pointer button press event | |
| Pointer button release event | |
| Pointer scroll event | |
| Stage stage change event | |
| Destroy notification event | |
| Client message event | |
| Stage delete event |
Since 0.4
union ClutterEvent
{
ClutterEventType type;
ClutterAnyEvent any;
ClutterButtonEvent button;
ClutterKeyEvent key;
ClutterMotionEvent motion;
ClutterScrollEvent scroll;
ClutterStageStateEvent stage_state;
ClutterCrossingEvent crossing;
};
Generic event wrapper.
Since 0.2
typedef enum {
CLUTTER_EVENT_FLAG_SYNTHETIC = 1 << 0,
} ClutterEventFlags;
Flags for the ClutterEvent
Since 0.6
typedef struct {
ClutterEventType type;
guint32 time;
ClutterEventFlags flags;
ClutterStage *stage;
ClutterActor *source;
gint x;
gint y;
ClutterModifierType modifier_state;
guint32 button;
guint click_count;
gdouble *axes; /* Future use */
ClutterInputDevice *device; /* Future use */
} ClutterButtonEvent;
Button event
ClutterEventType |
event type |
guint32 |
event time |
ClutterEventFlags |
event flags |
ClutterStage * |
event source stage |
ClutterActor * |
event source actor |
gint |
event X coordinate |
gint |
event Y coordinate |
ClutterModifierType |
button modifiers |
guint32 |
event button |
guint |
number of button presses within the default time and radius |
gdouble * |
reserved for future use |
ClutterInputDevice * |
reserved for future use |
Since 0.2
typedef struct {
ClutterEventType type;
guint32 time;
ClutterEventFlags flags;
ClutterStage *stage;
ClutterActor *source;
ClutterModifierType modifier_state;
guint keyval;
guint16 hardware_keycode;
gunichar unicode_value;
} ClutterKeyEvent;
Key event
ClutterEventType |
event type |
guint32 |
event time |
ClutterEventFlags |
event flags |
ClutterStage * |
event source stage |
ClutterActor * |
event source actor |
ClutterModifierType |
key modifiers |
guint |
raw key value |
guint16 |
raw hardware key value |
gunichar |
Unicode representation |
Since 0.2
typedef struct {
ClutterEventType type;
guint32 time;
ClutterEventFlags flags;
ClutterStage *stage;
ClutterActor *source;
gint x;
gint y;
ClutterModifierType modifier_state;
gdouble *axes; /* Future use */
ClutterInputDevice *device; /* Future use */
} ClutterMotionEvent;
Event for the pointer motion
ClutterEventType |
event type |
guint32 |
event time |
ClutterEventFlags |
event flags |
ClutterStage * |
event source stage |
ClutterActor * |
event source actor |
gint |
event X coordinate |
gint |
event Y coordinate |
ClutterModifierType |
button modifiers |
gdouble * |
reserved for future use |
ClutterInputDevice * |
reserved for future use |
Since 0.2
typedef struct {
ClutterEventType type;
guint32 time;
ClutterEventFlags flags;
ClutterStage *stage;
ClutterActor *source;
gint x;
gint y;
ClutterScrollDirection direction;
ClutterModifierType modifier_state;
gdouble *axes; /* future use */
ClutterInputDevice *device; /* future use */
} ClutterScrollEvent;
Scroll wheel (or similar device) event
ClutterEventType |
event type |
guint32 |
event time |
ClutterEventFlags |
event flags |
ClutterStage * |
event source stage |
ClutterActor * |
event source actor |
gint |
event X coordinate |
gint |
event Y coordinate |
ClutterScrollDirection |
direction of the scrolling |
ClutterModifierType |
button modifiers |
gdouble * |
reserved for future use |
ClutterInputDevice * |
reserved for future use |
Since 0.2
typedef struct {
ClutterEventType type;
guint32 time;
ClutterEventFlags flags;
ClutterStage *stage;
ClutterActor *source; /* unused XXX: should probably be the stage itself */
ClutterStageState changed_mask;
ClutterStageState new_state;
} ClutterStageStateEvent;
Event signalling a change in the ClutterStage state.
ClutterEventType |
event type |
guint32 |
event time |
ClutterEventFlags |
event flags |
ClutterStage * |
event source stage |
ClutterActor * |
event source actor (unused) |
ClutterStageState |
bitwise OR of the changed flags |
ClutterStageState |
bitwise OR of the current state flags |
Since 0.2
typedef struct {
ClutterEventType type;
guint32 time;
ClutterEventFlags flags;
ClutterStage *stage;
ClutterActor *source;
gint x;
gint y;
ClutterInputDevice *device; /* future use */
ClutterActor *related;
} ClutterCrossingEvent;
Event for the movement of the pointer across different actors
ClutterEventType |
event type |
guint32 |
event time |
ClutterEventFlags |
event flags |
ClutterStage * |
event source stage |
ClutterActor * |
event source actor |
gint |
event X coordinate |
gint |
event Y coordinate |
ClutterInputDevice * |
reserved for future use |
ClutterActor * |
actor related to the crossing |
Since 0.2
typedef struct _ClutterInputDevice ClutterInputDevice;
Generic representation of an input device. The actual contents of this structure depend on the backend used.
ClutterEvent * clutter_event_new (ClutterEventType type);
Creates a new ClutterEvent of the specified type.
|
The type of event. |
Returns : |
A newly allocated ClutterEvent. |
ClutterEvent * clutter_event_copy (ClutterEvent *event);
Copies event.
|
A ClutterEvent. |
Returns : |
A newly allocated ClutterEvent |
void clutter_event_free (ClutterEvent *event);
Frees all resources used by event.
|
A ClutterEvent. |
ClutterEventType clutter_event_type (ClutterEvent *event);
Retrieves the type of the event.
|
a ClutterEvent |
Returns : |
a ClutterEventType |
void clutter_event_get_coords (ClutterEvent *event, gint *x, gint *y);
Retrieves the coordinates of event and puts them into x and y.
|
a ClutterEvent |
|
return location for the X coordinate |
|
return location for the Y coordinate |
Since 0.4
ClutterModifierType clutter_event_get_state (ClutterEvent *event);
Retrieves the modifier state of the event.
|
a ClutterEvent |
Returns : |
the modifier state parameter, or 0 |
Since 0.4
guint32 clutter_event_get_time (ClutterEvent *event);
Retrieves the time of the event.
|
a ClutterEvent |
Returns : |
the time of the event, or CLUTTER_CURRENT_TIME
|
Since 0.4
ClutterActor* clutter_event_get_source (ClutterEvent *event);
Retrieves the source ClutterActor the event originated from, or NULL if the event has no source.
|
a ClutterEvent |
Returns : |
a ClutterActor |
Since 0.6
ClutterStage* clutter_event_get_stage (ClutterEvent *event);
Retrieves the source ClutterStage the event originated for, or NULL if the event has no stage.
|
a ClutterEvent |
Returns : |
a ClutterStage |
Since 0.8
ClutterEvent * clutter_event_get (void);
Pops an event off the event queue. Applications should not need to call this.
Returns : |
A ClutterEvent or NULL if queue empty |
Since 0.4
ClutterEvent * clutter_event_peek (void);
Returns a pointer to the first event from the event queue but does not remove it.
Returns : |
A ClutterEvent or NULL if queue empty. |
Since 0.4
void clutter_event_put (ClutterEvent *event);
Puts a copy of the event on the back of the event queue. The event will have the CLUTTER_EVENT_FLAG_SYNTHETIC flag set. If the source is set event signals will be emitted for this source and capture/bubbling for it's ancestors. If the source is not set it will be generated by picking or use the actor that currently has keyboard focus.
|
a ClutterEvent |
Since 0.6
gboolean clutter_events_pending (void);
Checks if events are pending in the event queue.
Returns : |
TRUE if there are pending events, FALSE otherwise. |
Since 0.4
guint32 clutter_button_event_button (ClutterButtonEvent *buttev);
Retrieve the button number of the event.
|
a ClutterButtonEvent |
Returns : |
the button number. |
Since 0.4
guint clutter_key_event_symbol (ClutterKeyEvent *keyev);
Retrieves the value of the key that caused keyev.
|
A ClutterKeyEvent |
Returns : |
The keysym representing the key |
guint16 clutter_key_event_code (ClutterKeyEvent *keyev);
Retrieves the keycode of the key that caused keyev.
|
A ClutterKeyEvent |
Returns : |
The keycode representing the key |
guint32 clutter_key_event_unicode (ClutterKeyEvent *keyev);
Retrieves the unicode value for the key that caused keyev.
|
A ClutterKeyEvent |
Returns : |
The unicode value representing the key |
guint32 clutter_keysym_to_unicode (guint keyval);
Convert from a Clutter key symbol to the corresponding ISO10646 (Unicode) character.
|
a clutter key symbol |
Returns : |
the corresponding unicode character, or 0 if there is no corresponding character. |
gint clutter_event_get_device_id (ClutterEvent *event);
Retrieves the events device id if set.
|
a clutter event |
Returns : |
A unique identifier for the device or -1 if the event has no specific device set. |
ClutterInputDevice* clutter_get_input_device_for_id (gint id);
Retrieves the ClutterInputDevice from its id.
|
a device id |
Returns : |
a ClutterInputDevice, or NULL
|
Since 0.8