|typedef struct TimeFilter||TimeFilter|
|Opaque type representing a time filter state. |
|TimeFilter *||ff_timefilter_new (double clock_period, double feedback2_factor, double feedback3_factor)|
|Create a new Delay Locked Loop time filter. |
|double||ff_timefilter_update (TimeFilter *self, double system_time, double period)|
|Update the filter. |
|void||ff_timefilter_reset (TimeFilter *)|
|Reset the filter. |
|void||ff_timefilter_destroy (TimeFilter *)|
|Free all resources associated with the filter. |
Opaque type representing a time filter state.
The purpose of this filter is to provide a way to compute accurate time stamps that can be compared to wall clock time, especially when dealing with two clocks: the system clock and a hardware device clock, such as a soundcard.
|void ff_timefilter_destroy||(||TimeFilter *||)|
Create a new Delay Locked Loop time filter.
feedback2_factor and feedback3_factor are the factors used for the multiplications that are respectively performed in the second and third feedback paths of the loop.
Unless you know what you are doing, you should set these as follow:
o = 2 * M_PI * bandwidth * period feedback2_factor = sqrt(2 * o) feedback3_factor = o * o
Where bandwidth is up to you to choose. Smaller values will filter out more of the jitter, but also take a longer time for the loop to settle. A good starting point is something between 0.3 and 3 Hz.
|clock_period||period of the hardware clock in seconds (for example 1.0/44100)|
|void ff_timefilter_reset||(||TimeFilter *||)|
|double ff_timefilter_update||(||TimeFilter *||self,|
Update the filter.
This function must be called in real time, at each process cycle.
|period||the device cycle duration in clock_periods. For example, at 44.1kHz and a buffer size of 512 frames, period = 512 when clock_period was 1.0/44100, or 512/44100 if clock_period was 1.|
calculate loop error