sbgl.h

Go to the documentation of this file.

 
#ifndef SBGL_H
#define SBGL_H
 
#include "sbgl_types.h"
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#include "sbgl_input.h"
 
sbgl_Result sbgl_GetResult(sbgl_Context* ctx);
 
sbgl_ErrorDetail sbgl_GetErrorDetail(sbgl_Context* ctx);
 
void sbgl_ClearResult(sbgl_Context* ctx);
 
// --- Scancodes (Subset of physical keys) ---
 
#define SBGL_KEY_UNKNOWN SBGL_SCANCODE_UNKNOWN
#define SBGL_KEY_A SBGL_SCANCODE_A
#define SBGL_KEY_B SBGL_SCANCODE_B
#define SBGL_KEY_C SBGL_SCANCODE_C
#define SBGL_KEY_D SBGL_SCANCODE_D
#define SBGL_KEY_E SBGL_SCANCODE_E
#define SBGL_KEY_F SBGL_SCANCODE_F
#define SBGL_KEY_G SBGL_SCANCODE_G
#define SBGL_KEY_H SBGL_SCANCODE_H
#define SBGL_KEY_I SBGL_SCANCODE_I
#define SBGL_KEY_J SBGL_SCANCODE_J
#define SBGL_KEY_K SBGL_SCANCODE_K
#define SBGL_KEY_L SBGL_SCANCODE_L
#define SBGL_KEY_M SBGL_SCANCODE_M
#define SBGL_KEY_N SBGL_SCANCODE_N
#define SBGL_KEY_O SBGL_SCANCODE_O
#define SBGL_KEY_P SBGL_SCANCODE_P
#define SBGL_KEY_Q SBGL_SCANCODE_Q
#define SBGL_KEY_R SBGL_SCANCODE_R
#define SBGL_KEY_S SBGL_SCANCODE_S
#define SBGL_KEY_T SBGL_SCANCODE_T
#define SBGL_KEY_U SBGL_SCANCODE_U
#define SBGL_KEY_V SBGL_SCANCODE_V
#define SBGL_KEY_W SBGL_SCANCODE_W
#define SBGL_KEY_X SBGL_SCANCODE_X
#define SBGL_KEY_Y SBGL_SCANCODE_Y
#define SBGL_KEY_Z SBGL_SCANCODE_Z
 
#define SBGL_KEY_1 SBGL_SCANCODE_1
#define SBGL_KEY_2 SBGL_SCANCODE_2
#define SBGL_KEY_3 SBGL_SCANCODE_3
#define SBGL_KEY_4 SBGL_SCANCODE_4
#define SBGL_KEY_5 SBGL_SCANCODE_5
#define SBGL_KEY_6 SBGL_SCANCODE_6
#define SBGL_KEY_7 SBGL_SCANCODE_7
#define SBGL_KEY_8 SBGL_SCANCODE_8
#define SBGL_KEY_9 SBGL_SCANCODE_9
#define SBGL_KEY_0 SBGL_SCANCODE_0
 
#define SBGL_KEY_MINUS SBGL_SCANCODE_MINUS
#define SBGL_KEY_EQUAL SBGL_SCANCODE_EQUAL
 
#define SBGL_KEY_RETURN SBGL_SCANCODE_RETURN
#define SBGL_KEY_ESCAPE SBGL_SCANCODE_ESCAPE
#define SBGL_KEY_BACKSPACE SBGL_SCANCODE_BACKSPACE
#define SBGL_KEY_TAB SBGL_SCANCODE_TAB
#define SBGL_KEY_SPACE SBGL_SCANCODE_SPACE
#define SBGL_KEY_RIGHT SBGL_SCANCODE_RIGHT
#define SBGL_KEY_LEFT SBGL_SCANCODE_LEFT
#define SBGL_KEY_DOWN SBGL_SCANCODE_DOWN
#define SBGL_KEY_UP SBGL_SCANCODE_UP
#define SBGL_KEY_LSHIFT SBGL_SCANCODE_LSHIFT
#define SBGL_KEY_LCTRL SBGL_SCANCODE_LCTRL
#define SBGL_KEY_LALT SBGL_SCANCODE_LALT
 
#define SBGL_MOUSE_LEFT SBGL_MOUSE_BUTTON_LEFT
#define SBGL_MOUSE_RIGHT SBGL_MOUSE_BUTTON_RIGHT
#define SBGL_MOUSE_MIDDLE SBGL_MOUSE_BUTTON_MIDDLE
 
// --- API ---
 
sbgl_InitResult sbgl_InitWithConfig(const sbgl_InitConfig* config);
 
sbgl_InitResult sbgl_Init(int w, int h, const char* title);
 
void sbgl_Shutdown(sbgl_Context* ctx);
 
bool sbgl_WindowShouldClose(sbgl_Context* ctx);
 
double sbgl_GetTime(sbgl_Context* ctx);
 
