d8076b9333
Surface rename of the signed integer family: s1..s64 become i1..i64
(u1..u64, usize, isize unchanged). 'string' keeps the s-prefix arm in
name classification; width parsing moves to the i-prefix arm next to
isize.
Internal TypeId tags follow the surface (.s8/.s16/.s32/.s64 ->
.i8/.i16/.i32/.i64), as do mono-key mangle fragments (ptr_i64,
tu_i64_bool) and all display/diagnostic formatting (i{d}).
Migrated in the same sweep: stdlib + examples + issue repros + FFI C
companions (shared symbol names like ffi_id_i64), expected
stdout/stderr/ir snapshots, specs.md, readme.md, CLAUDE.md/AGENTS.md,
implementation_plan.md, docs/, issue writeups. Vendored stb_image and
historical flow state left untouched.
zig build test: 426/426; examples suite: 595/595.
58 lines
2.8 KiB
Plaintext
58 lines
2.8 KiB
Plaintext
#import "modules/std.sx";
|
|
#import "modules/gpu/types.sx";
|
|
|
|
// GPU is the rendering-API abstraction. Concrete backends live as siblings
|
|
// of this file: `metal.sx` (iOS, eventually macOS), `vulkan.sx` (Linux/
|
|
// Android, plus macOS via MoltenVK), `webgpu.sx` (wasm). The SDL-backed
|
|
// GL renderer used by the desktop+wasm path stays as-is until those
|
|
// backends land.
|
|
|
|
GPU :: protocol {
|
|
// Bind the GPU to a backend-specific render target (e.g. a
|
|
// CAMetalLayer on iOS). pixel_w/pixel_h are the drawable's pixel
|
|
// dimensions; call resize when they change.
|
|
init :: (target: *void, pixel_w: i32, pixel_h: i32) -> bool;
|
|
shutdown :: ();
|
|
|
|
resize :: (pixel_w: i32, pixel_h: i32);
|
|
|
|
begin_frame :: (clear: ClearColor) -> bool;
|
|
|
|
// target_time is the host clock time at which the drawable should be
|
|
// presented (units match the platform's CADisplayLink.targetTimestamp
|
|
// on Apple). Metal forwards it to presentDrawable:atTime: to cap the
|
|
// pipeline at one frame so the inset slide lands on the same vsync as
|
|
// UIKit's keyboard view. GL backends ignore it.
|
|
end_frame :: (target_time: f64);
|
|
|
|
create_shader :: (vsrc: string, fsrc: string) -> ShaderHandle;
|
|
create_buffer :: (size_bytes: i64) -> BufferHandle;
|
|
update_buffer :: (buf: BufferHandle, data: *void, size_bytes: i64);
|
|
// Sub-buffer write at a byte offset. Required for Metal where re-using
|
|
// the same buffer slice across multiple draws in a single command
|
|
// encoder is a race: the GPU executes draws asynchronously and reads
|
|
// shared-storage buffer contents at execution time, so the LAST writer
|
|
// wins if every flush targets offset 0. Renderers that issue more than
|
|
// one draw per frame must advance their write offset between flushes.
|
|
update_buffer_at :: (buf: BufferHandle, data: *void, size_bytes: i64, byte_offset: i64);
|
|
create_texture :: (w: i32, h: i32, format: TextureFormat, pixels: *void) -> TextureHandle;
|
|
update_texture_region :: (tex: TextureHandle, x: i32, y: i32, w: i32, h: i32, pixels: *void);
|
|
|
|
// Release a GPU resource. Implementations release the backing object and
|
|
// null the slot so the handle becomes inert. Calling with handle 0 or
|
|
// an already-destroyed handle is a no-op. Handles are not re-used; the
|
|
// backing List entry stays at its index with a null sentinel.
|
|
destroy_shader :: (sh: ShaderHandle);
|
|
destroy_buffer :: (buf: BufferHandle);
|
|
destroy_texture :: (tex: TextureHandle);
|
|
|
|
set_shader :: (sh: ShaderHandle);
|
|
set_vertex_buffer :: (buf: BufferHandle);
|
|
set_texture :: (slot: u32, tex: TextureHandle);
|
|
set_vertex_constants :: (slot: u32, data: *void, size_bytes: i64);
|
|
set_scissor :: (x: i32, y: i32, w: i32, h: i32);
|
|
disable_scissor :: ();
|
|
|
|
draw_triangles :: (vertex_offset: i32, vertex_count: i32);
|
|
}
|