shylie/sprstk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Initial commit

Browse Source
This commit is contained in:
shylie 2025-08-02 13:39:43 -04:00
commit 4f87a354c0
10 changed files with 6015 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.gitignore vendored Normal file
View File

@ -0,0 +1,2 @@
build/
.cache/

18
CMakeLists.txt Normal file
View File

@ -0,0 +1,18 @@
cmake_minimum_required(VERSION 3.21)
project(sprstk)
find_package(SDL3 REQUIRED)
add_library(sprstk
src/sprstk.cpp
src/gl.c
)
target_include_directories(sprstk PUBLIC include PRIVATE src)
target_link_libraries(sprstk PUBLIC SDL3::SDL3)
if(PROJECT_IS_TOP_LEVEL)
add_subdirectory(examples)
endif()

17
LICENSE Normal file
View File

@ -0,0 +1,17 @@
Copyright (c) 2025 shylie
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.

8
examples/CMakeLists.txt Normal file
View File

@ -0,0 +1,8 @@
cmake_minimum_required(VERSION 3.21)
function(add_example name)
add_executable("example-${name}" ${name}.cpp)
target_link_libraries("example-${name}" PUBLIC sprstk)
endfunction()
add_example(basic)

12
examples/basic.cpp Normal file
View File

@ -0,0 +1,12 @@
#include <sprstk/sprstk.h>
int main()
{
sprstk* instance = sprstk_new({.update = [](sprstk*, float, void*) {}}, nullptr);
sprstk_run(instance);
sprstk_stop(instance);
return 0;
}

31
include/sprstk/sprstk.h Normal file
View File

@ -0,0 +1,31 @@
#ifndef SPRSTK_H
#define SPRSTK_H
#ifdef __cplusplus
extern "C"
{
#endif
typedef struct sprstk sprstk;
typedef void (*sprstk_init_fn)(sprstk* instance, void* userdata);
typedef void (*sprstk_update_fn)(sprstk* instance, float dt, void* userdata);
typedef void (*sprstk_quit_fn)(sprstk* instance, void* userdata);
typedef struct {
sprstk_init_fn init;
sprstk_update_fn update;
sprstk_quit_fn quit;
} sprstk_callbacks;
sprstk* sprstk_new(sprstk_callbacks callbacks, void* userdata);
void sprstk_del(sprstk* instance);
void sprstk_run(sprstk* instance);
void sprstk_stop(sprstk* instance);
#ifdef __cplusplus
}
#endif
#endif//SPRSTK_H

311
src/KHR/khrplatform.h Normal file
View File

