tiny.gpu.RenderArtifact

1pub const RenderArtifact = struct {2    allocator: Allocator,3    backend: BackendKind,4    format: RenderArtifactFormat,5    vertex_entry_name: []const u8,6    fragment_entry_name: []const u8,7    target_format: TextureFormat,8    blend_mode: RenderBlendMode,9    topology: RenderPrimitiveTopology,10    depth: ?RenderDepthState,11    vertex_layouts: []const RenderVertexBufferLayout,12    vertex_attributes: []const RenderVertexAttribute,13    bindings: []const RenderBindingDesc,14    push_constant_bytes: u32 = 0,15    push_extent: u32 = 0,16    diagnostic_id: ?[]const u8 = null,17    payload: ArtifactPayload = .none,18    payload_ownership: PayloadOwnership = .borrowed,1920    pub fn init(allocator: Allocator, desc: RenderArtifactDesc) Allocator.Error!RenderArtifact {21        const vertex_entry_name = try dupeString(allocator, desc.pipeline.vertex_entry_name);22        errdefer freeString(allocator, vertex_entry_name);23        const fragment_entry_name = try dupeString(allocator, desc.pipeline.fragment_entry_name);24        errdefer freeString(allocator, fragment_entry_name);25        const vertex_layouts = try allocator.dupe(RenderVertexBufferLayout, desc.pipeline.vertex_layouts);26        errdefer allocator.free(vertex_layouts);27        const vertex_attributes = try allocator.dupe(RenderVertexAttribute, desc.pipeline.vertex_attributes);28        errdefer allocator.free(vertex_attributes);29        const bindings = try allocator.dupe(RenderBindingDesc, desc.pipeline.bindings);30        errdefer allocator.free(bindings);3132        return .{33            .allocator = allocator,34            .backend = desc.backend,35            .format = desc.pipeline.format,36            .vertex_entry_name = vertex_entry_name,37            .fragment_entry_name = fragment_entry_name,38            .target_format = desc.pipeline.target_format,39            .blend_mode = desc.pipeline.blend_mode,40            .topology = desc.pipeline.topology,41            .depth = desc.pipeline.depth,42            .vertex_layouts = vertex_layouts,43            .vertex_attributes = vertex_attributes,44            .bindings = bindings,45            .push_constant_bytes = desc.pipeline.push_constant_bytes,46            .push_extent = desc.pipeline.push_extent,47            .diagnostic_id = try dupeOpt(allocator, desc.pipeline.diagnostic_id),48        };49    }5051    pub fn deinit(self: *RenderArtifact) void {52        self.clearPayload();53        freeString(self.allocator, self.vertex_entry_name);54        freeString(self.allocator, self.fragment_entry_name);55        self.allocator.free(@constCast(self.vertex_layouts));56        self.allocator.free(@constCast(self.vertex_attributes));57        self.allocator.free(@constCast(self.bindings));58        freeOpt(self.allocator, self.diagnostic_id);59        self.* = undefined;60    }6162    pub fn setBorrowedBytes(self: *RenderArtifact, bytes: []const u8) void {63        self.clearPayload();64        self.payload = .{ .bytes = bytes };65        self.payload_ownership = .borrowed;66    }6768    pub fn setOwnedBytes(self: *RenderArtifact, bytes: []const u8) BackendError!void {69        const owned = self.allocator.dupe(u8, bytes) catch return error.OutOfMemory;70        self.clearPayload();71        self.payload = .{ .bytes = owned };72        self.payload_ownership = .owned;73    }7475    pub fn setBorrowedWords(self: *RenderArtifact, words: []const u32) void {76        self.clearPayload();77        self.payload = .{ .words_u32 = words };78        self.payload_ownership = .borrowed;79    }8081    pub fn setOwnedWords(self: *RenderArtifact, words: []const u32) BackendError!void {82        const owned = self.allocator.dupe(u32, words) catch return error.OutOfMemory;83        self.clearPayload();84        self.payload = .{ .words_u32 = owned };85        self.payload_ownership = .owned;86    }8788    pub fn setBorrowedText(self: *RenderArtifact, text: []const u8) void {89        self.clearPayload();90        self.payload = .{ .text = text };91        self.payload_ownership = .borrowed;92    }9394    pub fn setOwnedText(self: *RenderArtifact, text: []const u8) BackendError!void {95        const owned = self.allocator.dupe(u8, text) catch return error.OutOfMemory;96        self.clearPayload();97        self.payload = .{ .text = owned };98        self.payload_ownership = .owned;99    }100101    pub fn setExternalPayload(self: *RenderArtifact, payload: ExternalPayload, ownership: PayloadOwnership) BackendError!void {102        if (ownership == .owned and payload.deinit_fn == null) return error.MissingPayloadDeinit;103        self.clearPayload();104        self.payload = .{ .external = payload };105        self.payload_ownership = ownership;106    }107108    fn clearPayload(self: *RenderArtifact) void {109        if (self.payload_ownership == .owned) {110            switch (self.payload) {111                .bytes => |bytes| freeString(self.allocator, bytes),112                .words_u32 => |words| self.allocator.free(@constCast(words)),113                .text => |text| freeString(self.allocator, text),114                .external => |payload| if (payload.deinit_fn) |deinit_fn| deinit_fn(self.allocator, payload.ptr),115                .none => {},116            }117        }118        self.payload = .none;119        self.payload_ownership = .borrowed;120    }121};

1pub const RenderArtifact = contract.RenderArtifact;