Copyright | Will Thompson, Iñaki García Etxebarria and Jonas Platte |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria (garetxe@gmail.com) |
Safe Haskell | None |
Language | Haskell2010 |
A FrameClock
tells the application when to update and repaint a
window. This may be synced to the vertical refresh rate of the
monitor, for example. Even when the frame clock uses a simple timer
rather than a hardware-based vertical sync, the frame clock helps
because it ensures everything paints at the same time (reducing the
total number of frames). The frame clock can also automatically
stop painting when it knows the frames will not be visible, or
scale back animation framerates.
FrameClock
is designed to be compatible with an OpenGL-based
implementation or with mozRequestAnimationFrame in Firefox,
for example.
A frame clock is idle until someone requests a frame with
frameClockRequestPhase
. At some later point that makes
sense for the synchronization being implemented, the clock will
process a frame and emit signals for each phase that has been
requested. (See the signals of the FrameClock
class for
documentation of the phases. FrameClockPhaseUpdate
and the
FrameClock
::update
signal are most interesting for application
writers, and are used to update the animations, using the frame time
given by frameClockGetFrameTime
.
The frame time is reported in microseconds and generally in the same
timescale as getMonotonicTime
, however, it is not the same
as getMonotonicTime
. The frame time does not advance during
the time a frame is being painted, and outside of a frame, an attempt
is made so that all calls to frameClockGetFrameTime
that
are called at a “similar” time get the same value. This means that
if different animations are timed by looking at the difference in
time between an initial value from frameClockGetFrameTime
and the value inside the FrameClock
::update
signal of the clock,
they will stay exactly synchronized.
- newtype FrameClock = FrameClock (ManagedPtr FrameClock)
- class GObject o => IsFrameClock o
- toFrameClock :: IsFrameClock o => o -> IO FrameClock
- noFrameClock :: Maybe FrameClock
- data FrameClockBeginUpdatingMethodInfo
- frameClockBeginUpdating :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> m ()
- data FrameClockEndUpdatingMethodInfo
- frameClockEndUpdating :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> m ()
- data FrameClockGetCurrentTimingsMethodInfo
- frameClockGetCurrentTimings :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> m (Maybe FrameTimings)
- data FrameClockGetFrameCounterMethodInfo
- frameClockGetFrameCounter :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> m Int64
- data FrameClockGetFrameTimeMethodInfo
- frameClockGetFrameTime :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> m Int64
- data FrameClockGetHistoryStartMethodInfo
- frameClockGetHistoryStart :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> m Int64
- data FrameClockGetRefreshInfoMethodInfo
- frameClockGetRefreshInfo :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> Int64 -> Int64 -> Int64 -> m ()
- data FrameClockGetTimingsMethodInfo
- frameClockGetTimings :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> Int64 -> m (Maybe FrameTimings)
- data FrameClockRequestPhaseMethodInfo
- frameClockRequestPhase :: (HasCallStack, MonadIO m, IsFrameClock a) => a -> [FrameClockPhase] -> m ()
- type C_FrameClockAfterPaintCallback = Ptr () -> Ptr () -> IO ()
- type FrameClockAfterPaintCallback = IO ()
- data FrameClockAfterPaintSignalInfo
- afterFrameClockAfterPaint :: (GObject a, MonadIO m) => a -> FrameClockAfterPaintCallback -> m SignalHandlerId
- genClosure_FrameClockAfterPaint :: FrameClockAfterPaintCallback -> IO Closure
- mk_FrameClockAfterPaintCallback :: C_FrameClockAfterPaintCallback -> IO (FunPtr C_FrameClockAfterPaintCallback)
- noFrameClockAfterPaintCallback :: Maybe FrameClockAfterPaintCallback
- onFrameClockAfterPaint :: (GObject a, MonadIO m) => a -> FrameClockAfterPaintCallback -> m SignalHandlerId
- wrap_FrameClockAfterPaintCallback :: FrameClockAfterPaintCallback -> Ptr () -> Ptr () -> IO ()
- type C_FrameClockBeforePaintCallback = Ptr () -> Ptr () -> IO ()
- type FrameClockBeforePaintCallback = IO ()
- data FrameClockBeforePaintSignalInfo
- afterFrameClockBeforePaint :: (GObject a, MonadIO m) => a -> FrameClockBeforePaintCallback -> m SignalHandlerId
- genClosure_FrameClockBeforePaint :: FrameClockBeforePaintCallback -> IO Closure
- mk_FrameClockBeforePaintCallback :: C_FrameClockBeforePaintCallback -> IO (FunPtr C_FrameClockBeforePaintCallback)
- noFrameClockBeforePaintCallback :: Maybe FrameClockBeforePaintCallback
- onFrameClockBeforePaint :: (GObject a, MonadIO m) => a -> FrameClockBeforePaintCallback -> m SignalHandlerId
- wrap_FrameClockBeforePaintCallback :: FrameClockBeforePaintCallback -> Ptr () -> Ptr () -> IO ()
- type C_FrameClockFlushEventsCallback = Ptr () -> Ptr () -> IO ()
- type FrameClockFlushEventsCallback = IO ()
- data FrameClockFlushEventsSignalInfo
- afterFrameClockFlushEvents :: (GObject a, MonadIO m) => a -> FrameClockFlushEventsCallback -> m SignalHandlerId
- genClosure_FrameClockFlushEvents :: FrameClockFlushEventsCallback -> IO Closure
- mk_FrameClockFlushEventsCallback :: C_FrameClockFlushEventsCallback -> IO (FunPtr C_FrameClockFlushEventsCallback)
- noFrameClockFlushEventsCallback :: Maybe FrameClockFlushEventsCallback
- onFrameClockFlushEvents :: (GObject a, MonadIO m) => a -> FrameClockFlushEventsCallback -> m SignalHandlerId
- wrap_FrameClockFlushEventsCallback :: FrameClockFlushEventsCallback -> Ptr () -> Ptr () -> IO ()
- type C_FrameClockLayoutCallback = Ptr () -> Ptr () -> IO ()
- type FrameClockLayoutCallback = IO ()
- data FrameClockLayoutSignalInfo
- afterFrameClockLayout :: (GObject a, MonadIO m) => a -> FrameClockLayoutCallback -> m SignalHandlerId
- genClosure_FrameClockLayout :: FrameClockLayoutCallback -> IO Closure
- mk_FrameClockLayoutCallback :: C_FrameClockLayoutCallback -> IO (FunPtr C_FrameClockLayoutCallback)
- noFrameClockLayoutCallback :: Maybe FrameClockLayoutCallback
- onFrameClockLayout :: (GObject a, MonadIO m) => a -> FrameClockLayoutCallback -> m SignalHandlerId
- wrap_FrameClockLayoutCallback :: FrameClockLayoutCallback -> Ptr () -> Ptr () -> IO ()
- type C_FrameClockPaintCallback = Ptr () -> Ptr () -> IO ()
- type FrameClockPaintCallback = IO ()
- data FrameClockPaintSignalInfo
- afterFrameClockPaint :: (GObject a, MonadIO m) => a -> FrameClockPaintCallback -> m SignalHandlerId
- genClosure_FrameClockPaint :: FrameClockPaintCallback -> IO Closure
- mk_FrameClockPaintCallback :: C_FrameClockPaintCallback -> IO (FunPtr C_FrameClockPaintCallback)
- noFrameClockPaintCallback :: Maybe FrameClockPaintCallback
- onFrameClockPaint :: (GObject a, MonadIO m) => a -> FrameClockPaintCallback -> m SignalHandlerId
- wrap_FrameClockPaintCallback :: FrameClockPaintCallback -> Ptr () -> Ptr () -> IO ()
- type C_FrameClockResumeEventsCallback = Ptr () -> Ptr () -> IO ()
- type FrameClockResumeEventsCallback = IO ()
- data FrameClockResumeEventsSignalInfo
- afterFrameClockResumeEvents :: (GObject a, MonadIO m) => a -> FrameClockResumeEventsCallback -> m SignalHandlerId
- genClosure_FrameClockResumeEvents :: FrameClockResumeEventsCallback -> IO Closure
- mk_FrameClockResumeEventsCallback :: C_FrameClockResumeEventsCallback -> IO (FunPtr C_FrameClockResumeEventsCallback)
- noFrameClockResumeEventsCallback :: Maybe FrameClockResumeEventsCallback
- onFrameClockResumeEvents :: (GObject a, MonadIO m) => a -> FrameClockResumeEventsCallback -> m SignalHandlerId
- wrap_FrameClockResumeEventsCallback :: FrameClockResumeEventsCallback -> Ptr () -> Ptr () -> IO ()
- type C_FrameClockUpdateCallback = Ptr () -> Ptr () -> IO ()
- type FrameClockUpdateCallback = IO ()
- data FrameClockUpdateSignalInfo
- afterFrameClockUpdate :: (GObject a, MonadIO m) => a -> FrameClockUpdateCallback -> m SignalHandlerId
- genClosure_FrameClockUpdate :: FrameClockUpdateCallback -> IO Closure
- mk_FrameClockUpdateCallback :: C_FrameClockUpdateCallback -> IO (FunPtr C_FrameClockUpdateCallback)
- noFrameClockUpdateCallback :: Maybe FrameClockUpdateCallback
- onFrameClockUpdate :: (GObject a, MonadIO m) => a -> FrameClockUpdateCallback -> m SignalHandlerId
- wrap_FrameClockUpdateCallback :: FrameClockUpdateCallback -> Ptr () -> Ptr () -> IO ()
Exported types
newtype FrameClock Source #
GObject FrameClock Source # | |
IsObject FrameClock Source # | |
IsFrameClock FrameClock Source # | |
((~) * info (ResolveFrameClockMethod t FrameClock), MethodInfo * info FrameClock p) => IsLabel t (FrameClock -> p) Source # | |
((~) * info (ResolveFrameClockMethod t FrameClock), MethodInfo * info FrameClock p) => IsLabelProxy t (FrameClock -> p) Source # | |
HasAttributeList * FrameClock Source # | |
type AttributeList FrameClock Source # | |
type SignalList FrameClock Source # | |
class GObject o => IsFrameClock o Source #
toFrameClock :: IsFrameClock o => o -> IO FrameClock Source #
Methods
beginUpdating
data FrameClockBeginUpdatingMethodInfo Source #
((~) * signature (m ()), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockBeginUpdatingMethodInfo a signature Source # | |
frameClockBeginUpdating Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> m () |
Starts updates for an animation. Until a matching call to
frameClockEndUpdating
is made, the frame clock will continually
request a new frame with the FrameClockPhaseUpdate
phase.
This function may be called multiple times and frames will be
requested until frameClockEndUpdating
is called the same
number of times.
Since: 3.8
endUpdating
data FrameClockEndUpdatingMethodInfo Source #
((~) * signature (m ()), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockEndUpdatingMethodInfo a signature Source # | |
frameClockEndUpdating Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> m () |
Stops updates for an animation. See the documentation for
frameClockBeginUpdating
.
Since: 3.8
getCurrentTimings
data FrameClockGetCurrentTimingsMethodInfo Source #
((~) * signature (m (Maybe FrameTimings)), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockGetCurrentTimingsMethodInfo a signature Source # | |
frameClockGetCurrentTimings Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> m (Maybe FrameTimings) | Returns: the |
Gets the frame timings for the current frame.
Since: 3.8
getFrameCounter
data FrameClockGetFrameCounterMethodInfo Source #
((~) * signature (m Int64), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockGetFrameCounterMethodInfo a signature Source # | |
frameClockGetFrameCounter Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> m Int64 | Returns: inside frame processing, the value of the frame counter for the current frame. Outside of frame processing, the frame counter for the last frame. |
A FrameClock
maintains a 64-bit counter that increments for
each frame drawn.
Since: 3.8
getFrameTime
data FrameClockGetFrameTimeMethodInfo Source #
((~) * signature (m Int64), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockGetFrameTimeMethodInfo a signature Source # | |
frameClockGetFrameTime Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> m Int64 | Returns: a timestamp in microseconds, in the timescale of
of |
Gets the time that should currently be used for animations. Inside the processing of a frame, it’s the time used to compute the animation position of everything in a frame. Outside of a frame, it's the time of the conceptual “previous frame,” which may be either the actual previous frame time, or if that’s too old, an updated time.
Since: 3.8
getHistoryStart
data FrameClockGetHistoryStartMethodInfo Source #
((~) * signature (m Int64), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockGetHistoryStartMethodInfo a signature Source # | |
frameClockGetHistoryStart Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> m Int64 | Returns: the frame counter value for the oldest frame
that is available in the internal frame history of the
|
FrameClock
internally keeps a history of FrameTimings
objects for recent frames that can be retrieved with
frameClockGetTimings
. The set of stored frames
is the set from the counter values given by
frameClockGetHistoryStart
and
frameClockGetFrameCounter
, inclusive.
Since: 3.8
getRefreshInfo
data FrameClockGetRefreshInfoMethodInfo Source #
((~) * signature (Int64 -> Int64 -> Int64 -> m ()), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockGetRefreshInfoMethodInfo a signature Source # | |
frameClockGetRefreshInfo Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> Int64 |
|
-> Int64 |
|
-> Int64 |
|
-> m () |
Using the frame history stored in the frame clock, finds the last
known presentation time and refresh interval, and assuming that
presentation times are separated by the refresh interval,
predicts a presentation time that is a multiple of the refresh
interval after the last presentation time, and later than baseTime
.
Since: 3.8
getTimings
data FrameClockGetTimingsMethodInfo Source #
((~) * signature (Int64 -> m (Maybe FrameTimings)), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockGetTimingsMethodInfo a signature Source # | |
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> Int64 |
|
-> m (Maybe FrameTimings) | Returns: the |
Retrieves a FrameTimings
object holding timing information
for the current frame or a recent frame. The FrameTimings
object may not yet be complete: see frameTimingsGetComplete
.
Since: 3.8
requestPhase
data FrameClockRequestPhaseMethodInfo Source #
((~) * signature ([FrameClockPhase] -> m ()), MonadIO m, IsFrameClock a) => MethodInfo * FrameClockRequestPhaseMethodInfo a signature Source # | |
frameClockRequestPhase Source #
:: (HasCallStack, MonadIO m, IsFrameClock a) | |
=> a |
|
-> [FrameClockPhase] |
|
-> m () |
Asks the frame clock to run a particular phase. The signal
corresponding the requested phase will be emitted the next
time the frame clock processes. Multiple calls to
frameClockRequestPhase
will be combined together
and only one frame processed. If you are displaying animated
content and want to continually request the
FrameClockPhaseUpdate
phase for a period of time,
you should use frameClockBeginUpdating
instead, since
this allows GTK+ to adjust system parameters to get maximally
smooth animations.
Since: 3.8
Signals
afterPaint
type FrameClockAfterPaintCallback = IO () Source #
afterFrameClockAfterPaint :: (GObject a, MonadIO m) => a -> FrameClockAfterPaintCallback -> m SignalHandlerId Source #
mk_FrameClockAfterPaintCallback :: C_FrameClockAfterPaintCallback -> IO (FunPtr C_FrameClockAfterPaintCallback) Source #
onFrameClockAfterPaint :: (GObject a, MonadIO m) => a -> FrameClockAfterPaintCallback -> m SignalHandlerId Source #
wrap_FrameClockAfterPaintCallback :: FrameClockAfterPaintCallback -> Ptr () -> Ptr () -> IO () Source #
beforePaint
type FrameClockBeforePaintCallback = IO () Source #
afterFrameClockBeforePaint :: (GObject a, MonadIO m) => a -> FrameClockBeforePaintCallback -> m SignalHandlerId Source #
mk_FrameClockBeforePaintCallback :: C_FrameClockBeforePaintCallback -> IO (FunPtr C_FrameClockBeforePaintCallback) Source #
onFrameClockBeforePaint :: (GObject a, MonadIO m) => a -> FrameClockBeforePaintCallback -> m SignalHandlerId Source #
wrap_FrameClockBeforePaintCallback :: FrameClockBeforePaintCallback -> Ptr () -> Ptr () -> IO () Source #
flushEvents
type FrameClockFlushEventsCallback = IO () Source #
afterFrameClockFlushEvents :: (GObject a, MonadIO m) => a -> FrameClockFlushEventsCallback -> m SignalHandlerId Source #
mk_FrameClockFlushEventsCallback :: C_FrameClockFlushEventsCallback -> IO (FunPtr C_FrameClockFlushEventsCallback) Source #
onFrameClockFlushEvents :: (GObject a, MonadIO m) => a -> FrameClockFlushEventsCallback -> m SignalHandlerId Source #
wrap_FrameClockFlushEventsCallback :: FrameClockFlushEventsCallback -> Ptr () -> Ptr () -> IO () Source #
layout
type FrameClockLayoutCallback = IO () Source #
afterFrameClockLayout :: (GObject a, MonadIO m) => a -> FrameClockLayoutCallback -> m SignalHandlerId Source #
mk_FrameClockLayoutCallback :: C_FrameClockLayoutCallback -> IO (FunPtr C_FrameClockLayoutCallback) Source #
onFrameClockLayout :: (GObject a, MonadIO m) => a -> FrameClockLayoutCallback -> m SignalHandlerId Source #
wrap_FrameClockLayoutCallback :: FrameClockLayoutCallback -> Ptr () -> Ptr () -> IO () Source #
paint
type FrameClockPaintCallback = IO () Source #
afterFrameClockPaint :: (GObject a, MonadIO m) => a -> FrameClockPaintCallback -> m SignalHandlerId Source #
mk_FrameClockPaintCallback :: C_FrameClockPaintCallback -> IO (FunPtr C_FrameClockPaintCallback) Source #
onFrameClockPaint :: (GObject a, MonadIO m) => a -> FrameClockPaintCallback -> m SignalHandlerId Source #
wrap_FrameClockPaintCallback :: FrameClockPaintCallback -> Ptr () -> Ptr () -> IO () Source #
resumeEvents
type FrameClockResumeEventsCallback = IO () Source #
afterFrameClockResumeEvents :: (GObject a, MonadIO m) => a -> FrameClockResumeEventsCallback -> m SignalHandlerId Source #
mk_FrameClockResumeEventsCallback :: C_FrameClockResumeEventsCallback -> IO (FunPtr C_FrameClockResumeEventsCallback) Source #
onFrameClockResumeEvents :: (GObject a, MonadIO m) => a -> FrameClockResumeEventsCallback -> m SignalHandlerId Source #
wrap_FrameClockResumeEventsCallback :: FrameClockResumeEventsCallback -> Ptr () -> Ptr () -> IO () Source #
update
type FrameClockUpdateCallback = IO () Source #
afterFrameClockUpdate :: (GObject a, MonadIO m) => a -> FrameClockUpdateCallback -> m SignalHandlerId Source #
mk_FrameClockUpdateCallback :: C_FrameClockUpdateCallback -> IO (FunPtr C_FrameClockUpdateCallback) Source #
onFrameClockUpdate :: (GObject a, MonadIO m) => a -> FrameClockUpdateCallback -> m SignalHandlerId Source #
wrap_FrameClockUpdateCallback :: FrameClockUpdateCallback -> Ptr () -> Ptr () -> IO () Source #