1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
#ifndef HONEY_TEXTURE_H
#define HONEY_TEXTURE_H
/** @file texture.h
*
*@brief Defines the honey_texture struct and associated functions.
*/
#include "common.h"
#define HONEY_TEXTURE_DEFAULT_WIDTH 1024
#define HONEY_TEXTURE_DEFAULT_HEIGHT 1024
#define HONEY_TEXTURE_DEFAULT_CHANNELS 4
#define HONEY_TEXTURE_DEFAULT_TYPE HONEY_TEXTURE_TYPE_RGBA
#define HONEY_TEXTURE_DEFAULT_MIPMAPS false
#define HONEY_TEXTURE_DEFAULT_MIN_FILTER GL_LINEAR
#define HONEY_TEXTURE_DEFAULT_MAG_FILTER GL_LINEAR
#define HONEY_TEXTURE_DEFAULT_WRAP_S GL_REPEAT
#define HONEY_TEXTURE_DEFAULT_WRAP_T GL_REPEAT
#define HONEY_TEXTURE_DEFAULT_WRAP_R GL_REPEAT
#define HONEY_TEXTURE_TYPE_GREY GL_RED
#define HONEY_TEXTURE_TYPE_RGB GL_RGB
#define HONEY_TEXTURE_TYPE_RGBA GL_RGBA
#define HONEY_TEXTURE_TYPE_DEPTH GL_DEPTH_COMPONENT
extern int honey_texture_mt_ref;
enum honey_texture_result {
TEXTURE_OK,
TEXTURE_FAILED,
TEXTURE_CHANNEL_ERROR,
N_TEXTURE_RESULTS };
typedef struct {
int width;
int height;
int channels;
int type;
bool mipmaps;
int min_filter;
int mag_filter;
int wrap_s;
int wrap_t;
int wrap_r;
} honey_texture_params;
typedef struct {
unsigned int id;
honey_texture_params params;
} honey_texture;
/** @brief Place the honey.texture bindings as a table on the stack. */
void honey_setup_texture(lua_State* L);
/** @brief Generate a texture.
*
* @param[out] texture Pointer to the destination texture.
* @param[in] data The data to populate the texture with, or NULL to leave it unpopulated.
*
* @returns Nothing.
*/
void honey_texture_generate(honey_texture* texture,
void* data);
/** @brief Set the parameters of a texture.
*
* This function takes the parameters given in a texture's `params` field
* and applies them to it's OpenGL object. `honey_texture_generate` must be called
* before using this function.
*
* @param[inout] texture The texture to configure.
*/
void honey_texture_configure(honey_texture* texture);
/** @brief Update the mipmaps of a texture.
*
* If a texture has params.mipmaps set to false, this function does nothing.
*
* @param[inout] texture The texture to generate new mipmaps for.
*
* @returns Nothing.
*/
void honey_texture_update_mipmaps(honey_texture* texture);
/** @brief Load a texture from disk.
*
* @param[out] texture Pointer to the destination texture
* @param[in] texture_path Path to the location of the texture
* @param[in] alpha_channel Set to true if the target image contains an alpha channel
*
* @return Success or failure type
*/
enum honey_texture_result honey_texture_load(honey_texture* texture,
char* texture_path);
/** @brief Load a texture into a texture unit.
*
* @param[in] texture The texture to use
* @param[in] texture_unit The texture unit to put the texture in
*/
void honey_texture_use(honey_texture texture, int texture_unit);
/** @brief Create a framebuffer object.
*
* You must specify at least one of draw and depth; otherwise, the framebuffer will
* be incomplete and fail.
*
* @param[out] destination Pointer to store the resulting OpenGL handle in.
* @param[in] draw Pointer to a texture to draw to.
* @param[in] depth Pointer to a depth texture.
* @param[in] width The width in pixels of the FBO.
* @param[in] height The height in pixels of the FBO.
*
* @returns Nothing.
*/
void honey_texture_framebuffer_object_new(unsigned int* destination,
honey_texture* draw,
honey_texture* depth,
int width, int height);
#endif
|
