add_full


Description:

[ CCode ( cname = "clutter_threads_add_frame_source_full" ) ]
[ Version ( deprecated = true , deprecated_since = "1.6" , since = "0.8" ) ]
public uint add_full (int priority, uint fps, owned SourceFunc func)

Warning: add_full is deprecated since 1.6.

Sets a function to be called at regular intervals holding the Clutter threads lock, with the given priority.

Note:

There is no direct replacement for this API

The function is called repeatedly until it returns false, at which point the timeout is automatically removed and the function will not be called again. The notify function is called when the timeout is removed.

This function is similar to add_full except that it will try to compensate for delays. For example, if func takes half the interval time to execute then the function will be called again half the interval time after it finished. In contrast add_full would not fire until a full interval after the function completes so the delay between calls would be interval * 1.5. This function does not however try to invoke the function multiple times to catch up missing frames if func takes more than interval ms to execute.

See also add_full.

Parameters:

priority

the priority of the frame source. Typically this will be in the range between DEFAULT and HIGH.

fps

the number of times per second to call the function

func

function to call

data

data to pass to the function

notify

function to call when the timeout source is removed

Returns:

the ID (greater than 0) of the event source.


Package: clutter-1.0