mutter/doc
Dor Askayo 82cdf90a71 clutter/frame-clock: Add a state for when scheduled "now"
The new CLUTTER_FRAME_CLOCK_STATE_SCHEDULED_NOW state is almost
identical to CLUTTER_FRAME_CLOCK_STATE_SCHEDULED, with one important
difference being that it avoids updates from being repeatedly
rescheduled "now" when multiple calls to
clutter_frame_clock_schedule_update_now() are done before the source
is actually dispatched.

Such repeated calls to schedule an update "now" may actually postpone
the dispatch if the CPU is very busy and the source dispatch is
delayed, defeating the purpose of scheduling a frame "now".

It also allows rescheduling "now" when the frame clock is uninhibited
after being inhibited while an update was scheduled "now". This may
be important in cases where the frame clock is inhibited for very
short periods in which it would otherwise lose the state of being
scheduled "now".

Scenarios such as this would become more common with the introduction
of variable refresh rate since it makes scheduling "now" a commonplace
occurrence.

Part-of: <https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/3561>
2024-02-10 16:16:19 +00:00
..
data docs: Import Clutter Rendering Model wiki page 2024-01-03 22:41:10 +01:00
man
reference misc: Use the new mutter.gnome.org URL 2024-01-12 10:48:20 +00:00
website docs/website: Add documentation pages 2024-01-12 13:07:02 +00:00
building-and-running.md docs/building-and-running: Add note about updating ref-tests 2024-01-03 20:54:57 +00:00
clutter-frame-scheduling.md clutter/frame-clock: Add a state for when scheduled "now" 2024-02-10 16:16:19 +00:00
clutter-rendering-model.md docs: Import Clutter Rendering Model wiki page 2024-01-03 22:41:10 +01:00
code-overview.md docs: Move kms abstractions documentation out of references 2024-01-09 17:59:15 +00:00
coding-style.md docs: Move the gitlab wiki and other docs to the docs/ directory 2024-01-03 20:54:57 +00:00
debugging.md doc: Update link to looking glass documentation 2024-01-29 20:05:39 +01:00
git-conventions.md doc: Update link to commit message guidelines 2024-01-16 09:37:21 +00:00
monitor-configuration.md docs: Move the gitlab wiki and other docs to the docs/ directory 2024-01-03 20:54:57 +00:00
mutter-constraints.txt docs: Prefix code documentation files 2024-01-03 22:41:07 +01:00
mutter-focus.txt docs: Prefix code documentation files 2024-01-03 22:41:07 +01:00
mutter-kms-abstractions.md docs: Move kms abstractions documentation out of references 2024-01-09 17:59:15 +00:00
mutter-relationships.md docs: Move the gitlab wiki and other docs to the docs/ directory 2024-01-03 20:54:57 +00:00