display.h

Go to the documentation of this file.

 
#ifndef __LIBDRAGON_DISPLAY_H
#define __LIBDRAGON_DISPLAY_H
 
#include <stdbool.h>
#include <stdint.h>
 
typedef struct surface_s surface_t;
 
typedef struct {
    int32_t width;
    int32_t height;
    bool interlaced;
} resolution_t;
 
#define const static const /* fool doxygen to document these static members */
 
const resolution_t RESOLUTION_256x240 = {256, 240, false};
const resolution_t RESOLUTION_320x240 = {320, 240, false};
const resolution_t RESOLUTION_512x240 = {512, 240, false};
const resolution_t RESOLUTION_640x240 = {640, 240, false};
const resolution_t RESOLUTION_512x480 = {512, 480, true};
const resolution_t RESOLUTION_640x480 = {640, 480, true};
#undef const
 
typedef enum
{
    DEPTH_16_BPP,
    DEPTH_32_BPP
} bitdepth_t;
 
typedef enum
{
    GAMMA_NONE,
    GAMMA_CORRECT,
    GAMMA_CORRECT_DITHER
} gamma_t;
 
typedef enum
{
    FILTERS_DISABLED,
    FILTERS_RESAMPLE,
    FILTERS_DEDITHER,
    FILTERS_RESAMPLE_ANTIALIAS,
    FILTERS_RESAMPLE_ANTIALIAS_DEDITHER
} filter_options_t;
 
 
typedef filter_options_t antialias_t;
#define ANTIALIAS_OFF                   FILTERS_DISABLED
#define ANTIALIAS_RESAMPLE              FILTERS_RESAMPLE
#define ANTIALIAS_RESAMPLE_FETCH_NEEDED FILTERS_RESAMPLE_ANTIALIAS
#define ANTIALIAS_RESAMPLE_FETCH_ALWAYS FILTERS_RESAMPLE_ANTIALIAS_DEDITHER
 
 
typedef surface_t* display_context_t;
 
#ifdef __cplusplus
extern "C" {
#endif
 
void display_init( resolution_t res, bitdepth_t bit, uint32_t num_buffers, gamma_t gamma, filter_options_t filters );
 
void display_close();
 
surface_t* display_get(void);
 
surface_t* display_try_get(void);
 
void display_show(surface_t* surf);
 
uint32_t display_get_width(void);
 
uint32_t display_get_height(void);
 
uint32_t display_get_bitdepth(void);
 
uint32_t display_get_num_buffers(void);
 
float display_get_fps(void);
 
 
__attribute__((deprecated("use display_get or display_try_get instead")))
static inline surface_t* display_lock(void) {
    return display_try_get();
}
#ifdef __cplusplus
}
#endif
 /* display */
 
#endif