rdpq_tex.h

Go to the documentation of this file.

 
#ifndef LIBDRAGON_RDPQ_TEX_H
#define LIBDRAGON_RDPQ_TEX_H
 
#include "rdpq.h"
#include <stdint.h>
 
typedef struct surface_s surface_t;
 
#ifdef __cplusplus
extern "C" {
#endif
 
 
#define MIRROR_REPEAT true
#define MIRROR_NONE   false
#define REPEAT_INFINITE 2048
 
typedef struct rdpq_texparms_s {
    int tmem_addr;           
    int palette;             
 
    struct {
        float   translate;    
        int     scale_log;    
 
        float   repeats;      
        bool    mirror;       
    } s, t; // S/T directions of texture parameters
 
} rdpq_texparms_t;
 
// Multi-pass optimized texture loader
// Not part of the public API yet
enum tex_load_mode {
    TEX_LOAD_UNKNOWN,
    TEX_LOAD_TILE,
    TEX_LOAD_BLOCK,
};
 
typedef struct tex_loader_s {
    const surface_t *tex;
    tex_format_t fmt;
    rdpq_tile_t tile;
    const rdpq_texparms_t *texparms;
    rdpq_tileparms_t tileparms;
    struct {
        int width, height;
        int num_texels, tmem_pitch;
        int block_max_lines;
        bool can_load_block;
        int s0fx, t0fx, s1fx, t1fx;
    } rect;
    int tmem_addr;
    enum tex_load_mode load_mode;
    void (*load_block)(struct tex_loader_s *tload, int s0, int t0, int s1, int t1);
    void (*load_tile)(struct tex_loader_s *tload, int s0, int t0, int s1, int t1);
} tex_loader_t;
tex_loader_t tex_loader_init(rdpq_tile_t tile, const surface_t *tex);
int tex_loader_load(tex_loader_t *tload, int s0, int t0, int s1, int t1);
void tex_loader_set_tmem_addr(tex_loader_t *tload, int tmem_addr);
int tex_loader_calc_max_height(tex_loader_t *tload, int width);
 
 
int rdpq_tex_upload(rdpq_tile_t tile, const surface_t *tex, const rdpq_texparms_t *parms);
 
int rdpq_tex_upload_sub(rdpq_tile_t tile, const surface_t *tex, const rdpq_texparms_t *parms, int s0, int t0, int s1, int t1);
 
void rdpq_tex_upload_tlut(uint16_t *tlut, int color_idx, int num_colors);
 
int rdpq_tex_reuse_sub(rdpq_tile_t tile, const rdpq_texparms_t *parms, int s0, int t0, int s1, int t1);
 
int rdpq_tex_reuse(rdpq_tile_t tile, const rdpq_texparms_t *parms);
 
void rdpq_tex_multi_begin(void);
 
 
int rdpq_tex_multi_end(void);
 
 
typedef struct rdpq_blitparms_s {
    rdpq_tile_t tile;   
    int s0;             
    int t0;             
    int width;          
    int height;         
    bool flip_x;        
    bool flip_y;        
 
    int cx;             
    int cy;             
    float scale_x;      
    float scale_y;      
    float theta;        
 
    // FIXME: replace this with CPU tracking of filtering mode?
    bool filtering;     
 
    // FIXME: remove this?
    int nx;             
    int ny;             
} rdpq_blitparms_t;
 
void rdpq_tex_blit(const surface_t *surf, float x0, float y0, const rdpq_blitparms_t *parms);
 
__attribute__((deprecated("use rdpq_tex_upload instead")))
static inline int rdpq_tex_load(rdpq_tile_t tile, surface_t *tex, const rdpq_texparms_t *parms) {
    return rdpq_tex_upload(tile, tex, parms);
}
__attribute__((deprecated("use rdpq_tex_upload_sub instead")))
static inline int rdpq_tex_load_sub(rdpq_tile_t tile, surface_t *tex, const rdpq_texparms_t *parms, int s0, int t0, int s1, int t1) {
    return rdpq_tex_upload_sub(tile, tex, parms, s0, t0, s1, t1);
}
__attribute__((deprecated("use rdpq_tex_upload_tlut instead")))
static inline void rdpq_tex_load_tlut(uint16_t *tlut, int color_idx, int num_colors) {
    return rdpq_tex_upload_tlut(tlut, color_idx, num_colors);
}
 
#ifdef __cplusplus
}
#endif
 
#endif