tavo/skr
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

these can be funcs

Browse source
This commit is contained in:
tavo 2025-10-03 11:12:59 -06:00
parent 348e0c42a6
commit 15bea3de8d
2 changed files with 83 additions and 87 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
README.md
View file

@ -1,3 +1,9 @@
# skr # skr
Single-header 3D graphics engine Single-header 3D graphics engine
## Dependencies
- An GL loader
- A window backend (glfw, sdl)
- cglm

162
skr/skr.h
View file

@ -24,9 +24,13 @@
#ifndef SKR_H #ifndef SKR_H
#define SKR_H #define SKR_H
#ifndef __gl_h_
#include <GL/glew.h> #include <GL/glew.h>
#endif
#include <GLFW/glfw3.h> #include <GLFW/glfw3.h>
#include <cglm/cglm.h> #include <cglm/cglm.h>
#include <stdarg.h>
#include <stdio.h> #include <stdio.h>
#include <stdlib.h> #include <stdlib.h>
#include <string.h> #include <string.h>
@ -56,48 +60,12 @@ extern "C" {
* If the buffer is empty (first character == '\0'), * If the buffer is empty (first character == '\0'),
* then no error is currently set. * then no error is currently set.
* *
* @see SKR_LAST_ERROR_CLEAR * @see m_skr_last_error_clear
* @see SKR_LAST_ERROR_SET * @see m_skr_last_error_set
* @see SKR_OK * @see SKR_OK
*/ */
static char SKR_LAST_ERROR[SKR_LAST_ERROR_SIZE]; static char SKR_LAST_ERROR[SKR_LAST_ERROR_SIZE];
/**
* @internal
* @brief Clears the global error buffer.
*
* Sets the first character of `SKR_LAST_ERROR` to '\0', effectively removing
* any previously stored error message.
*
* @usage
* SKR_LAST_ERROR_CLEAR();
*/
#define SKR_LAST_ERROR_CLEAR() (SKR_LAST_ERROR[0] = '\0')
/**
* @internal
* @brief Sets the global error message.
*
* Formats and writes a message into `SKR_LAST_ERROR` using `snprintf()`
* semantics. Any previous error is overwritten.
*
* @param fmt Format string (like printf).
* @param ... Optional arguments for the format string.
*
* @details
* This macro stores the last error encountered by the application in a global
* buffer of size `SKR_LAST_ERROR_SIZE`. It is safe and bounded by the buffer
* size.
*
* @usage
* if (!init_graphics()) {
* SKR_LAST_ERROR_SET("Graphics init failed: %s", reason);
* return false;
* }
*/
#define SKR_LAST_ERROR_SET(fmt, ...) \
snprintf(SKR_LAST_ERROR, SKR_LAST_ERROR_SIZE, fmt, ##__VA_ARGS__)
/** /**
* @brief Checks if there is no error set. * @brief Checks if there is no error set.
* *
@ -211,21 +179,21 @@ typedef struct SkrVertex {
* *
* Three-component vector (x, y, z). * Three-component vector (x, y, z).
*/ */
float Position[3]; vec3 Position;
/** /**
* @brief Vertex normal vector. * @brief Vertex normal vector.
* *
* Used for lighting calculations. Three components (x, y, z). * Used for lighting calculations. Three components (x, y, z).
*/ */
float Normal[3]; vec3 Normal;
/** /**
* @brief Texture coordinates (UV). * @brief Texture coordinates (UV).
* *
* Two-component vector (u, v), typically in the range [0, 1]. * Two-component vector (u, v), typically in the range [0, 1].
*/ */
float UV[2]; vec2 UV;
/** /**
* @brief Tangent vector. * @brief Tangent vector.
@ -233,7 +201,7 @@ typedef struct SkrVertex {
* Defines the direction of increasing U in the tangent space. * Defines the direction of increasing U in the tangent space.
* Used for normal mapping. Three components (x, y, z). * Used for normal mapping. Three components (x, y, z).
*/ */
float Tangent[3]; vec3 Tangent;
/** /**
* @brief Bitangent vector. * @brief Bitangent vector.
@ -242,7 +210,7 @@ typedef struct SkrVertex {
* Orthogonal to both the normal and tangent. Three components (x, y, * Orthogonal to both the normal and tangent. Three components (x, y,
* z). * z).
*/ */
float Bitangent[3]; vec3 Bitangent;
/** /**
* @brief Indices of influencing bones. * @brief Indices of influencing bones.
@ -388,6 +356,36 @@ typedef struct SkrModel {
char* Path; /*!< Filesystem path of the model file. */ char* Path; /*!< Filesystem path of the model file. */
} SkrModel; } SkrModel;
/**
* @internal
* @brief Set the last error message.
*
* Formats a string with printf-style arguments and stores it into the global
* error buffer `SKR_LAST_ERROR`. This allows subsequent functions to retrieve a
* human-readable description of the most recent failure.
*
* @param fmt Format string
* @param ... Arguments corresponding to the format specifiers in `fmt`.
*/
static inline void m_skr_last_error_set(const char* fmt, ...) {
va_list args;
va_start(args, fmt);
vsnprintf(SKR_LAST_ERROR, SKR_LAST_ERROR_SIZE, fmt, args);
va_end(args);
}
/**
* @internal
* @brief Clears the global error buffer.
*
* Sets the first character of `SKR_LAST_ERROR` to '\0', effectively removing
* any previously stored error message.
*
* @usage
* m_skr_last_error_clear();
*/
static inline void m_skr_last_error_clear() { SKR_LAST_ERROR[0] = '\0'; }
/** /**
* @internal * @internal
* @brief Load an image from a file into raw pixel memory. * @brief Load an image from a file into raw pixel memory.
@ -435,7 +433,7 @@ extern void m_skr_free_image(unsigned char* image_data);
static inline char* m_skr_read_file(const char* path) { static inline char* m_skr_read_file(const char* path) {
FILE* file = fopen(path, "rb"); FILE* file = fopen(path, "rb");
if (!file) { if (!file) {
SKR_LAST_ERROR_SET("failed to open"); m_skr_last_error_set("failed to open");
return NULL; return NULL;
} }
@ -446,7 +444,7 @@ static inline char* m_skr_read_file(const char* path) {
char* buffer = (char*)malloc(len + 1); char* buffer = (char*)malloc(len + 1);
if (!buffer) { if (!buffer) {
fclose(file); fclose(file);
SKR_LAST_ERROR_SET("failed to open"); m_skr_last_error_set("failed to open");
return NULL; return NULL;
} }
@ -454,7 +452,7 @@ static inline char* m_skr_read_file(const char* path) {
buffer[len] = '\0'; buffer[len] = '\0';
fclose(file); fclose(file);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return buffer; return buffer;
} }
@ -470,7 +468,7 @@ static inline char* m_skr_read_file(const char* path) {
static inline void m_skr_gl_framebuffer_size_callback(const int width, static inline void m_skr_gl_framebuffer_size_callback(const int width,
const int height) { const int height) {
glViewport(0, 0, width, height); glViewport(0, 0, width, height);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
/** /**
@ -485,7 +483,7 @@ static inline void m_skr_gl_glfw_framebuffer_size_callback(GLFWwindow* window,
const int width, const int width,
const int height) { const int height) {
m_skr_gl_framebuffer_size_callback(width, height); m_skr_gl_framebuffer_size_callback(width, height);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
/** /**
@ -497,7 +495,8 @@ static inline void m_skr_gl_glfw_framebuffer_size_callback(GLFWwindow* window,
*/ */
static inline int m_skr_gl_glfw_init(SkrWindow* w) { static inline int m_skr_gl_glfw_init(SkrWindow* w) {
if (!glfwInit() || !w) { if (!glfwInit() || !w) {
SKR_LAST_ERROR_SET("either glfwInit != 1 or SkrWindow == NULL"); m_skr_last_error_set(
"either glfwInit != 1 or SkrWindow == NULL");
return 0; return 0;
} }
@ -514,7 +513,7 @@ static inline int m_skr_gl_glfw_init(SkrWindow* w) {
glfwCreateWindow(w->Width, w->Height, w->Title, NULL, NULL); glfwCreateWindow(w->Width, w->Height, w->Title, NULL, NULL);
if (!w->Backend.Handler.GLFW) { if (!w->Backend.Handler.GLFW) {
SKR_LAST_ERROR_SET("window backend is NULL"); m_skr_last_error_set("window backend is NULL");
glfwTerminate(); glfwTerminate();
return 0; return 0;
} }
@ -523,7 +522,7 @@ static inline int m_skr_gl_glfw_init(SkrWindow* w) {
m_skr_gl_glfw_framebuffer_size_callback); m_skr_gl_glfw_framebuffer_size_callback);
glfwMakeContextCurrent(w->Backend.Handler.GLFW); glfwMakeContextCurrent(w->Backend.Handler.GLFW);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return 1; return 1;
} }
@ -546,8 +545,8 @@ static inline int m_skr_gl_check_compile_errors(const GLuint shader,
if (!success) { if (!success) {
glGetProgramInfoLog(shader, sizeof(infoLog), NULL, glGetProgramInfoLog(shader, sizeof(infoLog), NULL,
infoLog); infoLog);
SKR_LAST_ERROR_SET("failed to link %s: %s", type, m_skr_last_error_set("failed to link %s: %s", type,
infoLog); infoLog);
return 0; return 0;
} }
} else { } else {
@ -555,8 +554,8 @@ static inline int m_skr_gl_check_compile_errors(const GLuint shader,
if (!success) { if (!success) {
glGetShaderInfoLog(shader, sizeof(infoLog), NULL, glGetShaderInfoLog(shader, sizeof(infoLog), NULL,
infoLog); infoLog);
SKR_LAST_ERROR_SET("failed to compile %s: %s", type, m_skr_last_error_set("failed to compile %s: %s", type,
infoLog); infoLog);
return 0; return 0;
} }
} }
@ -590,15 +589,6 @@ static inline GLuint m_skr_gl_create_shader(const GLenum type,
case GL_GEOMETRY_SHADER: case GL_GEOMETRY_SHADER:
type_str = "geom"; type_str = "geom";
break; break;
case GL_COMPUTE_SHADER:
type_str = "comp";
break;
case GL_TESS_CONTROL_SHADER:
type_str = "tesc";
break;
case GL_TESS_EVALUATION_SHADER:
type_str = "tese";
break;
default: default:
type_str = "unknown"; type_str = "unknown";
break; break;
@ -609,7 +599,7 @@ static inline GLuint m_skr_gl_create_shader(const GLenum type,
return 0; return 0;
} }
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return shader; return shader;
} }
@ -634,7 +624,7 @@ static inline GLuint m_skr_gl_create_shader_from_file(const GLenum type,
GLuint shader = m_skr_gl_create_shader(type, source); GLuint shader = m_skr_gl_create_shader(type, source);
free(source); free(source);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return shader; return shader;
} }
@ -667,7 +657,7 @@ static inline GLuint m_skr_gl_create_program(const GLuint* shaders,
glDeleteShader(shaders[i]); glDeleteShader(shaders[i]);
} }
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return program; return program;
} }
@ -684,13 +674,13 @@ static inline GLuint
m_skr_gl_create_program_from_shaders(const SkrShader* shaders_input, m_skr_gl_create_program_from_shaders(const SkrShader* shaders_input,
const size_t count) { const size_t count) {
if (!shaders_input || count == 0) { if (!shaders_input || count == 0) {
SKR_LAST_ERROR_SET("either shaders_input != 1 or count == 0"); m_skr_last_error_set("either shaders_input != 1 or count == 0");
return 0; return 0;
} }
GLuint* shaders = (GLuint*)malloc(sizeof(GLuint) * count); GLuint* shaders = (GLuint*)malloc(sizeof(GLuint) * count);
if (!shaders) { if (!shaders) {
SKR_LAST_ERROR_SET("shaders_input == NULL"); m_skr_last_error_set("shaders_input == NULL");
return 0; return 0;
} }
@ -708,7 +698,7 @@ m_skr_gl_create_program_from_shaders(const SkrShader* shaders_input,
glDeleteShader(shaders[j]); glDeleteShader(shaders[j]);
} }
free(shaders); free(shaders);
SKR_LAST_ERROR_SET( m_skr_last_error_set(
"shader.Source and shader.Path are NULL"); "shader.Source and shader.Path are NULL");
return 0; return 0;
} }
@ -731,7 +721,7 @@ m_skr_gl_create_program_from_shaders(const SkrShader* shaders_input,
return 0; return 0;
} }
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return program; return program;
} }
@ -741,7 +731,7 @@ m_skr_gl_create_program_from_shaders(const SkrShader* shaders_input,
*/ */
static inline void m_skr_gl_shader_use(const GLuint program) { static inline void m_skr_gl_shader_use(const GLuint program) {
glUseProgram(program); glUseProgram(program);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
/** /**
@ -754,48 +744,48 @@ static inline void m_skr_gl_shader_destroy(GLuint* program) {
if (program && *program) { if (program && *program) {
glDeleteProgram(*program); glDeleteProgram(*program);
*program = 0; *program = 0;
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
} }
static inline void m_skr_gl_shader_set_bool(const GLuint program, static inline void m_skr_gl_shader_set_bool(const GLuint program,
const char* name, const int value) { const char* name, const int value) {
glUniform1i(glGetUniformLocation(program, name), value); glUniform1i(glGetUniformLocation(program, name), value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_int(const GLuint program, static inline void m_skr_gl_shader_set_int(const GLuint program,
const char* name, const int value) { const char* name, const int value) {
glUniform1i(glGetUniformLocation(program, name), value); glUniform1i(glGetUniformLocation(program, name), value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_float(const GLuint program, static inline void m_skr_gl_shader_set_float(const GLuint program,
const char* name, const char* name,
const float value) { const float value) {
glUniform1f(glGetUniformLocation(program, name), value); glUniform1f(glGetUniformLocation(program, name), value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_vec2(const GLuint program, static inline void m_skr_gl_shader_set_vec2(const GLuint program,
const char* name, const char* name,
const vec2 value) { const vec2 value) {
glUniform2fv(glGetUniformLocation(program, name), 1, value); glUniform2fv(glGetUniformLocation(program, name), 1, value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_vec3(const GLuint program, static inline void m_skr_gl_shader_set_vec3(const GLuint program,
const char* name, const char* name,
const vec3 value) { const vec3 value) {
glUniform3fv(glGetUniformLocation(program, name), 1, value); glUniform3fv(glGetUniformLocation(program, name), 1, value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_vec4(const GLuint program, static inline void m_skr_gl_shader_set_vec4(const GLuint program,
const char* name, const char* name,
const vec4 value) { const vec4 value) {
glUniform4fv(glGetUniformLocation(program, name), 1, value); glUniform4fv(glGetUniformLocation(program, name), 1, value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_mat2(const GLuint program, static inline void m_skr_gl_shader_set_mat2(const GLuint program,
@ -803,7 +793,7 @@ static inline void m_skr_gl_shader_set_mat2(const GLuint program,
const mat2 value) { const mat2 value) {
glUniformMatrix2fv(glGetUniformLocation(program, name), 1, GL_FALSE, glUniformMatrix2fv(glGetUniformLocation(program, name), 1, GL_FALSE,
(const float*)value); (const float*)value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_mat3(const GLuint program, static inline void m_skr_gl_shader_set_mat3(const GLuint program,
@ -811,7 +801,7 @@ static inline void m_skr_gl_shader_set_mat3(const GLuint program,
const mat3 value) { const mat3 value) {
glUniformMatrix3fv(glGetUniformLocation(program, name), 1, GL_FALSE, glUniformMatrix3fv(glGetUniformLocation(program, name), 1, GL_FALSE,
(const float*)value); (const float*)value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_shader_set_mat4(const GLuint program, static inline void m_skr_gl_shader_set_mat4(const GLuint program,
@ -819,7 +809,7 @@ static inline void m_skr_gl_shader_set_mat4(const GLuint program,
const mat4 value) { const mat4 value) {
glUniformMatrix4fv(glGetUniformLocation(program, name), 1, GL_FALSE, glUniformMatrix4fv(glGetUniformLocation(program, name), 1, GL_FALSE,
(const float*)value); (const float*)value);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
static inline void m_skr_gl_renderer_init() {} static inline void m_skr_gl_renderer_init() {}
@ -905,7 +895,7 @@ static inline int m_skr_gl_load_texture_2d_from_path(const char* path,
unsigned char* data = unsigned char* data =
m_skr_load_image_from_file(path, &width, &height, &nrChannels); m_skr_load_image_from_file(path, &width, &height, &nrChannels);
if (!data) { if (!data) {
SKR_LAST_ERROR_SET("failed to load texture"); m_skr_last_error_set("failed to load texture");
return 0; return 0;
} }
@ -923,7 +913,7 @@ static inline int m_skr_gl_load_texture_2d_from_path(const char* path,
m_skr_free_image(data); m_skr_free_image(data);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return 1; return 1;
} }
@ -941,7 +931,7 @@ static inline int m_skr_gl_load_textures_2d_from_paths(const char** paths,
} }
} }
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
return 1; return 1;
} }
@ -953,7 +943,7 @@ static inline void m_skr_free_textures_2d(unsigned int* textures,
const int count) { const int count) {
if (count > 0 && textures) { if (count > 0 && textures) {
glDeleteTextures(count, textures); glDeleteTextures(count, textures);
SKR_LAST_ERROR_CLEAR(); m_skr_last_error_clear();
} }
} }