brl/mutter
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

cursor-tracker: Enhance the documentation and increase annotation coverage

Browse Source 
Add the (optional) parameters when they are actually supported and at least add
the minimal documentation on functions.

Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/2951>
This commit is contained in:
Corentin Noël 2023-04-07 11:04:32 +02:00
parent 776e3f329d
commit eeee654031
2 changed files with 27 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
clutter/clutter/clutter-seat.c
View File

@ -679,6 +679,17 @@ clutter_seat_has_touchscreen (ClutterSeat *seat)
return has_touchscreen; return has_touchscreen;
} }
/**
* clutter_seat_query_state:
* @seat: a #ClutterSeat
* @device: a #ClutterInputDevice
* @sequence: (nullable): a #ClutterEventSequence
* @coords: (out caller-allocates) (optional): the coordinates of the pointer
* @modifiers: (out) (optional): the current #ClutterModifierType of the pointer
*
* Returns: %TRUE if @device (or the specific @sequence) is on the stage, %FALSE
* otherwise.
**/
gboolean gboolean
clutter_seat_query_state (ClutterSeat *seat, clutter_seat_query_state (ClutterSeat *seat,
ClutterInputDevice *device, ClutterInputDevice *device,

26
src/backends/meta-cursor-tracker.c
View File

@ -319,7 +319,7 @@ meta_cursor_tracker_class_init (MetaCursorTrackerClass *klass)
* *
* Retrieves the cursor tracker object for @display. * Retrieves the cursor tracker object for @display.
* *
* Returns: (transfer none): * Returns: (transfer none): the cursor tracker object for @display.
*/ */
MetaCursorTracker * MetaCursorTracker *
meta_cursor_tracker_get_for_display (MetaDisplay *display) meta_cursor_tracker_get_for_display (MetaDisplay *display)
@ -350,8 +350,11 @@ set_window_cursor (MetaCursorTracker *tracker,
/** /**
* meta_cursor_tracker_get_sprite: * meta_cursor_tracker_get_sprite:
* @tracker: a #MetaCursorTracker
* *
* Returns: (transfer none): * Get the #CoglTexture of the cursor sprite
*
* Returns: (transfer none) (nullable): the #CoglTexture of the cursor sprite
*/ */
CoglTexture * CoglTexture *
meta_cursor_tracker_get_sprite (MetaCursorTracker *tracker) meta_cursor_tracker_get_sprite (MetaCursorTracker *tracker)
@ -369,9 +372,11 @@ meta_cursor_tracker_get_sprite (MetaCursorTracker *tracker)
/** /**
* meta_cursor_tracker_get_scale: * meta_cursor_tracker_get_scale:
* @tracker: * @tracker: a #MetaCursorTracker
* *
* Returns: * Get the scale factor of the cursor sprite
*
* Returns: The scale factor of the cursor sprite
*/ */
float float
meta_cursor_tracker_get_scale (MetaCursorTracker *tracker) meta_cursor_tracker_get_scale (MetaCursorTracker *tracker)
@ -388,10 +393,11 @@ meta_cursor_tracker_get_scale (MetaCursorTracker *tracker)
/** /**
* meta_cursor_tracker_get_hot: * meta_cursor_tracker_get_hot:
* @tracker: * @tracker: a #MetaCursorTracker
* @x: (out): * @x: (out): the x coordinate of the cursor hotspot
* @y: (out): * @y: (out): the y coordinate of the cursor hotspot
* *
* Get the hotspot of the current cursor sprite.
*/ */
void void
meta_cursor_tracker_get_hot (MetaCursorTracker *tracker, meta_cursor_tracker_get_hot (MetaCursorTracker *tracker,
@ -431,7 +437,7 @@ meta_cursor_tracker_unset_window_cursor (MetaCursorTracker *tracker)
/** /**
* meta_cursor_tracker_set_root_cursor: * meta_cursor_tracker_set_root_cursor:
* @tracker: a #MetaCursorTracker object. * @tracker: a #MetaCursorTracker object.
* @cursor_sprite: (transfer none): the new root cursor * @cursor_sprite: (transfer none) (nullable): the new root cursor
* *
* Sets the root cursor (the cursor that is shown if not modified by a window). * Sets the root cursor (the cursor that is shown if not modified by a window).
* The #MetaCursorTracker will take a strong reference to the sprite. * The #MetaCursorTracker will take a strong reference to the sprite.
@ -459,8 +465,8 @@ meta_cursor_tracker_invalidate_position (MetaCursorTracker *tracker)
/** /**
* meta_cursor_tracker_get_pointer: * meta_cursor_tracker_get_pointer:
* @tracker: a #MetaCursorTracker object * @tracker: a #MetaCursorTracker object
* @coords: (out caller-allocates): the coordinates of the pointer * @coords: (out caller-allocates) (optional): the coordinates of the pointer
* @mods: (out): the current #ClutterModifierType of the pointer * @mods: (out) (optional): the current #ClutterModifierType of the pointer
* *
* Get the current pointer position and state. * Get the current pointer position and state.
*/ */