adaptive_sampler.h

Go to the documentation of this file.

 
#ifndef ADAPTIVE_SAMPLER_H
#define ADAPTIVE_SAMPLER_H
 
#include <stddef.h>  // size_t
#include <stdint.h>  // uint64_t
 
typedef struct {
    float timestamp;      
    float value;          
    uint64_t frame_index; 
} AdaptiveSampleItem;
 
typedef struct {
    uint64_t state;
    uint64_t inc;
} Pcg32;
 
typedef struct {
    /* RNG State */
    Pcg32 rng;
 
    /* Configuration */
    float
        window_duration; 
    size_t target_samples; 
    /* State */
    size_t samples_taken;
    double window_start_time;    
    uint64_t window_start_frame; 
    uint64_t window_end_frame;   
    float avg_dt; 
    float alpha;  
    /* Buffer (Dynamic) */
    AdaptiveSampleItem* samples; 
    size_t capacity;             
    size_t count;                
} AdaptiveSampler;
 
void adaptive_sampler_add(AdaptiveSampler* sampler, float value,
                          uint64_t frame_index);
 
void adaptive_sampler_init(AdaptiveSampler* sampler, float window_duration,
                           size_t target_samples, float initial_fps_guess);
 
int adaptive_sampler_should_sample(AdaptiveSampler* sampler, float delta_time,
                                   double current_time, uint64_t frame_index);
 
int adaptive_sampler_is_finished(const AdaptiveSampler* sampler,
                                 double current_time);
 
float adaptive_sampler_get_average(const AdaptiveSampler* sampler);
 
size_t adaptive_sampler_get_sample_count(const AdaptiveSampler* sampler);
 
void adaptive_sampler_get_window_range(const AdaptiveSampler* sampler,
                                       uint64_t* start_frame,
                                       uint64_t* end_frame);
 
size_t adaptive_sampler_get_sample_indices(const AdaptiveSampler* sampler,
                                           uint64_t* out_indices,
                                           size_t max_count);
 
void adaptive_sampler_reset(AdaptiveSampler* sampler, double current_time);
 
void adaptive_sampler_cleanup(AdaptiveSampler* sampler);
 
#endif /* ADAPTIVE_SAMPLER_H */