@ -0,0 +1,311 @@
#ifndef __khrplatform_h_
#define __khrplatform_h_
/*
** Copyright (c) 2008-2018 The Khronos Group Inc.
**
** Permission is hereby granted, free of charge, to any person obtaining a
** copy of this software and/or associated documentation files (the
** "Materials"), to deal in the Materials without restriction, including
** without limitation the rights to use, copy, modify, merge, publish,
** distribute, sublicense, and/or sell copies of the Materials, and to
** permit persons to whom the Materials are furnished to do so, subject to
** the following conditions:
**
** The above copyright notice and this permission notice shall be included
** in all copies or substantial portions of the Materials.
**
** THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
** EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
** MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
** CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
** TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
** MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
*/
/* Khronos platform-specific types and definitions.
*
* The master copy of khrplatform.h is maintained in the Khronos EGL
* Registry repository at https://github.com/KhronosGroup/EGL-Registry
* The last semantic modification to khrplatform.h was at commit ID:
* 67a3e0864c2d75ea5287b9f3d2eb74a745936692
*
* Adopters may modify this file to suit their platform. Adopters are
* encouraged to submit platform specific modifications to the Khronos
* group so that they can be included in future versions of this file.
* Please submit changes by filing pull requests or issues on
* the EGL Registry repository linked above.
*
*
* See the Implementer's Guidelines for information about where this file
* should be located on your system and for more details of its use:
* http://www.khronos.org/registry/implementers_guide.pdf
*
* This file should be included as
* #include <KHR/khrplatform.h>
* by Khronos client API header files that use its types and defines.
*
* The types in khrplatform.h should only be used to define API-specific types.
*
* Types defined in khrplatform.h:
* khronos_int8_t signed 8 bit
* khronos_uint8_t unsigned 8 bit
* khronos_int16_t signed 16 bit
* khronos_uint16_t unsigned 16 bit
* khronos_int32_t signed 32 bit
* khronos_uint32_t unsigned 32 bit
* khronos_int64_t signed 64 bit
* khronos_uint64_t unsigned 64 bit
* khronos_intptr_t signed same number of bits as a pointer
* khronos_uintptr_t unsigned same number of bits as a pointer
* khronos_ssize_t signed size
* khronos_usize_t unsigned size
* khronos_float_t signed 32 bit floating point
* khronos_time_ns_t unsigned 64 bit time in nanoseconds
* khronos_utime_nanoseconds_t unsigned time interval or absolute time in
* nanoseconds
* khronos_stime_nanoseconds_t signed time interval in nanoseconds
* khronos_boolean_enum_t enumerated boolean type. This should
* only be used as a base type when a client API's boolean type is
* an enum. Client APIs which use an integer or other type for
* booleans cannot use this as the base type for their boolean.
*
* Tokens defined in khrplatform.h:
*
* KHRONOS_FALSE, KHRONOS_TRUE Enumerated boolean false/true values.
*
* KHRONOS_SUPPORT_INT64 is 1 if 64 bit integers are supported; otherwise 0.
* KHRONOS_SUPPORT_FLOAT is 1 if floats are supported; otherwise 0.
*
* Calling convention macros defined in this file:
* KHRONOS_APICALL
* KHRONOS_APIENTRY
* KHRONOS_APIATTRIBUTES
*
* These may be used in function prototypes as:
*
* KHRONOS_APICALL void KHRONOS_APIENTRY funcname(
* int arg1,
* int arg2) KHRONOS_APIATTRIBUTES;
*/
#if defined(__SCITECH_SNAP__) && !defined(KHRONOS_STATIC)
# define KHRONOS_STATIC 1
#endif
/*-------------------------------------------------------------------------
* Definition of KHRONOS_APICALL
*-------------------------------------------------------------------------
* This precedes the return type of the function in the function prototype.
*/
#if defined(KHRONOS_STATIC)
/* If the preprocessor constant KHRONOS_STATIC is defined, make the
* header compatible with static linking. */
# define KHRONOS_APICALL
#elif defined(_WIN32)
# define KHRONOS_APICALL __declspec(dllimport)
#elif defined (__SYMBIAN32__)
# define KHRONOS_APICALL IMPORT_C
#elif defined(__ANDROID__)
# define KHRONOS_APICALL __attribute__((visibility("default")))
#else
# define KHRONOS_APICALL
#endif
/*-------------------------------------------------------------------------
* Definition of KHRONOS_APIENTRY
*-------------------------------------------------------------------------
* This follows the return type of the function and precedes the function
* name in the function prototype.
*/
#if defined(_WIN32) && !defined(_WIN32_WCE) && !defined(__SCITECH_SNAP__)
/* Win32 but not WinCE */
# define KHRONOS_APIENTRY __stdcall
#else
# define KHRONOS_APIENTRY
#endif
/*-------------------------------------------------------------------------
* Definition of KHRONOS_APIATTRIBUTES
*-------------------------------------------------------------------------
* This follows the closing parenthesis of the function prototype arguments.
*/
#if defined (__ARMCC_2__)
#define KHRONOS_APIATTRIBUTES __softfp
#else
#define KHRONOS_APIATTRIBUTES
#endif
/*-------------------------------------------------------------------------
* basic type definitions
*-----------------------------------------------------------------------*/
#if (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 199901L) || defined(__GNUC__) || defined(__SCO__) || defined(__USLC__)
/*
* Using <stdint.h>
*/
#include <stdint.h>
typedef int32_t khronos_int32_t;
typedef uint32_t khronos_uint32_t;
typedef int64_t khronos_int64_t;
typedef uint64_t khronos_uint64_t;
#define KHRONOS_SUPPORT_INT64 1
#define KHRONOS_SUPPORT_FLOAT 1
/*
* To support platform where unsigned long cannot be used interchangeably with
* inptr_t (e.g. CHERI-extended ISAs), we can use the stdint.h intptr_t.
* Ideally, we could just use (u)intptr_t everywhere, but this could result in
* ABI breakage if khronos_uintptr_t is changed from unsigned long to
* unsigned long long or similar (this results in different C++ name mangling).
* To avoid changes for existing platforms, we restrict usage of intptr_t to
* platforms where the size of a pointer is larger than the size of long.
*/
#if defined(__SIZEOF_LONG__) && defined(__SIZEOF_POINTER__)
#if __SIZEOF_POINTER__ > __SIZEOF_LONG__
#define KHRONOS_USE_INTPTR_T
#endif
#endif
#elif defined(__VMS ) || defined(__sgi)
/*
* Using <inttypes.h>
*/
#include <inttypes.h>
typedef int32_t khronos_int32_t;
typedef uint32_t khronos_uint32_t;
typedef int64_t khronos_int64_t;
typedef uint64_t khronos_uint64_t;
#define KHRONOS_SUPPORT_INT64 1
#define KHRONOS_SUPPORT_FLOAT 1
#elif defined(_WIN32) && !defined(__SCITECH_SNAP__)
/*
* Win32
*/
typedef __int32 khronos_int32_t;
typedef unsigned __int32 khronos_uint32_t;
typedef __int64 khronos_int64_t;
typedef unsigned __int64 khronos_uint64_t;
#define KHRONOS_SUPPORT_INT64 1
#define KHRONOS_SUPPORT_FLOAT 1
#elif defined(__sun__) || defined(__digital__)
/*
* Sun or Digital
*/
typedef int khronos_int32_t;
typedef unsigned int khronos_uint32_t;
#if defined(__arch64__) || defined(_LP64)
typedef long int khronos_int64_t;
typedef unsigned long int khronos_uint64_t;
#else
typedef long long int khronos_int64_t;
typedef unsigned long long int khronos_uint64_t;
#endif /* __arch64__ */
#define KHRONOS_SUPPORT_INT64 1
#define KHRONOS_SUPPORT_FLOAT 1
#elif 0
/*
* Hypothetical platform with no float or int64 support
*/
typedef int khronos_int32_t;
typedef unsigned int khronos_uint32_t;
#define KHRONOS_SUPPORT_INT64 0
#define KHRONOS_SUPPORT_FLOAT 0
#else
/*
* Generic fallback
*/
#include <stdint.h>
typedef int32_t khronos_int32_t;
typedef uint32_t khronos_uint32_t;
typedef int64_t khronos_int64_t;
typedef uint64_t khronos_uint64_t;
#define KHRONOS_SUPPORT_INT64 1
#define KHRONOS_SUPPORT_FLOAT 1
#endif
/*
* Types that are (so far) the same on all platforms
*/
typedef signed char khronos_int8_t;
typedef unsigned char khronos_uint8_t;
typedef signed short int khronos_int16_t;
typedef unsigned short int khronos_uint16_t;
/*
* Types that differ between LLP64 and LP64 architectures - in LLP64,
* pointers are 64 bits, but 'long' is still 32 bits. Win64 appears
* to be the only LLP64 architecture in current use.
*/
#ifdef KHRONOS_USE_INTPTR_T
typedef intptr_t khronos_intptr_t;
typedef uintptr_t khronos_uintptr_t;
#elif defined(_WIN64)
typedef signed long long int khronos_intptr_t;
typedef unsigned long long int khronos_uintptr_t;
#else
typedef signed long int khronos_intptr_t;
typedef unsigned long int khronos_uintptr_t;
#endif
#if defined(_WIN64)
typedef signed long long int khronos_ssize_t;
typedef unsigned long long int khronos_usize_t;
#else
typedef signed long int khronos_ssize_t;
typedef unsigned long int khronos_usize_t;
#endif
#if KHRONOS_SUPPORT_FLOAT
/*
* Float type
*/
typedef float khronos_float_t;
#endif
#if KHRONOS_SUPPORT_INT64
/* Time types
*
* These types can be used to represent a time interval in nanoseconds or
* an absolute Unadjusted System Time. Unadjusted System Time is the number
* of nanoseconds since some arbitrary system event (e.g. since the last
* time the system booted). The Unadjusted System Time is an unsigned
* 64 bit value that wraps back to 0 every 584 years. Time intervals
* may be either signed or unsigned.
*/
typedef khronos_uint64_t khronos_utime_nanoseconds_t;
typedef khronos_int64_t khronos_stime_nanoseconds_t;
#endif
/*
* Dummy value used to pad enum types to 32 bits.
*/
#ifndef KHRONOS_MAX_ENUM
#define KHRONOS_MAX_ENUM 0x7FFFFFFF
#endif
/*
* Enumerated boolean type
*
* Values other than zero should be considered to be true. Therefore
* comparisons should not be made against KHRONOS_TRUE.
*/
typedef enum {
KHRONOS_FALSE = 0,
KHRONOS_TRUE = 1,
KHRONOS_BOOLEAN_ENUM_FORCE_SIZE = KHRONOS_MAX_ENUM
} khronos_boolean_enum_t;
#endif /* __khrplatform_h_ */

