Function
Clutterthreads_add_repaint_func
Declaration [src]
guint
clutter_threads_add_repaint_func (
GSourceFunc func,
gpointer data,
GDestroyNotify notify
)
Description [src]
Adds a function to be called whenever Clutter is processing a new frame.
If the function returns FALSE it is automatically removed from the
list of repaint functions and will not be called again.
This function is guaranteed to be called from within the same thread that called clutter_main(), and while the Clutter lock is being held; the function will be called within the main loop, so it is imperative that it does not block, otherwise the frame time budget may be lost.
A repaint function is useful to ensure that an update of the scenegraph is performed before the scenegraph is repainted. By default, a repaint function added using this function will be invoked prior to the frame being processed.
Adding a repaint function does not automatically ensure that a new frame will be queued.
When the repaint function is removed (either because it returned FALSE
or because clutter_threads_remove_repaint_func() has been called) the
notify function will be called, if any is set.
See also: clutter_threads_add_repaint_func_full().
Parameters
func-
Type:
GSourceFuncThe function to be called within the paint cycle.
data-
Type:
gpointerData to be passed to the function, or
NULL.The argument can be NULL.The data is owned by the caller of the function. notify-
Type:
GDestroyNotifyFunction to be called when removing the repaint function, or
NULL.