mirror of
https://github.com/brl/mutter.git
synced 2025-02-26 17:54:10 +00:00
d5f68c8140
A new variable scheduling mode is introduced which allows lower priority updates to be scheduled on a timeout which represents a lower refresh rate, while allowing high priority updates to be scheduled to occur as soon as possible. This mode will be used by following commits to implement synchronization of page flips to the update rate of specifc surface actors. High priorty updates are either scheduled to occur "now" if they arrive at a rate which is lower than the maximum refresh rate, or according to the measured maximum render time if they arrive at a rate which meets or exceeds the maximum refresh rate. This approach allows achieving low input latency in both scenarios. Seperate handling for low priority updates is needed to avoid visible stutter in the content of the surface that drives the refresh rate. An example for a low priority update is cursor movement when the KMS deadline timer is disabled. Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1154>
109 lines
3.9 KiB
C
109 lines
3.9 KiB
C
/*
|
|
* Copyright (C) 2019 Red Hat Inc.
|
|
*
|
|
* 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/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#if !defined(__CLUTTER_H_INSIDE__) && !defined(CLUTTER_COMPILATION)
|
|
#error "Only <clutter/clutter.h> can be included directly."
|
|
#endif
|
|
|
|
#include <glib.h>
|
|
#include <glib-object.h>
|
|
#include <stdint.h>
|
|
|
|
#include "clutter/clutter-types.h"
|
|
|
|
typedef enum _ClutterFrameResult
|
|
{
|
|
CLUTTER_FRAME_RESULT_PENDING_PRESENTED,
|
|
CLUTTER_FRAME_RESULT_IDLE,
|
|
} ClutterFrameResult;
|
|
|
|
#define CLUTTER_TYPE_FRAME_CLOCK (clutter_frame_clock_get_type ())
|
|
CLUTTER_EXPORT
|
|
G_DECLARE_FINAL_TYPE (ClutterFrameClock, clutter_frame_clock,
|
|
CLUTTER, FRAME_CLOCK,
|
|
GObject)
|
|
|
|
/**
|
|
* ClutterFrameListenerIface: (skip)
|
|
*/
|
|
typedef struct _ClutterFrameListenerIface
|
|
{
|
|
void (* before_frame) (ClutterFrameClock *frame_clock,
|
|
ClutterFrame *frame,
|
|
gpointer user_data);
|
|
ClutterFrameResult (* frame) (ClutterFrameClock *frame_clock,
|
|
ClutterFrame *frame,
|
|
gpointer user_data);
|
|
ClutterFrame * (* new_frame) (ClutterFrameClock *frame_clock,
|
|
gpointer user_data);
|
|
} ClutterFrameListenerIface;
|
|
|
|
typedef enum _ClutterFrameClockMode
|
|
{
|
|
CLUTTER_FRAME_CLOCK_MODE_FIXED,
|
|
CLUTTER_FRAME_CLOCK_MODE_VARIABLE,
|
|
} ClutterFrameClockMode;
|
|
|
|
CLUTTER_EXPORT
|
|
ClutterFrameClock * clutter_frame_clock_new (float refresh_rate,
|
|
int64_t vblank_duration_us,
|
|
const char *name,
|
|
const ClutterFrameListenerIface *iface,
|
|
gpointer user_data);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_destroy (ClutterFrameClock *frame_clock);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_set_mode (ClutterFrameClock *frame_clock,
|
|
ClutterFrameClockMode mode);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_notify_presented (ClutterFrameClock *frame_clock,
|
|
ClutterFrameInfo *frame_info);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_notify_ready (ClutterFrameClock *frame_clock);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_schedule_update (ClutterFrameClock *frame_clock);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_schedule_update_now (ClutterFrameClock *frame_clock);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_inhibit (ClutterFrameClock *frame_clock);
|
|
|
|
CLUTTER_EXPORT
|
|
void clutter_frame_clock_uninhibit (ClutterFrameClock *frame_clock);
|
|
|
|
void clutter_frame_clock_add_timeline (ClutterFrameClock *frame_clock,
|
|
ClutterTimeline *timeline);
|
|
|
|
void clutter_frame_clock_remove_timeline (ClutterFrameClock *frame_clock,
|
|
ClutterTimeline *timeline);
|
|
|
|
CLUTTER_EXPORT
|
|
float clutter_frame_clock_get_refresh_rate (ClutterFrameClock *frame_clock);
|
|
|
|
void clutter_frame_clock_record_flip_time (ClutterFrameClock *frame_clock,
|
|
int64_t flip_time_us);
|
|
|
|
GString * clutter_frame_clock_get_max_render_time_debug_info (ClutterFrameClock *frame_clock);
|