1633
src/gl.c Normal file
View File

File diff suppressed because it is too large Load Diff

3699
src/glad/gl.h Normal file
View File

File diff suppressed because it is too large Load Diff

284
src/sprstk.cpp Normal file
View File

@ -0,0 +1,284 @@
#include "sprstk/sprstk.h"
#include <glad/gl.h>
#include <SDL3/SDL.h>
#include <stdexcept>
const char* MESH_SHADER_CODE = R"(
#version 460
#extension GL_NV_mesh_shader : require
layout(local_size_x = 1) in;
layout(triangles, max_vertices = 3, max_primitives = 1) out;
layout (location = 0) out PerVertexData
{
vec4 color;
} v_out[];
const vec3 vertices[3] = {vec3(-1, -1, 0), vec3(0, 1, 0), vec3(1, -1, 0)};
const vec3 colors[3] = {vec3(1, 0, 0), vec3(0, 1, 0), vec3(0, 0, 1)};
void main()
{
gl_MeshVerticesNV[0].gl_Position = vec4(vertices[0], 1);
gl_MeshVerticesNV[1].gl_Position = vec4(vertices[1], 1);
gl_MeshVerticesNV[2].gl_Position = vec4(vertices[2], 1);
v_out[0].color = vec4(colors[0], 1);
v_out[1].color = vec4(colors[1], 1);
v_out[2].color = vec4(colors[2], 1);
gl_PrimitiveIndicesNV[0] = 0;
gl_PrimitiveIndicesNV[1] = 1;
gl_PrimitiveIndicesNV[2] = 2;
gl_PrimitiveCountNV = 1;
}
)";
const char* FRAGMENT_SHADER_CODE = R"(
#version 460
layout(location = 0) out vec4 FragColor;
in PerVertexData
{
vec4 color;
} fragIn;
void main()
{
FragColor = fragIn.color;
}
)";
class application_error : public std::runtime_error
{
public:
using runtime_error::runtime_error;
};
class sprstk
{
public:
explicit sprstk(sprstk_callbacks& callbacks, void* userdata) :
callbacks(callbacks),
userdata(userdata),
should_stop(false),
prev_ticks(0)
{
if (!callbacks.update)
{
throw std::runtime_error("No update callback");
}
}
~sprstk()
{
destroy_gl();
destroy_sdl();
}
void run()
{
init_sdl();
init_gl();
if (callbacks.init) { callbacks.init(this, userdata); }
prev_ticks = SDL_GetTicks();
while (!should_stop)
{
SDL_Event e;
while (SDL_PollEvent(&e))
{
if (e.type == SDL_EVENT_QUIT)
{
stop();
}
if (e.type == SDL_EVENT_WINDOW_RESIZED)
{
int width, height;
SDL_GetWindowSizeInPixels(sdl.window, &width, &height);
glViewport(0, 0, width, height);
}
}
uint64_t current_ticks = SDL_GetTicks();
float dt = (prev_ticks - current_ticks) / 1000.0f;
callbacks.update(this, dt, userdata);
glDrawMeshTasksNV(0, 1);
SDL_GL_SwapWindow(sdl.window);
}
if (callbacks.quit) { callbacks.quit(this, userdata); }
}
void stop()
{
should_stop = true;
}
private:
sprstk_callbacks callbacks;
void* userdata;
bool should_stop;
uint64_t prev_ticks;
struct
{
SDL_Window* window;
SDL_GLContext context;
} sdl;
struct
{
unsigned int program;
} gl;
void init_sdl()
{
if (!SDL_Init(SDL_INIT_VIDEO))
{
throw application_error("Failed to initialize SDL");
}
SDL_GL_SetAttribute(SDL_GL_CONTEXT_MAJOR_VERSION, 4);
SDL_GL_SetAttribute(SDL_GL_CONTEXT_MINOR_VERSION, 6);
SDL_GL_SetAttribute(SDL_GL_CONTEXT_PROFILE_MASK, SDL_GL_CONTEXT_PROFILE_CORE);
SDL_GL_SetAttribute(SDL_GL_DOUBLEBUFFER, 1);
SDL_GL_SetAttribute(SDL_GL_DEPTH_SIZE, 24);
sdl.window = SDL_CreateWindow("sprstk", 640, 480, SDL_WINDOW_OPENGL | SDL_WINDOW_RESIZABLE);
if (!sdl.window)
{
throw application_error("Failed to create window");
}
}
void destroy_sdl()
{
if (sdl.window) { SDL_DestroyWindow(sdl.window); }
SDL_Quit();
}
void init_gl()
{
sdl.context = SDL_GL_CreateContext(sdl.window);
if (!sdl.context)
{
throw application_error("Failed to create OpenGL context");
}
SDL_GL_MakeCurrent(sdl.window, sdl.context);
SDL_GL_SetSwapInterval(-1);
gladLoadGL(SDL_GL_GetProcAddress);
if (!GLAD_GL_NV_mesh_shader)
{
throw application_error("Mesh shaders not supported");
}
int success;
char info_log[512];
unsigned int mesh = glCreateShader(GL_MESH_SHADER_NV);
glShaderSource(mesh, 1, &MESH_SHADER_CODE, nullptr);
glCompileShader(mesh);
glGetShaderiv(mesh, GL_COMPILE_STATUS, &success);
if (!success)
{
glGetShaderInfoLog(mesh, sizeof(info_log), nullptr, info_log);
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Mesh shader: %s", info_log);
}
unsigned int fragment = glCreateShader(GL_FRAGMENT_SHADER);
glShaderSource(fragment, 1, &FRAGMENT_SHADER_CODE, nullptr);
glCompileShader(fragment);
glGetShaderiv(fragment, GL_COMPILE_STATUS, &success);
if (!success)
{
glGetShaderInfoLog(fragment, sizeof(info_log), nullptr, info_log);
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Fragment shader: %s", info_log);
}
gl.program = glCreateProgram();
glAttachShader(gl.program, mesh);
glAttachShader(gl.program, fragment);
glLinkProgram(gl.program);
glGetProgramiv(gl.program, GL_LINK_STATUS, &success);
if (!success)
{
glGetProgramInfoLog(gl.program, sizeof(info_log), nullptr, info_log);
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "Program: %s", info_log);
}
glDeleteShader(mesh);
glDeleteShader(fragment);
if (!success)
{
throw application_error("Failed to compile and link shader program");
}
glUseProgram(gl.program);
}
void destroy_gl()
{
SDL_GL_DestroyContext(sdl.context);
}
};
extern "C"
{
sprstk* sprstk_new(sprstk_callbacks callbacks, void* userdata)
{
try
{
return new sprstk(callbacks, userdata);
}
catch (application_error& e)
{
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "%s", e.what());
}
catch(std::exception& e)
{
SDL_LogError(SDL_LOG_CATEGORY_ERROR, "%s", e.what());
}
return nullptr;
}
void sprstk_del(sprstk* instance)
{
delete instance;
}
void sprstk_run(sprstk* instance)
{
try
{
instance->run();
}
catch (application_error& e)
{
SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "%s", e.what());
}
catch(std::exception& e)
{
SDL_LogError(SDL_LOG_CATEGORY_ERROR, "%s", e.what());
}
}
void sprstk_stop(sprstk* instance)
{
instance->stop();
}
}