52 lines
2.0 KiB
C
52 lines
2.0 KiB
C
#ifndef TEXTURES_H
|
|
#define TEXTURES_H
|
|
|
|
#include "private/textures.h"
|
|
#include "util.h"
|
|
|
|
#include <SDL2/SDL.h>
|
|
#include <glad/glad.h>
|
|
|
|
/* type safe structure for persistent texture handles */
|
|
typedef struct { uint16_t id; } t_texture_key;
|
|
|
|
/* tests whether given key structure corresponds to any texture */
|
|
#define m_texture_key_is_valid(p_key) ((p_key).id != (uint16_t)-1)
|
|
|
|
void textures_cache_init(struct texture_cache *cache, SDL_Window *window);
|
|
void textures_cache_deinit(struct texture_cache *cache);
|
|
|
|
/* for debugging */
|
|
void textures_dump_atlases(struct texture_cache *cache);
|
|
|
|
/* loads an image if it isn't in the cache, otherwise a no-op. */
|
|
/* can be called from anywhere at any time after init, useful if you want to */
|
|
/* preload textures you know will definitely be used */
|
|
// void textures_load(struct texture_cache *cache, const char *path);
|
|
|
|
/* repacks the current texture atlas based on the texture cache if needed */
|
|
/* any previously returned srcrect results are invalidated after that */
|
|
/* call it every time before rendering */
|
|
void textures_update_atlas(struct texture_cache *cache);
|
|
|
|
/* returns a persistent handle to some texture in cache, loading it if needed */
|
|
/* check the result with m_texture_key_is_valid() */
|
|
t_texture_key textures_get_key(struct texture_cache *cache, const char *path);
|
|
|
|
/* returns a rect in a texture cache of the given key */
|
|
t_rect textures_get_srcrect(const struct texture_cache *cache, t_texture_key key);
|
|
|
|
/* returns a rect of dimensions of the whole texture (whole atlas) */
|
|
t_rect textures_get_dims(const struct texture_cache *cache, t_texture_key key);
|
|
|
|
/* returns an identifier that is equal for all textures placed in the same atlas */
|
|
int32_t textures_get_atlas_id(const struct texture_cache *cache, t_texture_key key);
|
|
|
|
/* binds atlas texture in opengl state */
|
|
void textures_bind(const struct texture_cache *cache, t_texture_key key, GLenum target);
|
|
|
|
/* returns the number of atlases in the cache */
|
|
size_t textures_get_num_atlases(const struct texture_cache *cache);
|
|
|
|
#endif
|