2006-05-29 04:59:36 -04:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
clutter-event
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
2006-12-05 00:16:03 -05:00
|
|
|
User and window system event functionality
|
2006-05-29 04:59:36 -04:00
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
2006-12-05 00:16:03 -05:00
|
|
|
Windowing events handled by Clutter.
|
2006-05-29 04:59:36 -04:00
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
<!-- ##### MACRO CLUTTER_CURRENT_TIME ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO CLUTTER_PRIORITY_EVENTS ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### USER_FUNCTION ClutterFilterFunc ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
@data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### ENUM ClutterFilterResponse ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@CLUTTER_FILTER_CONTINUE:
|
|
|
|
@CLUTTER_FILTER_REMOVE:
|
|
|
|
|
|
|
|
<!-- ##### ENUM ClutterScrollDirection ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@CLUTTER_SCROLL_UP:
|
|
|
|
@CLUTTER_SCROLL_DOWN:
|
|
|
|
@CLUTTER_SCROLL_LEFT:
|
|
|
|
@CLUTTER_SCROLL_RIGHT:
|
|
|
|
|
|
|
|
<!-- ##### STRUCT ClutterScrollEvent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type:
|
|
|
|
@time:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@direction:
|
|
|
|
@modifier_state:
|
|
|
|
@axes:
|
|
|
|
@device:
|
|
|
|
|
|
|
|
<!-- ##### ENUM ClutterStageState ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@CLUTTER_STAGE_STATE_FULLSCREEN:
|
|
|
|
@CLUTTER_STAGE_STATE_MAXIMIZED:
|
|
|
|
@CLUTTER_STAGE_STATE_MINIMIZED:
|
|
|
|
@CLUTTER_STAGE_STATE_OFFSCREEN:
|
|
|
|
|
2006-05-29 04:59:36 -04:00
|
|
|
<!-- ##### ENUM ClutterEventType ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-06-05 Emmanuele Bassi <ebassi@openedhand.com>
* clutter-color.h:
* clutter-color.c: Reimplement ClutterColor as a boxed type;
add convenience API for color handling, like: add, subtract,
shade, HSL color-space conversion, packing and unpacking.
* clutter-private.h: Update ClutterMainContext, and export the
main context pointer here.
* clutter-rectangle.h:
* clutter-rectangle.c: Update the color-related code; make
clutter_rectangle_new() and empty constructor and provide
clutter_rectangle_new_with_color(); provide color setter
and getter API.
* clutter-label.h:
* clutter-label.c: Rename the "font" property to "font-name";
update the color-related code to the new ClutterColor object;
rename clutter_label_new() to clutter_label_new_with_text(),
and add setters and getters for the properties.
* clutter-marshal.list: Add VOID:OBJECT and VOID:BOXED marshallers
generators.
* clutter-stage.h:
* clutter-stage.c: Rework the API: provide a default constructor
for a singleton object, named clutter_stage_get_default(), which
supercedes the clutter_stage() function in clutter-main; provide
new events: button-press-event, button-release-event,
key-press-event and key-release-event; update the color-related
code;
(clutter_stage_snapshot): Allow negative width and height when
taking a snapshot (meaning: use full width/height).
(clutter_stage_get_element_at_pos): Rename clutter_stage_pick().
* clutter-element.c (clutter_element_paint): Clean up the
stage and color related code.
* clutter-event.h:
* clutter-event.c: Add generic ClutterAnyEvent type; add
clutter_event_new(), clutter_event_copy() and clutter_event_free();
make ClutterEvent a boxed type.
* clutter-main.h:
* clutter-main.c: Remove clutter_stage(); add clutter_main_quit(),
for cleanly quitting from clutter_main(); add multiple mainloops
support; allocate the ClutterCntx instead of adding it to the
stack; re-work the ClutterEvent dispatching.
* clutter-group.c (clutter_group_add), (clutter_group_remove): Keep
a reference on the element when added to a ClutterGroup.
* examples/rects.py
* examples/test.c:
* examples/test-text.c:
* examples/video-cube.c:
* examples/super-oh.c:
* examples/test-video.c: Update.
2006-06-05 09:38:31 -04:00
|
|
|
@CLUTTER_NOTHING:
|
2006-05-29 04:59:36 -04:00
|
|
|
@CLUTTER_KEY_PRESS:
|
|
|
|
@CLUTTER_KEY_RELEASE:
|
|
|
|
@CLUTTER_MOTION:
|
|
|
|
@CLUTTER_BUTTON_PRESS:
|
|
|
|
@CLUTTER_2BUTTON_PRESS:
|
2007-03-22 16:23:29 -04:00
|
|
|
@CLUTTER_3BUTTON_PRESS:
|
2006-05-29 04:59:36 -04:00
|
|
|
@CLUTTER_BUTTON_RELEASE:
|
2007-03-22 16:23:29 -04:00
|
|
|
@CLUTTER_SCROLL:
|
2007-03-22 14:21:59 -04:00
|
|
|
@CLUTTER_STAGE_STATE:
|
2007-03-22 16:23:29 -04:00
|
|
|
@CLUTTER_DESTROY_NOTIFY:
|
2006-05-29 04:59:36 -04:00
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
<!-- ##### UNION ClutterEvent ##### -->
|
2006-06-21 18:34:25 -04:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
<!-- ##### STRUCT ClutterAnyEvent ##### -->
|
2006-05-29 04:59:36 -04:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type:
|
|
|
|
|
|
|
|
<!-- ##### STRUCT ClutterButtonEvent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type:
|
|
|
|
@time:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@modifier_state:
|
|
|
|
@button:
|
|
|
|
@axes:
|
|
|
|
@device:
|
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
<!-- ##### STRUCT ClutterKeyEvent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type:
|
|
|
|
@time:
|
|
|
|
@modifier_state:
|
|
|
|
@keyval:
|
|
|
|
@hardware_keycode:
|
|
|
|
|
2006-05-29 04:59:36 -04:00
|
|
|
<!-- ##### STRUCT ClutterMotionEvent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type:
|
|
|
|
@time:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@modifier_state:
|
|
|
|
@axes:
|
|
|
|
@device:
|
|
|
|
|
2007-03-23 05:59:02 -04:00
|
|
|
<!-- ##### STRUCT ClutterScrollEvent ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type:
|
|
|
|
@time:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
@direction:
|
|
|
|
@modifier_state:
|
|
|
|
@axes:
|
|
|
|
@device:
|
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
<!-- ##### STRUCT ClutterStageStateEvent ##### -->
|
2006-05-29 04:59:36 -04:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
@type:
|
|
|
|
@changed_mask:
|
|
|
|
@new_state:
|
2006-05-29 04:59:36 -04:00
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
<!-- ##### STRUCT ClutterInputDevice ##### -->
|
2006-05-29 04:59:36 -04:00
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
2006-06-21 18:34:25 -04:00
|
|
|
<!-- ##### FUNCTION clutter_event_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@type:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_event_copy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_event_free ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
|
|
|
|
|
2006-12-13 13:11:50 -05:00
|
|
|
<!-- ##### FUNCTION clutter_event_type ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2007-03-22 16:23:29 -04:00
|
|
|
<!-- ##### FUNCTION clutter_event_get_coords ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
@x:
|
|
|
|
@y:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_event_get_state ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_event_get_time ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_event_get ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_event_peek ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_event_put ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@event:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_events_pending ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_button_event_button ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@buttev:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2006-05-29 04:59:36 -04:00
|
|
|
<!-- ##### FUNCTION clutter_key_event_symbol ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@keyev:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_key_event_code ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@keyev:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_key_event_unicode ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@keyev:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_keysym_to_unicode ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@keyval:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|