mirror of
https://github.com/brl/mutter.git
synced 2024-11-30 03:50:47 -05:00
e917b7de43
An input only grab is a ClutterGrab on the stage that doesn't have an explicit actor associated with it. This is useful for cases where event should be captured as if focus was stolen to some mysterious place that doesn't have anything in the scene graph that represents it. Internally, it's implemented using a 0x0 sized actor attached directly to the stage, and a clutter action that consumes the events. An input-only grab takes a handler, user data and a destroy function for the user data. These are handed to the ClutterAction, which handles the actual event handling. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/2628>
177 lines
9.3 KiB
C
177 lines
9.3 KiB
C
/*
|
|
* Clutter.
|
|
*
|
|
* An OpenGL based 'interactive canvas' library.
|
|
*
|
|
* Copyright (C) 2010 Intel Corporation.
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
#ifndef __CLUTTER_STAGE_PRIVATE_H__
|
|
#define __CLUTTER_STAGE_PRIVATE_H__
|
|
|
|
#include <clutter/clutter-grab.h>
|
|
#include <clutter/clutter-stage-window.h>
|
|
#include <clutter/clutter-stage.h>
|
|
#include <clutter/clutter-input-device.h>
|
|
#include <clutter/clutter-private.h>
|
|
|
|
#include <cogl/cogl.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
typedef gboolean (* ClutterEventHandler) (const ClutterEvent *event,
|
|
gpointer user_data);
|
|
typedef enum
|
|
{
|
|
CLUTTER_DEVICE_UPDATE_NONE = 0,
|
|
CLUTTER_DEVICE_UPDATE_EMIT_CROSSING = 1 << 0,
|
|
CLUTTER_DEVICE_UPDATE_IGNORE_CACHE = 1 << 1,
|
|
} ClutterDeviceUpdateFlags;
|
|
|
|
/* stage */
|
|
ClutterStageWindow *_clutter_stage_get_default_window (void);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_stage_paint_view (ClutterStage *stage,
|
|
ClutterStageView *view,
|
|
const cairo_region_t *redraw_clip,
|
|
ClutterFrame *frame);
|
|
|
|
void clutter_stage_emit_before_update (ClutterStage *stage,
|
|
ClutterStageView *view,
|
|
ClutterFrame *frame);
|
|
void clutter_stage_emit_prepare_frame (ClutterStage *stage,
|
|
ClutterStageView *view,
|
|
ClutterFrame *frame);
|
|
void clutter_stage_emit_before_paint (ClutterStage *stage,
|
|
ClutterStageView *view,
|
|
ClutterFrame *frame);
|
|
void clutter_stage_emit_after_paint (ClutterStage *stage,
|
|
ClutterStageView *view,
|
|
ClutterFrame *frame);
|
|
void clutter_stage_after_update (ClutterStage *stage,
|
|
ClutterStageView *view,
|
|
ClutterFrame *frame);
|
|
|
|
CLUTTER_EXPORT
|
|
void _clutter_stage_set_window (ClutterStage *stage,
|
|
ClutterStageWindow *stage_window);
|
|
CLUTTER_EXPORT
|
|
ClutterStageWindow *_clutter_stage_get_window (ClutterStage *stage);
|
|
void _clutter_stage_get_projection_matrix (ClutterStage *stage,
|
|
graphene_matrix_t *projection);
|
|
void _clutter_stage_dirty_projection (ClutterStage *stage);
|
|
void _clutter_stage_get_viewport (ClutterStage *stage,
|
|
float *x,
|
|
float *y,
|
|
float *width,
|
|
float *height);
|
|
void _clutter_stage_dirty_viewport (ClutterStage *stage);
|
|
CLUTTER_EXPORT
|
|
void _clutter_stage_maybe_setup_viewport (ClutterStage *stage,
|
|
ClutterStageView *view);
|
|
void clutter_stage_maybe_relayout (ClutterActor *stage);
|
|
GSList * clutter_stage_find_updated_devices (ClutterStage *stage,
|
|
ClutterStageView *view);
|
|
void clutter_stage_update_devices (ClutterStage *stage,
|
|
GSList *devices);
|
|
void clutter_stage_finish_layout (ClutterStage *stage);
|
|
|
|
CLUTTER_EXPORT
|
|
void _clutter_stage_queue_event (ClutterStage *stage,
|
|
ClutterEvent *event,
|
|
gboolean copy_event);
|
|
gboolean _clutter_stage_has_queued_events (ClutterStage *stage);
|
|
void _clutter_stage_process_queued_events (ClutterStage *stage);
|
|
void _clutter_stage_update_input_devices (ClutterStage *stage);
|
|
gboolean _clutter_stage_has_full_redraw_queued (ClutterStage *stage);
|
|
|
|
ClutterPaintVolume *_clutter_stage_paint_volume_stack_allocate (ClutterStage *stage);
|
|
void _clutter_stage_paint_volume_stack_free_all (ClutterStage *stage);
|
|
|
|
void _clutter_stage_set_scale_factor (ClutterStage *stage,
|
|
int factor);
|
|
|
|
void clutter_stage_presented (ClutterStage *stage,
|
|
ClutterStageView *view,
|
|
ClutterFrameInfo *frame_info);
|
|
|
|
void clutter_stage_queue_actor_relayout (ClutterStage *stage,
|
|
ClutterActor *actor);
|
|
|
|
void clutter_stage_dequeue_actor_relayout (ClutterStage *stage,
|
|
ClutterActor *actor);
|
|
|
|
GList * clutter_stage_get_views_for_rect (ClutterStage *stage,
|
|
const graphene_rect_t *rect);
|
|
|
|
void clutter_stage_set_actor_needs_immediate_relayout (ClutterStage *stage);
|
|
|
|
void clutter_stage_update_device_entry (ClutterStage *self,
|
|
ClutterInputDevice *device,
|
|
ClutterEventSequence *sequence,
|
|
graphene_point_t coords,
|
|
ClutterActor *actor,
|
|
cairo_region_t *clear_area);
|
|
|
|
void clutter_stage_remove_device_entry (ClutterStage *self,
|
|
ClutterInputDevice *device,
|
|
ClutterEventSequence *sequence);
|
|
ClutterActor * clutter_stage_pick_and_update_device (ClutterStage *stage,
|
|
ClutterInputDevice *device,
|
|
ClutterEventSequence *sequence,
|
|
ClutterInputDevice *source_device,
|
|
ClutterDeviceUpdateFlags flags,
|
|
graphene_point_t point,
|
|
uint32_t time_ms);
|
|
|
|
void clutter_stage_unlink_grab (ClutterStage *self,
|
|
ClutterGrab *grab);
|
|
|
|
void clutter_stage_invalidate_focus (ClutterStage *self,
|
|
ClutterActor *actor);
|
|
|
|
void clutter_stage_maybe_invalidate_focus (ClutterStage *self,
|
|
ClutterActor *actor);
|
|
|
|
void clutter_stage_emit_event (ClutterStage *self,
|
|
const ClutterEvent *event);
|
|
|
|
void clutter_stage_maybe_lost_implicit_grab (ClutterStage *self,
|
|
ClutterInputDevice *device,
|
|
ClutterEventSequence *sequence);
|
|
|
|
void clutter_stage_implicit_grab_actor_unmapped (ClutterStage *self,
|
|
ClutterActor *actor);
|
|
|
|
CLUTTER_EXPORT_TEST
|
|
void clutter_stage_notify_action_implicit_grab (ClutterStage *self,
|
|
ClutterInputDevice *device,
|
|
ClutterEventSequence *sequence);
|
|
|
|
void clutter_stage_add_to_redraw_clip (ClutterStage *self,
|
|
ClutterPaintVolume *clip);
|
|
|
|
CLUTTER_EXPORT
|
|
ClutterGrab * clutter_stage_grab_input_only (ClutterStage *self,
|
|
ClutterEventHandler handler,
|
|
gpointer user_data,
|
|
GDestroyNotify user_data_destroy);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __CLUTTER_STAGE_PRIVATE_H__ */
|