Skip to content

chore: release v0.4.4 #48

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
tycho wants to merge 2 commits into from
Closed

chore: release v0.4.4 #48

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
af1a5bd
fix(generator): clean up whitespace usage for function declarations
tycho Mar 27, 2026
66b0074
chore: release v0.4.4
tycho Mar 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

## [0.4.4](https://github.com/tycho/gloam/compare/0.4.3...0.4.4) - 2026-03-27

### Added

- *(vulkan)* add new --external-headers option for Vulkan

### Fixed

- *(generator)* clean up whitespace usage for function declarations
- *(vulkan)* unbreak loading device functions in enabled-list path
- *(vulkan)* load instance functions when enabling device extensions
- *(c)* use correct naming for gloamVulkanGetInstanceVersion
- *(generator)* ensure trailing newline at end of generated sources

### Other

- *(vulkan)* simplify internals, unify pfn range loading functions

## [0.4.3](https://github.com/tycho/gloam/compare/0.4.2...0.4.3) - 2026-03-26

### Added
Expand Down
2 changes: 1 addition & 1 deletion Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Cargo.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[package]
name = "gloam"
version = "0.4.3"
version = "0.4.4"
edition = "2024"
description = "Loader generator for Vulkan, OpenGL, OpenGL ES, EGL, GLX, and WGL"
license = "MIT OR Apache-2.0"
Expand Down
107 changes: 70 additions & 37 deletions src/generator/c/templates/loader.j2
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,8 @@ static struct gloam_gl_load_userptr gloam_gl_load_state;

/* GL desktop adapter — matches GloamLoadFunc (__cdecl), dispatches through
the correctly-typed platform proc-addr pointer stored in the userptr. */
static GloamAPIProc gloam_gl_get_proc(const char *name) {
static GloamAPIProc gloam_gl_get_proc(const char *name)
{
GloamAPIProc result = NULL;
struct gloam_gl_load_userptr *u = &gloam_gl_load_state;
if (!u->handle) return NULL;
Expand All @@ -41,15 +42,17 @@ static GloamAPIProc gloam_gl_get_proc(const char *name) {

/* GLES adapter: all symbols (including extensions) are exported directly from
the GLES library so plain dlsym is sufficient — no platform indirection. */
static GloamAPIProc gloam_gles_get_proc(const char *name) {
static GloamAPIProc gloam_gles_get_proc(const char *name)
{
struct gloam_gl_load_userptr *u = &gloam_gl_load_state;
if (!u->handle) return NULL;
return (GloamAPIProc)gloam_dlsym(u->handle, name);
}

{%- for api in fs.apis %}

int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg() }}) {
int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg() }})
{
int did_open = 0, version;
{% if api in ["gles1", "gles2"] %}
static const char * const kLibNames[] = {
Expand Down Expand Up @@ -107,27 +110,32 @@ int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg() }}) {
return version;
}

int gloamLoaderLoad{{ api | api_display }}(void) {
int gloamLoaderLoad{{ api | api_display }}(void)
{
return gloamLoaderLoad{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}

void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }})
{
if (context->gloam_loader_handle) {
gloam_dlclose(context->gloam_loader_handle);
context->gloam_loader_handle = NULL;
}
gloamLoaderReset{{ api | api_display }}Context(context);
}

void gloamLoaderUnload{{ api | api_display }}(void) {
void gloamLoaderUnload{{ api | api_display }}(void)
{
gloamLoaderUnload{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}

void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }})
{
memset(context, 0, sizeof(*context));
}

