nozzle

sokol_gfx (nozzle-sokol)

nozzle-sokol provides nozzle GPU texture sharing integration for sokol_gfx.

Single header library — include in ONE source file.

Status

Platform Status
macOS (Metal) CPU copy path (zero-copy planned)
Windows (D3D11) CPU copy path (zero-copy planned)
Linux (OpenGL) CPU copy path

Setup

#define NOZZLE_SOKOL_IMPL
#include "nozzle-sokol.h"

Build with CMake:

cmake -B build -DNOZZLE_SOKOL_BUILD_EXAMPLES=ON
cmake --build build

Requires nozzle and sokol as submodules.

Receiver: nozzle frame → sokol image

NozzleFrame *frame;
NozzleAcquireDesc acq = {0};
if (nozzle_receiver_acquire_frame(receiver, &acq, &frame) == NOZZLE_OK) {
    sg_image img;
    if (nozzle_sokol_frame_to_image(frame, &img)) {
        // use img with sg_apply_bindings(), draw to screen, etc.
        // destroy when done: sg_destroy_image(img);
    }
    nozzle_frame_release(frame);
}

Sender: sokol image → nozzle

sg_image img = sg_make_image(&(sg_image_desc){
    .width = 512,
    .height = 512,
    .pixel_format = SG_PIXELFORMAT_RGBA8,
    .usage = SG_USAGE_STREAM,
});
// ... fill image data ...

nozzle_sokol_image_publish(sender, img);

Format Conversion

sg_pixel_format sfmt = nozzle_sokol_to_pixel_format(NOZZLE_FORMAT_RGBA8_UNORM);
int nfmt = nozzle_sokol_from_pixel_format(SG_PIXELFORMAT_RGBA32F);

Format Support

Nozzle Format sokol Pixel Format
R8_UNORM R8
RG8_UNORM RG8
RGBA8_UNORM RGBA8
BGRA8_UNORM BGRA8
R16_FLOAT R16F
RG16_FLOAT RG16F
RGBA16_FLOAT RGBA16F
R32_FLOAT R32F
RG32_FLOAT RG32F
RGBA32_FLOAT RGBA32F

Zero-Copy Path (Planned)

sokol supports native texture injection via sg_image_desc:

  • .mtl_textures[] — Metal id<MTLTexture> injection
  • .d3d11_texture — D3D11 ID3D11Texture2D* injection
  • .gl_textures[] — OpenGL GLuint injection

Nozzle exposes native handles via its backend headers (nozzle/backends/metal.hpp, etc.). A future update will inject these directly, eliminating the CPU copy.

Architecture

nozzle-sokol.h    Single header integration layer
├── Format conversion (nozzle ↔ sokol pixel formats)
├── Receiver: nozzle frame → sokol sg_image (CPU copy, zero-copy planned)
└── Sender: sokol sg_image → nozzle sender (CPU copy, zero-copy planned)