void sbgl_GetWindowSize(sbgl_Context* ctx, int* w, int* h);
 
void sbgl_BeginDrawing(sbgl_Context* ctx);
 
void sbgl_EndDrawing(sbgl_Context* ctx);
 
void sbgl_BeginCompute(sbgl_Context* ctx);
 
void sbgl_EndCompute(sbgl_Context* ctx);
 
void sbgl_DeviceWaitIdle(sbgl_Context* ctx);
 
void sbgl_SetClearColor(sbgl_Context* ctx, float r, float g, float b, float a);
 
#define sbgl_Clear sbgl_SetClearColor
 
const sbgl_InputState* sbgl_GetInputState(sbgl_Context* ctx);
 
void sbgl_SetMouseMode(sbgl_Context* ctx, sbgl_MouseMode mode);
 
sbgl_Telemetry sbgl_GetTelemetry(sbgl_Context* ctx);
 
// --- Rendering API ---
 
sbgl_Buffer
sbgl_CreateBuffer(sbgl_Context* ctx, sbgl_BufferUsage usage, size_t size, const void* data);
 
void
sbgl_DestroyBuffer(sbgl_Context* ctx, sbgl_Buffer buffer);
 
void sbgl_FillBuffer(sbgl_Context* ctx, sbgl_Buffer buffer, size_t offset, size_t size, uint32_t value);
 
uint32_t sbgl_GetFrameIndex(sbgl_Context* ctx);
 
sbgl_Shader
sbgl_LoadShader(sbgl_Context* ctx, sbgl_ShaderStage stage, const uint32_t* bytecode, size_t size);
 
sbgl_Shader
sbgl_LoadShaderFromFile(sbgl_Context* ctx, sbgl_ShaderStage stage, const char* filename);
 
void sbgl_DestroyShader(sbgl_Context* ctx, sbgl_Shader shader);
 
void* sbgl_MapBuffer(sbgl_Context* ctx, sbgl_Buffer buffer);
 
void sbgl_UnmapBuffer(sbgl_Context* ctx, sbgl_Buffer buffer);
 
sbgl_Pipeline sbgl_CreatePipeline(sbgl_Context* ctx, const sbgl_PipelineConfig* config);
void sbgl_DestroyPipeline(sbgl_Context* ctx, sbgl_Pipeline pipeline);
 
sbgl_ComputePipeline sbgl_CreateComputePipeline(sbgl_Context* ctx, sbgl_Shader shader);
 
void sbgl_DestroyComputePipeline(sbgl_Context* ctx, sbgl_ComputePipeline pipeline);
 
void sbgl_BindComputePipeline(sbgl_Context* ctx, sbgl_ComputePipeline pipeline);
 
void sbgl_DispatchCompute(sbgl_Context* ctx, uint32_t groupCountX, uint32_t groupCountY, uint32_t groupCountZ);
 
void sbgl_MemoryBarrier(sbgl_Context* ctx, sbgl_BarrierType type);
 
void sbgl_BindPipeline(sbgl_Context* ctx, sbgl_Pipeline pipeline);
 
void sbgl_BindBuffer(sbgl_Context* ctx, sbgl_Buffer buffer, sbgl_BufferUsage usage);
 
uint64_t sbgl_GetBufferDeviceAddress(sbgl_Context* ctx, sbgl_Buffer buffer);
 
void sbgl_Draw(sbgl_Context* ctx, uint32_t vertexCount, uint32_t firstVertex, uint32_t instanceCount);
 
void sbgl_DrawIndexed(
  sbgl_Context* ctx,
  uint32_t indexCount,
  uint32_t firstIndex,
  int32_t vertexOffset,
  uint32_t instanceCount
);
 
void sbgl_DrawIndirect(
  sbgl_Context* ctx,
  sbgl_Buffer buffer,
  size_t offset,
  uint32_t drawCount
);
 
void sbgl_PushConstants(sbgl_Context* ctx, size_t size, const void* data);
 
// --- Automated Batching API ---
 
struct SblArena;
 
sbgl_RenderQueue* sbgl_CreateRenderQueue(sbgl_Context* ctx, struct SblArena* arena);
 
void sbgl_SubmitDraw(
  sbgl_RenderQueue* queue,
  uint32_t mesh,
  uint32_t material,
  uint32_t blendMode,
  uint32_t sidedness,
  uint32_t tags,
  sbgl_SortKey key,
  const sbgl_InstanceData* data
);
 
void sbgl_RenderQueues(sbgl_Context* ctx, sbgl_RenderQueue** queues, uint32_t queueCount, const sbgl_Mat4* viewProj);
 
void sbgl_RenderQueuesEx(sbgl_Context* ctx, sbgl_RenderQueue** queues, uint32_t queueCount, const sbgl_Mat4* viewProj, uint64_t userAddress);
 
#endif // SBGL_H