void gloamLoaderReset{{ api | api_display }}(void) {
void gloamLoaderReset{{ api | api_display }}(void)
{
gloamLoaderReset{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}
{%- endfor %}
Expand All @@ -153,7 +161,8 @@ struct gloam_egl_load_userptr {
};
static struct gloam_egl_load_userptr gloam_egl_load_state;

static GloamAPIProc gloam_egl_get_proc(const char *name) {
static GloamAPIProc gloam_egl_get_proc(const char *name)
{
struct gloam_egl_load_userptr *u = &gloam_egl_load_state;
GloamAPIProc result = (GloamAPIProc)gloam_dlsym(u->handle, name);
if (!result && u->get_proc_address)
Expand All @@ -162,7 +171,8 @@ static GloamAPIProc gloam_egl_get_proc(const char *name) {
}

{% for api in fs.apis %}
int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}EGLDisplay display) {
int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}EGLDisplay display)
{
int did_open = 0, version;
if (!context->gloam_loader_handle) {
context->gloam_loader_handle = gloam_open_library(
Expand All @@ -185,27 +195,32 @@ int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}EGLDispla
return version;
}

int gloamLoaderLoad{{ api | api_display }}(EGLDisplay display) {
int gloamLoaderLoad{{ api | api_display }}(EGLDisplay display)
{
return gloamLoaderLoad{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context, display);
}

void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }})
{
if (context->gloam_loader_handle) {
gloam_dlclose(context->gloam_loader_handle);
context->gloam_loader_handle = NULL;
}
gloamLoaderReset{{ api | api_display }}Context(context);
}

void gloamLoaderUnload{{ api | api_display }}(void) {
void gloamLoaderUnload{{ api | api_display }}(void)
{
gloamLoaderUnload{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}

void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }})
{
memset(context, 0, sizeof(*context));
}

void gloamLoaderReset{{ api | api_display }}(void) {
void gloamLoaderReset{{ api | api_display }}(void)
{
gloamLoaderReset{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}
{%- endfor %}
Expand All @@ -227,7 +242,8 @@ struct gloam_glx_load_userptr {
};
static struct gloam_glx_load_userptr gloam_glx_load_state;

static GloamAPIProc gloam_glx_get_proc(const char *name) {
static GloamAPIProc gloam_glx_get_proc(const char *name)
{
struct gloam_glx_load_userptr *u = &gloam_glx_load_state;
GloamAPIProc result = NULL;
if (u->get_proc_address) result = u->get_proc_address(name);
Expand All @@ -237,7 +253,8 @@ static GloamAPIProc gloam_glx_get_proc(const char *name) {

{%- for api in fs.apis %}

int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}Display *display, int screen) {
int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}Display *display, int screen)
{
int did_open = 0, version;
if (!context->gloam_loader_handle) {
context->gloam_loader_handle = gloam_open_library(
Expand All @@ -261,27 +278,32 @@ int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}Display *
return version;
}

int gloamLoaderLoad{{ api | api_display }}(Display *display, int screen) {
int gloamLoaderLoad{{ api | api_display }}(Display *display, int screen)
{
return gloamLoaderLoad{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context, display, screen);
}

void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }})
{
if (context->gloam_loader_handle) {
gloam_dlclose(context->gloam_loader_handle);
context->gloam_loader_handle = NULL;
}
gloamLoaderReset{{ api | api_display }}Context(context);
}

void gloamLoaderUnload{{ api | api_display }}(void) {
void gloamLoaderUnload{{ api | api_display }}(void)
{
gloamLoaderUnload{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}

void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }})
{
memset(context, 0, sizeof(*context));
}

