gfx_turn.h

Go to the documentation of this file.

#pragma once
 
#include <stdatomic.h>
#include <stdbool.h>
#include <stdint.h>
 
#include "gfx.h"
#include "gfx_damage.h"
 
#ifdef __cplusplus
extern "C" {
#endif

#define GFX_TURN_BUDGET_US  50000u
#define GFX_TURN_FULL_FLIPS 2u

typedef enum {
    GFX_TURN_COPY_DONE = 0,  
    GFX_TURN_COPY_TIMEOUT,   
    GFX_TURN_COPY_ERROR,     
} gfx_turn_copy_t;

typedef enum {
    GFX_TURN_FAIL_NONE = 0,  
    GFX_TURN_FAIL_TIMEOUT,   
    GFX_TURN_FAIL_ERROR,     
    GFX_TURN_FAIL_ENGINE,    
} gfx_turn_fail_t;

typedef enum {
    GFX_TURN_SHOW_NORMAL = 0, 
    GFX_TURN_SHOW_TURNED,     
    GFX_TURN_SHOW_FALLBACK,   
} gfx_turn_show_t;

typedef struct {
    gfx_turn_copy_t (*copy)(void *ctx, const gfx_color_t *src,
                            gfx_color_t *dst, gfx_rect_t r,
                            uint32_t budget_us);
    uint32_t (*now_us)(void *ctx);
    void *ctx;   
} gfx_turn_ops_t;

typedef struct {
    const gfx_color_t *in;  
    gfx_color_t *out;       
    int16_t width;          
    int16_t height;         
    gfx_rect_t src;         
    int16_t dst_x;          
    int16_t dst_y;          
    void *user_data;        
} gfx_turn_job_t;

typedef struct {
    bool (*submit)(void *engine, const gfx_turn_job_t *job);
    bool (*wait)(void *engine, uint32_t budget_us);
    void *engine;    
    void *done_ctx;  
} gfx_turn_engine_t;

typedef struct {
    gfx_damage_t damage;   
    int16_t width;         
    int16_t height;        
    bool requested;        
    bool drawing;          
    bool failed;           
    gfx_turn_fail_t why;   
    bool alerted;          
    bool repaint;          
    bool alert;            
    uint8_t full_left;     
    uint16_t rects;        
    uint32_t pixels;       
    uint32_t copy_us;      
} gfx_turn_t;

void gfx_turn_init(gfx_turn_t *t, int width, int height);

void gfx_turn_request(gfx_turn_t *t, bool turned);

void gfx_turn_fail(gfx_turn_t *t, gfx_turn_fail_t why);

bool gfx_turn_drawing(const gfx_turn_t *t);

void gfx_turn_begin(gfx_turn_t *t, const gfx_canvas_t *logical);

gfx_turn_show_t gfx_turn_flush(gfx_turn_t *t, const gfx_color_t *logical,
                               gfx_color_t *fb, const gfx_turn_ops_t *ops);

bool gfx_turn_presented(gfx_turn_t *t, gfx_turn_show_t show);

void gfx_turn_next(gfx_turn_t *t);

bool gfx_turn_take_repaint(gfx_turn_t *t);

bool gfx_turn_take_alert(gfx_turn_t *t);

gfx_turn_copy_t gfx_turn_engine_copy(const gfx_turn_engine_t *e,
                                     const gfx_color_t *src,
                                     gfx_color_t *dst, gfx_rect_t r,
                                     int width, int height,
                                     uint32_t budget_us);

extern atomic_uint gfx_turn_stray;

static inline void *gfx_turn_done_ctx(void *user_data)
{
    if (user_data == NULL) {
        atomic_fetch_add(&gfx_turn_stray, 1u);
    }
    return user_data;
}

uint32_t gfx_turn_stray_dones(void);

bool gfx_turn_shown(void);
 
#ifdef __cplusplus
}
#endif