2 * kmscon - OpenGL Helpers
4 * Copyright (c) 2011-2012 David Herrmann <dh.herrmann@googlemail.com>
5 * Copyright (c) 2011 University of Tuebingen
7 * Permission is hereby granted, free of charge, to any person obtaining
8 * a copy of this software and associated documentation files
9 * (the "Software"), to deal in the Software without restriction, including
10 * without limitation the rights to use, copy, modify, merge, publish,
11 * distribute, sublicense, and/or sell copies of the Software, and to
12 * permit persons to whom the Software is furnished to do so, subject to
13 * the following conditions:
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
22 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
29 * This file provides several helper functions that are commonly used when
30 * working with OpenGL.
36 #include <GLES2/gl2.h>
37 #include <GLES2/gl2ext.h>
45 * The gl_m4 type is a 4x4 matrix of floats. The gl_m4_stack is a stack of m4
46 * matrices where you can only access the top-most member.
51 void gl_m4_identity(float *m);
52 void gl_m4_copy(float *dest, const float *src);
53 void gl_m4_mult_dest(float *dest, const float *n, const float *m);
54 void gl_m4_mult(float *n, const float *m);
55 void gl_m4_translate(float *m, float x, float y, float z);
56 void gl_m4_scale(float *m, float x, float y, float z);
57 void gl_m4_transpose_dest(float *dest, const float *src);
58 void gl_m4_transpose(float *m);
60 int gl_m4_stack_new(struct gl_m4_stack **out);
61 void gl_m4_stack_free(struct gl_m4_stack *stack);
62 float *gl_m4_stack_push(struct gl_m4_stack *stack);
63 float *gl_m4_stack_pop(struct gl_m4_stack *stack);
64 float *gl_m4_stack_tip(struct gl_m4_stack *stack);
68 * These helpers load, compile and link shaders and allow easy attribute/uniform
74 int gl_shader_new(struct gl_shader **out, const char *vert, const char *frag,
75 char **attr, size_t attr_count, llog_submit_t llog,
77 void gl_shader_ref(struct gl_shader *shader);
78 void gl_shader_unref(struct gl_shader *shader);
79 GLuint gl_shader_get_uniform(struct gl_shader *shader, const char *name);
80 void gl_shader_use(struct gl_shader *shader);
82 void gl_tex_new(GLuint *tex, size_t num);
83 void gl_tex_free(GLuint *tex, size_t num);
84 void gl_tex_load(GLuint tex, unsigned int width, unsigned int stride,
85 unsigned int height, uint8_t *buf);
87 void gl_clear_error();
88 bool gl_has_error(struct gl_shader *shader);
89 const char *gl_err_to_str(GLenum err);
91 #endif /* GL_H_INCLUDED */