Martino Ferrari
ed3a8ce645
The repository had no licence at all, so every source was all-rights-reserved by default. Add the verbatim MIT text at LICENSE (Copyright (c) 2026 Martino Ferrari) and a two-line SPDX header to each of the 113 first-party sources -- 48 include/plot, 26 src, 10 adapters, 5 examples, 21 tests, 3 tools -- so the grant travels with each file rather than relying on the root document alone. Scripts keep their shebang on line 1; the SPDX lines follow it. Genuinely vendored code is untouched: third_party/stb_truetype.h carries no header of ours. src/render/embedded_mono_font.cpp is generated, so tools/fonts/gen_atlas.py emit() now writes the two lines into its header comment and the file was regenerated -- gen_atlas.py --check passes and the regeneration adds only those comment lines to the previously committed file. README's provenance section now states MIT and links LICENSE. No code, test or public API change.
212 lines
11 KiB
C++
212 lines
11 KiB
C++
// SPDX-License-Identifier: MIT
|
|
// SPDX-FileCopyrightText: 2026 Martino Ferrari
|
|
|
|
#pragma once
|
|
#include <plot/core/types.hpp>
|
|
|
|
// The GL surface of this library is hand-written on purpose: the core target
|
|
// links and includes nothing third-party, so there is no glad/GLEW/GLM and no
|
|
// Khronos header. Everything below is either a typedef fixed by the OpenGL
|
|
// specification or an entry point resolved at runtime by `plot::gl::load()`
|
|
// (see loader.hpp). Only OpenGL 3.3 core is assumed; anything newer is guarded
|
|
// by the capability probe in caps.hpp.
|
|
|
|
namespace plot::gl {
|
|
|
|
using GLenum = unsigned int;
|
|
using GLuint = unsigned int;
|
|
using GLint = int;
|
|
using GLsizei = int;
|
|
using GLboolean = unsigned char;
|
|
using GLbitfield = unsigned int;
|
|
using GLubyte = unsigned char;
|
|
using GLchar = char;
|
|
using GLintptr = std::intptr_t;
|
|
using GLsizeiptr = std::ptrdiff_t;
|
|
using GLuint64 = u64;
|
|
using GLsync = void*; // opaque sync object (`struct __GLsync*`)
|
|
|
|
inline constexpr GLboolean GL_FALSE = 0;
|
|
inline constexpr GLboolean GL_TRUE = 1;
|
|
|
|
// Enumerant values are fixed by the OpenGL specification; comment each group
|
|
// with the version or extension that introduced it.
|
|
enum : GLenum {
|
|
// Errors and primitives.
|
|
GL_NO_ERROR = 0x0000,
|
|
GL_LINE_STRIP = 0x0003,
|
|
GL_TRIANGLES = 0x0004,
|
|
GL_TRIANGLE_STRIP = 0x0005,
|
|
|
|
// Clear state.
|
|
GL_COLOR_BUFFER_BIT = 0x00004000,
|
|
GL_COLOR_CLEAR_VALUE = 0x0C22,
|
|
|
|
// Data types (unsigned short is the index/16-bit data type).
|
|
GL_UNSIGNED_BYTE = 0x1401,
|
|
GL_UNSIGNED_SHORT = 0x1403,
|
|
GL_FLOAT = 0x1406,
|
|
|
|
// Strings and context queries.
|
|
GL_VENDOR = 0x1F00,
|
|
GL_RENDERER = 0x1F01,
|
|
GL_VERSION = 0x1F02,
|
|
GL_EXTENSIONS = 0x1F03,
|
|
GL_NUM_EXTENSIONS = 0x821D /* 3.0 */,
|
|
GL_CONTEXT_PROFILE_MASK = 0x9126 /* 3.2 */,
|
|
GL_CONTEXT_CORE_PROFILE_BIT = 0x00000001,
|
|
|
|
// Blending.
|
|
GL_BLEND = 0x0BE2,
|
|
GL_SRC_ALPHA = 0x0302,
|
|
GL_ONE_MINUS_SRC_ALPHA = 0x0303,
|
|
|
|
// Pixel store state.
|
|
GL_UNPACK_ALIGNMENT = 0x0CF5,
|
|
GL_PACK_ALIGNMENT = 0x0D05,
|
|
|
|
// Shaders and programs.
|
|
GL_FRAGMENT_SHADER = 0x8B30,
|
|
GL_VERTEX_SHADER = 0x8B31,
|
|
GL_COMPILE_STATUS = 0x8B81,
|
|
GL_LINK_STATUS = 0x8B82,
|
|
|
|
// Buffers (3.3 baseline plus the 4.4 storage flags used by the caps-driven
|
|
// persistent-mapping path).
|
|
GL_ARRAY_BUFFER = 0x8892,
|
|
GL_DYNAMIC_DRAW = 0x88E8,
|
|
GL_STATIC_DRAW = 0x88E4,
|
|
GL_STREAM_DRAW = 0x88E0,
|
|
GL_MAP_WRITE_BIT = 0x0002 /* 4.4 */,
|
|
GL_MAP_PERSISTENT_BIT = 0x0040 /* 4.4 */,
|
|
GL_MAP_COHERENT_BIT = 0x0080 /* 4.4 */,
|
|
|
|
// Rasterisation state (1.0).
|
|
GL_SCISSOR_TEST = 0x0C11,
|
|
|
|
// Textures.
|
|
GL_TEXTURE_2D = 0x0DE1,
|
|
GL_TEXTURE0 = 0x84C0,
|
|
GL_TEXTURE_MAG_FILTER = 0x2800,
|
|
GL_TEXTURE_MIN_FILTER = 0x2801,
|
|
GL_TEXTURE_WRAP_S = 0x2802,
|
|
GL_TEXTURE_WRAP_T = 0x2803,
|
|
GL_NEAREST = 0x2600,
|
|
GL_LINEAR = 0x2601,
|
|
GL_CLAMP_TO_EDGE = 0x812F,
|
|
GL_RED = 0x1903,
|
|
GL_RGBA = 0x1908,
|
|
GL_R8 = 0x8229,
|
|
GL_RGBA8 = 0x8058,
|
|
|
|
// Framebuffer objects (renderbuffers back depth attachments).
|
|
GL_FRAMEBUFFER = 0x8D40,
|
|
GL_COLOR_ATTACHMENT0 = 0x8CE0,
|
|
GL_FRAMEBUFFER_COMPLETE = 0x8CD5,
|
|
GL_RENDERBUFFER = 0x8D41,
|
|
|
|
// Sync objects (3.2).
|
|
GL_SYNC_GPU_COMMANDS_COMPLETE = 0x9117,
|
|
GL_SYNC_FLUSH_COMMANDS_BIT = 0x00000001,
|
|
GL_ALREADY_SIGNALED = 0x911A,
|
|
GL_CONDITION_SATISFIED = 0x911C,
|
|
};
|
|
|
|
// Single source of truth for the runtime entry points: every entry is declared
|
|
// as a function pointer here and resolved by `plot::gl::load()`. Adding an
|
|
// entry makes it required, so only add what the library actually calls.
|
|
#define PLOT_GL_FUNCS(X) \
|
|
/* context and state */ \
|
|
X(const GLubyte*, glGetString, (GLenum)) \
|
|
X(const GLubyte*, glGetStringi, (GLenum, GLuint)) \
|
|
X(void, glGetIntegerv, (GLenum, GLint*)) \
|
|
X(void, glGetFloatv, (GLenum, float*)) \
|
|
X(GLenum, glGetError, (void)) \
|
|
X(void, glFinish, (void)) \
|
|
X(void, glViewport, (GLint, GLint, GLsizei, GLsizei)) \
|
|
X(void, glClearColor, (float, float, float, float)) \
|
|
X(void, glClear, (GLbitfield)) \
|
|
X(void, glEnable, (GLenum)) \
|
|
X(void, glBlendFunc, (GLenum, GLenum)) \
|
|
X(void, glPixelStorei, (GLenum, GLint)) \
|
|
X(void, glDisable, (GLenum)) \
|
|
X(void, glScissor, (GLint, GLint, GLsizei, GLsizei)) \
|
|
/* shaders and programs */ \
|
|
X(GLuint, glCreateShader, (GLenum)) \
|
|
X(void, glShaderSource, (GLuint, GLsizei, const GLchar* const*, const GLint*)) \
|
|
X(void, glCompileShader, (GLuint)) \
|
|
X(void, glGetShaderiv, (GLuint, GLenum, GLint*)) \
|
|
X(void, glGetShaderInfoLog, (GLuint, GLsizei, GLsizei*, GLchar*)) \
|
|
X(void, glDeleteShader, (GLuint)) \
|
|
X(GLuint, glCreateProgram, (void)) \
|
|
X(void, glAttachShader, (GLuint, GLuint)) \
|
|
X(void, glDetachShader, (GLuint, GLuint)) \
|
|
X(void, glLinkProgram, (GLuint)) \
|
|
X(void, glGetProgramiv, (GLuint, GLenum, GLint*)) \
|
|
X(void, glGetProgramInfoLog, (GLuint, GLsizei, GLsizei*, GLchar*)) \
|
|
X(void, glDeleteProgram, (GLuint)) \
|
|
X(void, glUseProgram, (GLuint)) \
|
|
X(GLint, glGetUniformLocation, (GLuint, const GLchar*)) \
|
|
X(void, glUniform1i, (GLint, GLint)) \
|
|
X(void, glUniform1f, (GLint, float)) \
|
|
X(void, glUniform2f, (GLint, float, float)) \
|
|
X(void, glUniform4f, (GLint, float, float, float, float)) \
|
|
X(void, glUniform1fv, (GLint, GLsizei, const float*)) \
|
|
X(void, glUniform2fv, (GLint, GLsizei, const float*)) \
|
|
/* buffers */ \
|
|
X(void, glGenBuffers, (GLsizei, GLuint*)) \
|
|
X(void, glDeleteBuffers, (GLsizei, const GLuint*)) \
|
|
X(void, glBindBuffer, (GLenum, GLuint)) \
|
|
X(void, glBufferData, (GLenum, GLsizeiptr, const void*, GLenum)) \
|
|
X(void, glBufferSubData, (GLenum, GLintptr, GLsizeiptr, const void*)) \
|
|
X(void*, glMapBufferRange, (GLenum, GLintptr, GLsizeiptr, GLbitfield)) \
|
|
X(GLboolean, glUnmapBuffer, (GLenum)) \
|
|
/* vertex arrays */ \
|
|
X(void, glGenVertexArrays, (GLsizei, GLuint*)) \
|
|
X(void, glDeleteVertexArrays, (GLsizei, const GLuint*)) \
|
|
X(void, glBindVertexArray, (GLuint)) \
|
|
X(void, glEnableVertexAttribArray, (GLuint)) \
|
|
X(void, glVertexAttribPointer, (GLuint, GLint, GLenum, GLboolean, GLsizei, const void*)) \
|
|
X(void, glVertexAttribDivisor, (GLuint, GLuint)) \
|
|
/* drawing */ \
|
|
X(void, glDrawArrays, (GLenum, GLint, GLsizei)) \
|
|
X(void, glDrawArraysInstanced, (GLenum, GLint, GLsizei, GLsizei)) \
|
|
/* textures */ \
|
|
X(void, glGenTextures, (GLsizei, GLuint*)) \
|
|
X(void, glDeleteTextures, (GLsizei, const GLuint*)) \
|
|
X(void, glActiveTexture, (GLenum)) \
|
|
X(void, glBindTexture, (GLenum, GLuint)) \
|
|
X(void, glTexImage2D, (GLenum, GLint, GLint, GLsizei, GLsizei, GLint, GLenum, GLenum, const void*)) \
|
|
X(void, glTexParameteri, (GLenum, GLenum, GLint)) \
|
|
/* framebuffers */ \
|
|
X(void, glGenFramebuffers, (GLsizei, GLuint*)) \
|
|
X(void, glDeleteFramebuffers, (GLsizei, const GLuint*)) \
|
|
X(void, glBindFramebuffer, (GLenum, GLuint)) \
|
|
X(void, glFramebufferTexture2D, (GLenum, GLenum, GLenum, GLuint, GLint)) \
|
|
X(GLenum, glCheckFramebufferStatus, (GLenum)) \
|
|
X(void, glReadPixels, (GLint, GLint, GLsizei, GLsizei, GLenum, GLenum, void*)) \
|
|
X(void, glGenRenderbuffers, (GLsizei, GLuint*)) \
|
|
X(void, glDeleteRenderbuffers, (GLsizei, const GLuint*)) \
|
|
X(void, glBindRenderbuffer, (GLenum, GLuint)) \
|
|
X(void, glRenderbufferStorage, (GLenum, GLenum, GLsizei, GLsizei)) \
|
|
X(void, glFramebufferRenderbuffer, (GLenum, GLenum, GLenum, GLuint)) \
|
|
/* sync objects */ \
|
|
X(GLsync, glFenceSync, (GLenum, GLbitfield)) \
|
|
X(GLenum, glClientWaitSync, (GLsync, GLbitfield, GLuint64)) \
|
|
X(void, glDeleteSync, (GLsync))
|
|
|
|
// Entry points above the 3.3 baseline, resolved best-effort: a driver that lacks
|
|
// one leaves it null and `load()` still succeeds, so the library keeps working on
|
|
// a 3.3-only context. Every one of these is reached only after `caps()` -- or an
|
|
// explicit null check -- says the context can do it (see caps.hpp).
|
|
#define PLOT_GL_OPTIONAL_FUNCS(X) \
|
|
/* persistent buffer mapping, GL 4.4 / ARB_buffer_storage */ \
|
|
X(void, glBufferStorage, (GLenum, GLsizeiptr, const void*, GLbitfield))
|
|
|
|
#define PLOT_GL_DECL(ret, name, args) extern ret (*name) args;
|
|
PLOT_GL_FUNCS(PLOT_GL_DECL)
|
|
PLOT_GL_OPTIONAL_FUNCS(PLOT_GL_DECL)
|
|
#undef PLOT_GL_DECL
|
|
|
|
} // namespace plot::gl
|