void gloamLoaderReset{{ api | api_display }}(void) {
void gloamLoaderReset{{ api | api_display }}(void)
{
gloamLoaderReset{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}
{%- endfor %}
Expand All @@ -298,7 +320,8 @@ struct gloam_wgl_load_userptr {
};
static struct gloam_wgl_load_userptr gloam_wgl_load_state;

static GloamAPIProc gloam_wgl_get_proc(const char *name) {
static GloamAPIProc gloam_wgl_get_proc(const char *name)
{
struct gloam_wgl_load_userptr *u = &gloam_wgl_load_state;
GloamAPIProc result = NULL;
if (u->wgl_get_proc) result = u->wgl_get_proc(name);
Expand All @@ -307,7 +330,8 @@ static GloamAPIProc gloam_wgl_get_proc(const char *name) {
}

{%- for api in fs.apis %}
int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}HDC hdc) {
int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}HDC hdc)
{
int did_open = 0, version;
if (!context->gloam_loader_handle) {
context->gloam_loader_handle = gloam_open_library(
Expand All @@ -331,27 +355,32 @@ int gloamLoaderLoad{{ api | api_display }}Context({{ u.ctx_arg(', ') }}HDC hdc)
return version;
}

int gloamLoaderLoad{{ api | api_display }}(HDC hdc) {
int gloamLoaderLoad{{ api | api_display }}(HDC hdc)
{
return gloamLoaderLoad{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context, hdc);
}

void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderUnload{{ api | api_display }}Context({{ u.ctx_arg() }})
{
if (context->gloam_loader_handle) {
gloam_dlclose(context->gloam_loader_handle);
context->gloam_loader_handle = NULL;
}
gloamLoaderReset{{ api | api_display }}Context(context);
}

void gloamLoaderUnload{{ api | api_display }}(void) {
void gloamLoaderUnload{{ api | api_display }}(void)
{
gloamLoaderUnload{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}

void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }}) {
void gloamLoaderReset{{ api | api_display }}Context({{ u.ctx_arg() }})
{
memset(context, 0, sizeof(*context));
}

void gloamLoaderReset{{ api | api_display }}(void) {
void gloamLoaderReset{{ api | api_display }}(void)
{
gloamLoaderReset{{ api | api_display }}Context(&gloam_{{ fs.spec_name }}_context);
}
{%- endfor %}
Expand All @@ -364,8 +393,8 @@ void gloamLoaderReset{{ api | api_display }}(void) {
* already set, stores vkGetInstanceProcAddr in the context, then delegates to
* gloamVulkanDiscoverContext. Follows the same additive multi-call contract
* as the underlying discover function. */
int gloamLoaderLoadVulkanContext({{ u.ctx_arg(', ') }}VkInstance instance,
VkPhysicalDevice physical_device, VkDevice device) {
int gloamLoaderLoadVulkanContext({{ u.ctx_arg(', ') }}VkInstance instance, VkPhysicalDevice physical_device, VkDevice device)
{
int did_open = 0;
int version;
void *handle;
Expand Down Expand Up @@ -400,31 +429,35 @@ int gloamLoaderLoadVulkanContext({{ u.ctx_arg(', ') }}VkInstance instance,
return version;
}

int gloamLoaderLoadVulkan(VkInstance instance, VkPhysicalDevice physical_device,
VkDevice device) {
int gloamLoaderLoadVulkan(VkInstance instance, VkPhysicalDevice physical_device, VkDevice device)
{
return gloamLoaderLoadVulkanContext(&gloam_vk_context, instance,
physical_device, device);
}

/* Close the library handle (if set) then zero all context state. */
void gloamLoaderUnloadVulkanContext({{ u.ctx_arg() }}) {
void gloamLoaderUnloadVulkanContext({{ u.ctx_arg() }})
{
if (context->gloam_loader_handle) {
gloam_dlclose(context->gloam_loader_handle);
context->gloam_loader_handle = NULL;
}
gloamLoaderResetVulkanContext(context);
}

void gloamLoaderUnloadVulkan(void) {
void gloamLoaderUnloadVulkan(void)
{
gloamLoaderUnloadVulkanContext(&gloam_vk_context);
}

/* Zero all context state without touching the library handle. */
void gloamLoaderResetVulkanContext({{ u.ctx_arg() }}) {
void gloamLoaderResetVulkanContext({{ u.ctx_arg() }})
{
memset(context, 0, sizeof(*context));
}

void gloamLoaderResetVulkan(void) {
void gloamLoaderResetVulkan(void)
{
gloamLoaderResetVulkanContext(&gloam_vk_context);
}
{% endif %}
Loading