const std = @import("std"); const ChainedStruct = @import("main.zig").ChainedStruct; const dawn = @import("dawn.zig"); const MapModeFlags = @import("main.zig").MapModeFlags; const Impl = @import("interface.zig").Impl; pub const Buffer = opaque { pub const MapCallback = *const fn (status: MapAsyncStatus, userdata: ?*anyopaque) callconv(.C) void; pub const BindingType = enum(u32) { undefined = 0x00000000, uniform = 0x00000001, storage = 0x00000002, read_only_storage = 0x00000003, }; pub const MapState = enum(u32) { unmapped = 0x00000000, pending = 0x00000001, mapped = 0x00000002, }; pub const MapAsyncStatus = enum(u32) { success = 0x00000000, validation_error = 0x00000001, unknown = 0x00000002, device_lost = 0x00000003, destroyed_before_callback = 0x00000004, unmapped_before_callback = 0x00000005, mapping_already_pending = 0x00000006, offset_out_of_range = 0x00000007, size_out_of_range = 0x00000008, }; pub const UsageFlags = packed struct(u32) { map_read: bool = false, map_write: bool = false, copy_src: bool = false, copy_dst: bool = false, index: bool = false, vertex: bool = false, uniform: bool = false, storage: bool = false, indirect: bool = false, query_resolve: bool = false, _padding: u22 = 0, comptime { std.debug.assert( @sizeOf(@This()) == @sizeOf(u32) and @bitSizeOf(@This()) == @bitSizeOf(u32), ); } pub const none = UsageFlags{}; pub fn equal(a: UsageFlags, b: UsageFlags) bool { return @as(u10, @truncate(@as(u32, @bitCast(a)))) == @as(u10, @truncate(@as(u32, @bitCast(b)))); } }; pub const BindingLayout = extern struct { next_in_chain: ?*const ChainedStruct = null, type: BindingType = .undefined, has_dynamic_offset: bool = false, min_binding_size: u64 = 0, }; pub const Descriptor = extern struct { pub const NextInChain = extern union { generic: ?*const ChainedStruct, dawn_buffer_descriptor_error_info_from_wire_client: *const dawn.BufferDescriptorErrorInfoFromWireClient, }; next_in_chain: NextInChain = .{ .generic = null }, label: ?[*:0]const u8 = null, usage: UsageFlags, size: u64, mapped_at_creation: bool = false, }; pub inline fn destroy(buffer: *Buffer) void { Impl.bufferDestroy(buffer); } pub inline fn getMapState(buffer: *Buffer) MapState { return Impl.bufferGetMapState(buffer); } /// Default `offset_bytes`: 0 /// Default `len`: `gpu.whole_map_size` / `std.math.maxint(usize)` (whole range) pub inline fn getConstMappedRange( buffer: *Buffer, comptime T: type, offset_bytes: usize, len: usize, ) ?[]const T { const size = @sizeOf(T) * len; const data = Impl.bufferGetConstMappedRange( buffer, offset_bytes, size + size % 4, ); return if (data) |d| @as([*]const T, @ptrCast(@alignCast(d)))[0..len] else null; } /// Default `offset_bytes`: 0 /// Default `len`: `gpu.whole_map_size` / `std.math.maxint(usize)` (whole range) pub inline fn getMappedRange( buffer: *Buffer, comptime T: type, offset_bytes: usize, len: usize, ) ?[]T { const size = @sizeOf(T) * len; const data = Impl.bufferGetMappedRange( buffer, offset_bytes, size + size % 4, ); return if (data) |d| @as([*]T, @ptrCast(@alignCast(d)))[0..len] else null; } pub inline fn getSize(buffer: *Buffer) u64 { return Impl.bufferGetSize(buffer); } pub inline fn getUsage(buffer: *Buffer) Buffer.UsageFlags { return Impl.bufferGetUsage(buffer); } pub inline fn mapAsync( buffer: *Buffer, mode: MapModeFlags, offset: usize, size: usize, context: anytype, comptime callback: fn (ctx: @TypeOf(context), status: MapAsyncStatus) callconv(.Inline) void, ) void { const Context = @TypeOf(context); const Helper = struct { pub fn cCallback(status: MapAsyncStatus, userdata: ?*anyopaque) callconv(.C) void { callback(if (Context == void) {} else @as(Context, @ptrCast(@alignCast(userdata))), status); } }; Impl.bufferMapAsync(buffer, mode, offset, size, Helper.cCallback, if (Context == void) null else context); } pub inline fn setLabel(buffer: *Buffer, label: [*:0]const u8) void { Impl.bufferSetLabel(buffer, label); } pub inline fn unmap(buffer: *Buffer) void { Impl.bufferUnmap(buffer); } pub inline fn reference(buffer: *Buffer) void { Impl.bufferReference(buffer); } pub inline fn release(buffer: *Buffer) void { Impl.bufferRelease(buffer); } };