Mark all string parameters as comptime where the C API is expecting string literals.

jhark · jhark · commit ec1499fc0144 · 2025-03-25T13:04:48.000Z
Pros:

* Prevents mistaken usage of dynamically allocated strings.
* Lets us use static constant memory for the source location data.
* Avoids generating unnecessary writes to source location data whenever starting a zone.
* Matches other Zig Tracy bindings such as the one inside the Zig compiler.

Cons:

* Breaking API change.
* Technically you are allowed to pass non-string literals to these functions, and you might want to if you are dynamically loading code/data containing your strings, or promise to keep your strings allocated until program exit. We could export the raw C API to cover more niche use-cases such as these though.
diff --git a/src/ztracy.zig b/src/ztracy.zig
@@ -41,15 +41,15 @@ const tracy_stub = struct {
         }
     };
 
-    pub inline fn SetThreadName(name: [*:0]const u8) void {
+    pub inline fn SetThreadName(comptime name: [*:0]const u8) void {
         _ = name;
     }
 
     pub inline fn Zone(comptime src: Src) ZoneCtx {
         _ = src;
         return .{};
     }
-    pub inline fn ZoneN(comptime src: Src, name: [*:0]const u8) ZoneCtx {
+    pub inline fn ZoneN(comptime src: Src, comptime name: [*:0]const u8) ZoneCtx {
         _ = src;
         _ = name;
         return .{};
@@ -59,7 +59,7 @@ const tracy_stub = struct {
         _ = color;
         return .{};
     }
-    pub inline fn ZoneNC(comptime src: Src, name: [*:0]const u8, color: u32) ZoneCtx {
+    pub inline fn ZoneNC(comptime src: Src, comptime name: [*:0]const u8, color: u32) ZoneCtx {
         _ = src;
         _ = name;
         _ = color;
@@ -70,7 +70,7 @@ const tracy_stub = struct {
         _ = depth;
         return .{};
     }
-    pub inline fn ZoneNS(comptime src: Src, name: [*:0]const u8, depth: i32) ZoneCtx {
+    pub inline fn ZoneNS(comptime src: Src, comptime name: [*:0]const u8, depth: i32) ZoneCtx {
         _ = src;
         _ = name;
         _ = depth;
@@ -82,7 +82,7 @@ const tracy_stub = struct {
         _ = depth;
         return .{};
     }
-    pub inline fn ZoneNCS(comptime src: Src, name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {
+    pub inline fn ZoneNCS(comptime src: Src, comptime name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {
         _ = src;
         _ = name;
         _ = color;
@@ -123,42 +123,42 @@ const tracy_stub = struct {
         _ = depth;
     }
 
-    pub inline fn AllocN(ptr: ?*const anyopaque, size: usize, name: [*:0]const u8) void {
+    pub inline fn AllocN(ptr: ?*const anyopaque, size: usize, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = size;
         _ = name;
     }
-    pub inline fn FreeN(ptr: ?*const anyopaque, name: [*:0]const u8) void {
+    pub inline fn FreeN(ptr: ?*const anyopaque, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = name;
     }
-    pub inline fn SecureAllocN(ptr: ?*const anyopaque, size: usize, name: [*:0]const u8) void {
+    pub inline fn SecureAllocN(ptr: ?*const anyopaque, size: usize, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = size;
         _ = name;
     }
-    pub inline fn SecureFreeN(ptr: ?*const anyopaque, name: [*:0]const u8) void {
+    pub inline fn SecureFreeN(ptr: ?*const anyopaque, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = name;
     }
-    pub inline fn AllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn AllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = size;
         _ = depth;
         _ = name;
     }
-    pub inline fn FreeNS(ptr: ?*const anyopaque, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn FreeNS(ptr: ?*const anyopaque, depth: c_int, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = depth;
         _ = name;
     }
-    pub inline fn SecureAllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn SecureAllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = size;
         _ = depth;
         _ = name;
     }
-    pub inline fn SecureFreeNS(ptr: ?*const anyopaque, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn SecureFreeNS(ptr: ?*const anyopaque, depth: c_int, comptime name: [*:0]const u8) void {
         _ = ptr;
         _ = depth;
         _ = name;
@@ -167,22 +167,22 @@ const tracy_stub = struct {
     pub inline fn Message(text: []const u8) void {
         _ = text;
     }
-    pub inline fn MessageL(text: [*:0]const u8) void {
+    pub inline fn MessageL(comptime text: [*:0]const u8) void {
         _ = text;
     }
     pub inline fn MessageC(text: []const u8, color: u32) void {
         _ = text;
         _ = color;
     }
-    pub inline fn MessageLC(text: [*:0]const u8, color: u32) void {
+    pub inline fn MessageLC(comptime text: [*:0]const u8, color: u32) void {
         _ = text;
         _ = color;
     }
     pub inline fn MessageS(text: []const u8, depth: c_int) void {
         _ = text;
         _ = depth;
     }
-    pub inline fn MessageLS(text: [*:0]const u8, depth: c_int) void {
+    pub inline fn MessageLS(comptime text: [*:0]const u8, depth: c_int) void {
         _ = text;
         _ = depth;
     }
@@ -191,20 +191,20 @@ const tracy_stub = struct {
         _ = color;
         _ = depth;
     }
-    pub inline fn MessageLCS(text: [*:0]const u8, color: u32, depth: c_int) void {
+    pub inline fn MessageLCS(comptime text: [*:0]const u8, color: u32, depth: c_int) void {
         _ = text;
         _ = color;
         _ = depth;
     }
 
     pub inline fn FrameMark() void {}
-    pub inline fn FrameMarkNamed(name: [*:0]const u8) void {
+    pub inline fn FrameMarkNamed(comptime name: [*:0]const u8) void {
         _ = name;
     }
-    pub inline fn FrameMarkStart(name: [*:0]const u8) void {
+    pub inline fn FrameMarkStart(comptime name: [*:0]const u8) void {
         _ = name;
     }
-    pub inline fn FrameMarkEnd(name: [*:0]const u8) void {
+    pub inline fn FrameMarkEnd(comptime name: [*:0]const u8) void {
         _ = name;
     }
     pub inline fn FrameImage(image: ?*const anyopaque, width: u16, height: u16, offset: u8, flip: c_int) void {
@@ -215,20 +215,20 @@ const tracy_stub = struct {
         _ = flip;
     }
 
-    pub inline fn FiberEnter(name: [*:0]const u8) void {
+    pub inline fn FiberEnter(comptime name: [*:0]const u8) void {
         _ = name;
     }
     pub inline fn FiberLeave() void {}
 
-    pub inline fn PlotF(name: [*:0]const u8, val: f64) void {
+    pub inline fn PlotF(comptime name: [*:0]const u8, val: f64) void {
         _ = name;
         _ = val;
     }
-    pub inline fn PlotU(name: [*:0]const u8, val: u64) void {
+    pub inline fn PlotU(comptime name: [*:0]const u8, val: u64) void {
         _ = name;
         _ = val;
     }
-    pub inline fn PlotI(name: [*:0]const u8, val: i64) void {
+    pub inline fn PlotI(comptime name: [*:0]const u8, val: i64) void {
         _ = name;
         _ = val;
     }
@@ -309,27 +309,19 @@ const tracy_full = struct {
         }
     };
 
-    inline fn initZone(comptime src: Src, name: ?[*:0]const u8, color: u32, depth: c_int) ZoneCtx {
+    inline fn initZone(comptime src: Src, comptime name: ?[*:0]const u8, comptime color: u32, comptime depth: c_int) ZoneCtx {
         // Tracy uses pointer identity to identify contexts.
         // The `src` parameter being comptime ensures that
         // each zone gets its own unique global location for this
         // struct.
         const static = struct {
-            var loc: c.___tracy_source_location_data = undefined;
-
-            // Ensure that a unique struct type is generated for each unique `src`. See
-            // https://github.com/ziglang/zig/issues/18816
-            comptime {
-                // https://github.com/ziglang/zig/issues/19274
-                _ = @sizeOf(@TypeOf(src));
-            }
-        };
-        static.loc = .{
-            .name = name,
-            .function = src.fn_name.ptr,
-            .file = src.file.ptr,
-            .line = src.line,
-            .color = color,
+            const loc: c.___tracy_source_location_data = .{
+                .name = name,
+                .function = src.fn_name.ptr,
+                .file = src.file.ptr,
+                .line = src.line,
+                .color = color,
+            };
         };
 
         const zone = if (has_callstack_support)
@@ -345,32 +337,32 @@ const tracy_full = struct {
         }
     }
 
-    pub inline fn SetThreadName(name: [*:0]const u8) void {
+    pub inline fn SetThreadName(comptime name: [*:0]const u8) void {
         c.___tracy_set_thread_name(name);
     }
 
     pub inline fn Zone(comptime src: Src) ZoneCtx {
         return initZone(src, null, 0, callstack_depth);
     }
-    pub inline fn ZoneN(comptime src: Src, name: [*:0]const u8) ZoneCtx {
+    pub inline fn ZoneN(comptime src: Src, comptime name: [*:0]const u8) ZoneCtx {
         return initZone(src, name, 0, callstack_depth);
     }
     pub inline fn ZoneC(comptime src: Src, color: u32) ZoneCtx {
         return initZone(src, null, color, callstack_depth);
     }
-    pub inline fn ZoneNC(comptime src: Src, name: [*:0]const u8, color: u32) ZoneCtx {
+    pub inline fn ZoneNC(comptime src: Src, comptime name: [*:0]const u8, color: u32) ZoneCtx {
         return initZone(src, name, color, callstack_depth);
     }
     pub inline fn ZoneS(comptime src: Src, depth: i32) ZoneCtx {
         return initZone(src, null, 0, depth);
     }
-    pub inline fn ZoneNS(comptime src: Src, name: [*:0]const u8, depth: i32) ZoneCtx {
+    pub inline fn ZoneNS(comptime src: Src, comptime name: [*:0]const u8, depth: i32) ZoneCtx {
         return initZone(src, name, 0, depth);
     }
     pub inline fn ZoneCS(comptime src: Src, color: u32, depth: i32) ZoneCtx {
         return initZone(src, null, color, depth);
     }
-    pub inline fn ZoneNCS(comptime src: Src, name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {
+    pub inline fn ZoneNCS(comptime src: Src, comptime name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {
         return initZone(src, name, color, depth);
     }
 
@@ -431,56 +423,56 @@ const tracy_full = struct {
         }
     }
 
-    pub inline fn AllocN(ptr: ?*const anyopaque, size: usize, name: [*:0]const u8) void {
+    pub inline fn AllocN(ptr: ?*const anyopaque, size: usize, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_alloc_callstack_named(ptr, size, callstack_depth, 0, name);
         } else {
             c.___tracy_emit_memory_alloc_named(ptr, size, 0, name);
         }
     }
-    pub inline fn FreeN(ptr: ?*const anyopaque, name: [*:0]const u8) void {
+    pub inline fn FreeN(ptr: ?*const anyopaque, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_free_callstack_named(ptr, callstack_depth, 0, name);
         } else {
             c.___tracy_emit_memory_free_named(ptr, 0, name);
         }
     }
-    pub inline fn SecureAllocN(ptr: ?*const anyopaque, size: usize, name: [*:0]const u8) void {
+    pub inline fn SecureAllocN(ptr: ?*const anyopaque, size: usize, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_alloc_callstack_named(ptr, size, callstack_depth, 1, name);
         } else {
             c.___tracy_emit_memory_alloc_named(ptr, size, 1, name);
         }
     }
-    pub inline fn SecureFreeN(ptr: ?*const anyopaque, name: [*:0]const u8) void {
+    pub inline fn SecureFreeN(ptr: ?*const anyopaque, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_free_callstack_named(ptr, callstack_depth, 1, name);
         } else {
             c.___tracy_emit_memory_free_named(ptr, 1, name);
         }
     }
-    pub inline fn AllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn AllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_alloc_callstack_named(ptr, size, depth, 0, name);
         } else {
             c.___tracy_emit_memory_alloc_named(ptr, size, 0, name);
         }
     }
-    pub inline fn FreeNS(ptr: ?*const anyopaque, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn FreeNS(ptr: ?*const anyopaque, depth: c_int, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_free_callstack_named(ptr, depth, 0, name);
         } else {
             c.___tracy_emit_memory_free_named(ptr, 0, name);
         }
     }
-    pub inline fn SecureAllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn SecureAllocNS(ptr: ?*const anyopaque, size: usize, depth: c_int, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_alloc_callstack_named(ptr, size, depth, 1, name);
         } else {
             c.___tracy_emit_memory_alloc_named(ptr, size, 1, name);
         }
     }
-    pub inline fn SecureFreeNS(ptr: ?*const anyopaque, depth: c_int, name: [*:0]const u8) void {
+    pub inline fn SecureFreeNS(ptr: ?*const anyopaque, depth: c_int, comptime name: [*:0]const u8) void {
         if (has_callstack_support) {
             c.___tracy_emit_memory_free_callstack_named(ptr, depth, 1, name);
         } else {
@@ -491,62 +483,62 @@ const tracy_full = struct {
     pub inline fn Message(text: []const u8) void {
         c.___tracy_emit_message(text.ptr, text.len, callstack_depth);
     }
-    pub inline fn MessageL(text: [*:0]const u8, color: u32) void {
+    pub inline fn MessageL(comptime text: [*:0]const u8, color: u32) void {
         c.___tracy_emit_messageL(text, color, callstack_depth);
     }
     pub inline fn MessageC(text: []const u8, color: u32) void {
         c.___tracy_emit_messageC(text.ptr, text.len, color, callstack_depth);
     }
-    pub inline fn MessageLC(text: [*:0]const u8, color: u32) void {
+    pub inline fn MessageLC(comptime text: [*:0]const u8, color: u32) void {
         c.___tracy_emit_messageLC(text, color, callstack_depth);
     }
     pub inline fn MessageS(text: []const u8, depth: c_int) void {
         const inner_depth: c_int = if (has_callstack_support) depth else 0;
         c.___tracy_emit_message(text.ptr, text.len, inner_depth);
     }
-    pub inline fn MessageLS(text: [*:0]const u8, depth: c_int) void {
+    pub inline fn MessageLS(comptime text: [*:0]const u8, depth: c_int) void {
         const inner_depth: c_int = if (has_callstack_support) depth else 0;
         c.___tracy_emit_messageL(text, inner_depth);
     }
     pub inline fn MessageCS(text: []const u8, color: u32, depth: c_int) void {
         const inner_depth: c_int = if (has_callstack_support) depth else 0;
         c.___tracy_emit_messageC(text.ptr, text.len, color, inner_depth);
     }
-    pub inline fn MessageLCS(text: [*:0]const u8, color: u32, depth: c_int) void {
+    pub inline fn MessageLCS(comptime text: [*:0]const u8, color: u32, depth: c_int) void {
         const inner_depth: c_int = if (has_callstack_support) depth else 0;
         c.___tracy_emit_messageLC(text, color, inner_depth);
     }
 
     pub inline fn FrameMark() void {
         c.___tracy_emit_frame_mark(null);
     }
-    pub inline fn FrameMarkNamed(name: [*:0]const u8) void {
+    pub inline fn FrameMarkNamed(comptime name: [*:0]const u8) void {
         c.___tracy_emit_frame_mark(name);
     }
-    pub inline fn FrameMarkStart(name: [*:0]const u8) void {
+    pub inline fn FrameMarkStart(comptime name: [*:0]const u8) void {
         c.___tracy_emit_frame_mark_start(name);
     }
-    pub inline fn FrameMarkEnd(name: [*:0]const u8) void {
+    pub inline fn FrameMarkEnd(comptime name: [*:0]const u8) void {
         c.___tracy_emit_frame_mark_end(name);
     }
     pub inline fn FrameImage(image: ?*const anyopaque, width: u16, height: u16, offset: u8, flip: c_int) void {
         c.___tracy_emit_frame_image(image, width, height, offset, flip);
     }
 
-    pub inline fn FiberEnter(name: [*:0]const u8) void {
+    pub inline fn FiberEnter(comptime name: [*:0]const u8) void {
         c.___tracy_fiber_enter(name);
     }
     pub inline fn FiberLeave() void {
         c.___tracy_fiber_leave();
     }
 
-    pub inline fn PlotF(name: [*:0]const u8, val: f64) void {
+    pub inline fn PlotF(comptime name: [*:0]const u8, val: f64) void {
         c.___tracy_emit_plot(name, val);
     }
-    pub inline fn PlotU(name: [*:0]const u8, val: u64) void {
+    pub inline fn PlotU(comptime name: [*:0]const u8, val: u64) void {
         c.___tracy_emit_plot(name, @as(f64, @floatFromInt(val)));
     }
-    pub inline fn PlotI(name: [*:0]const u8, val: i64) void {
+    pub inline fn PlotI(comptime name: [*:0]const u8, val: i64) void {
         c.___tracy_emit_plot(name, @as(f64, @floatFromInt(val)));
     }
     pub inline fn AppInfo(text: []const u8) void {

Original file line number	Diff line number	Diff line change
`@@ -41,15 +41,15 @@ const tracy_stub = struct {`
`41`	`41`	`}`
`42`	`42`	`};`
`43`	`43`
`44`		`- pub inline fn SetThreadName(name: [*:0]const u8) void {`
	`44`	`+ pub inline fn SetThreadName(comptime name: [*:0]const u8) void {`
`45`	`45`	`_ = name;`
`46`	`46`	`}`
`47`	`47`
`48`	`48`	`pub inline fn Zone(comptime src: Src) ZoneCtx {`
`49`	`49`	`_ = src;`
`50`	`50`	`return .{};`
`51`	`51`	`}`
`52`		`- pub inline fn ZoneN(comptime src: Src, name: [*:0]const u8) ZoneCtx {`
	`52`	`+ pub inline fn ZoneN(comptime src: Src, comptime name: [*:0]const u8) ZoneCtx {`
`53`	`53`	`_ = src;`
`54`	`54`	`_ = name;`
`55`	`55`	`return .{};`
`@@ -59,7 +59,7 @@ const tracy_stub = struct {`
`59`	`59`	`_ = color;`
`60`	`60`	`return .{};`
`61`	`61`	`}`
`62`		`- pub inline fn ZoneNC(comptime src: Src, name: [*:0]const u8, color: u32) ZoneCtx {`
	`62`	`+ pub inline fn ZoneNC(comptime src: Src, comptime name: [*:0]const u8, color: u32) ZoneCtx {`
`63`	`63`	`_ = src;`
`64`	`64`	`_ = name;`
`65`	`65`	`_ = color;`
`@@ -70,7 +70,7 @@ const tracy_stub = struct {`
`70`	`70`	`_ = depth;`
`71`	`71`	`return .{};`
`72`	`72`	`}`
`73`		`- pub inline fn ZoneNS(comptime src: Src, name: [*:0]const u8, depth: i32) ZoneCtx {`
	`73`	`+ pub inline fn ZoneNS(comptime src: Src, comptime name: [*:0]const u8, depth: i32) ZoneCtx {`
`74`	`74`	`_ = src;`
`75`	`75`	`_ = name;`
`76`	`76`	`_ = depth;`
`@@ -82,7 +82,7 @@ const tracy_stub = struct {`
`82`	`82`	`_ = depth;`
`83`	`83`	`return .{};`
`84`	`84`	`}`
`85`		`- pub inline fn ZoneNCS(comptime src: Src, name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {`
	`85`	`+ pub inline fn ZoneNCS(comptime src: Src, comptime name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {`
`86`	`86`	`_ = src;`
`87`	`87`	`_ = name;`
`88`	`88`	`_ = color;`
`@@ -123,42 +123,42 @@ const tracy_stub = struct {`
`123`	`123`	`_ = depth;`
`124`	`124`	`}`
`125`	`125`
`126`		`- pub inline fn AllocN(ptr: ?const anyopaque, size: usize, name: [:0]const u8) void {`
	`126`	`+ pub inline fn AllocN(ptr: ?const anyopaque, size: usize, comptime name: [:0]const u8) void {`
`127`	`127`	`_ = ptr;`
`128`	`128`	`_ = size;`
`129`	`129`	`_ = name;`
`130`	`130`	`}`
`131`		`- pub inline fn FreeN(ptr: ?const anyopaque, name: [:0]const u8) void {`
	`131`	`+ pub inline fn FreeN(ptr: ?const anyopaque, comptime name: [:0]const u8) void {`
`132`	`132`	`_ = ptr;`
`133`	`133`	`_ = name;`
`134`	`134`	`}`
`135`		`- pub inline fn SecureAllocN(ptr: ?const anyopaque, size: usize, name: [:0]const u8) void {`
	`135`	`+ pub inline fn SecureAllocN(ptr: ?const anyopaque, size: usize, comptime name: [:0]const u8) void {`
`136`	`136`	`_ = ptr;`
`137`	`137`	`_ = size;`
`138`	`138`	`_ = name;`
`139`	`139`	`}`
`140`		`- pub inline fn SecureFreeN(ptr: ?const anyopaque, name: [:0]const u8) void {`
	`140`	`+ pub inline fn SecureFreeN(ptr: ?const anyopaque, comptime name: [:0]const u8) void {`
`141`	`141`	`_ = ptr;`
`142`	`142`	`_ = name;`
`143`	`143`	`}`
`144`		`- pub inline fn AllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, name: [:0]const u8) void {`
	`144`	`+ pub inline fn AllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, comptime name: [:0]const u8) void {`
`145`	`145`	`_ = ptr;`
`146`	`146`	`_ = size;`
`147`	`147`	`_ = depth;`
`148`	`148`	`_ = name;`
`149`	`149`	`}`
`150`		`- pub inline fn FreeNS(ptr: ?const anyopaque, depth: c_int, name: [:0]const u8) void {`
	`150`	`+ pub inline fn FreeNS(ptr: ?const anyopaque, depth: c_int, comptime name: [:0]const u8) void {`
`151`	`151`	`_ = ptr;`
`152`	`152`	`_ = depth;`
`153`	`153`	`_ = name;`
`154`	`154`	`}`
`155`		`- pub inline fn SecureAllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, name: [:0]const u8) void {`
	`155`	`+ pub inline fn SecureAllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, comptime name: [:0]const u8) void {`
`156`	`156`	`_ = ptr;`
`157`	`157`	`_ = size;`
`158`	`158`	`_ = depth;`
`159`	`159`	`_ = name;`
`160`	`160`	`}`
`161`		`- pub inline fn SecureFreeNS(ptr: ?const anyopaque, depth: c_int, name: [:0]const u8) void {`
	`161`	`+ pub inline fn SecureFreeNS(ptr: ?const anyopaque, depth: c_int, comptime name: [:0]const u8) void {`
`162`	`162`	`_ = ptr;`
`163`	`163`	`_ = depth;`
`164`	`164`	`_ = name;`
`@@ -167,22 +167,22 @@ const tracy_stub = struct {`
`167`	`167`	`pub inline fn Message(text: []const u8) void {`
`168`	`168`	`_ = text;`
`169`	`169`	`}`
`170`		`- pub inline fn MessageL(text: [*:0]const u8) void {`
	`170`	`+ pub inline fn MessageL(comptime text: [*:0]const u8) void {`
`171`	`171`	`_ = text;`
`172`	`172`	`}`
`173`	`173`	`pub inline fn MessageC(text: []const u8, color: u32) void {`
`174`	`174`	`_ = text;`
`175`	`175`	`_ = color;`
`176`	`176`	`}`
`177`		`- pub inline fn MessageLC(text: [*:0]const u8, color: u32) void {`
	`177`	`+ pub inline fn MessageLC(comptime text: [*:0]const u8, color: u32) void {`
`178`	`178`	`_ = text;`
`179`	`179`	`_ = color;`
`180`	`180`	`}`
`181`	`181`	`pub inline fn MessageS(text: []const u8, depth: c_int) void {`
`182`	`182`	`_ = text;`
`183`	`183`	`_ = depth;`
`184`	`184`	`}`
`185`		`- pub inline fn MessageLS(text: [*:0]const u8, depth: c_int) void {`
	`185`	`+ pub inline fn MessageLS(comptime text: [*:0]const u8, depth: c_int) void {`
`186`	`186`	`_ = text;`
`187`	`187`	`_ = depth;`
`188`	`188`	`}`
`@@ -191,20 +191,20 @@ const tracy_stub = struct {`
`191`	`191`	`_ = color;`
`192`	`192`	`_ = depth;`
`193`	`193`	`}`
`194`		`- pub inline fn MessageLCS(text: [*:0]const u8, color: u32, depth: c_int) void {`
	`194`	`+ pub inline fn MessageLCS(comptime text: [*:0]const u8, color: u32, depth: c_int) void {`
`195`	`195`	`_ = text;`
`196`	`196`	`_ = color;`
`197`	`197`	`_ = depth;`
`198`	`198`	`}`
`199`	`199`
`200`	`200`	`pub inline fn FrameMark() void {}`
`201`		`- pub inline fn FrameMarkNamed(name: [*:0]const u8) void {`
	`201`	`+ pub inline fn FrameMarkNamed(comptime name: [*:0]const u8) void {`
`202`	`202`	`_ = name;`
`203`	`203`	`}`
`204`		`- pub inline fn FrameMarkStart(name: [*:0]const u8) void {`
	`204`	`+ pub inline fn FrameMarkStart(comptime name: [*:0]const u8) void {`
`205`	`205`	`_ = name;`
`206`	`206`	`}`
`207`		`- pub inline fn FrameMarkEnd(name: [*:0]const u8) void {`
	`207`	`+ pub inline fn FrameMarkEnd(comptime name: [*:0]const u8) void {`
`208`	`208`	`_ = name;`
`209`	`209`	`}`
`210`	`210`	`pub inline fn FrameImage(image: ?*const anyopaque, width: u16, height: u16, offset: u8, flip: c_int) void {`
`@@ -215,20 +215,20 @@ const tracy_stub = struct {`
`215`	`215`	`_ = flip;`
`216`	`216`	`}`
`217`	`217`
`218`		`- pub inline fn FiberEnter(name: [*:0]const u8) void {`
	`218`	`+ pub inline fn FiberEnter(comptime name: [*:0]const u8) void {`
`219`	`219`	`_ = name;`
`220`	`220`	`}`
`221`	`221`	`pub inline fn FiberLeave() void {}`
`222`	`222`
`223`		`- pub inline fn PlotF(name: [*:0]const u8, val: f64) void {`
	`223`	`+ pub inline fn PlotF(comptime name: [*:0]const u8, val: f64) void {`
`224`	`224`	`_ = name;`
`225`	`225`	`_ = val;`
`226`	`226`	`}`
`227`		`- pub inline fn PlotU(name: [*:0]const u8, val: u64) void {`
	`227`	`+ pub inline fn PlotU(comptime name: [*:0]const u8, val: u64) void {`
`228`	`228`	`_ = name;`
`229`	`229`	`_ = val;`
`230`	`230`	`}`
`231`		`- pub inline fn PlotI(name: [*:0]const u8, val: i64) void {`
	`231`	`+ pub inline fn PlotI(comptime name: [*:0]const u8, val: i64) void {`
`232`	`232`	`_ = name;`
`233`	`233`	`_ = val;`
`234`	`234`	`}`
`@@ -309,27 +309,19 @@ const tracy_full = struct {`
`309`	`309`	`}`
`310`	`310`	`};`
`311`	`311`
`312`		`- inline fn initZone(comptime src: Src, name: ?[*:0]const u8, color: u32, depth: c_int) ZoneCtx {`
	`312`	`+ inline fn initZone(comptime src: Src, comptime name: ?[*:0]const u8, comptime color: u32, comptime depth: c_int) ZoneCtx {`
`313`	`313`	`// Tracy uses pointer identity to identify contexts.`
`314`	`314`	// The `src` parameter being comptime ensures that
`315`	`315`	`// each zone gets its own unique global location for this`
`316`	`316`	`// struct.`
`317`	`317`	`const static = struct {`
`318`		`- var loc: c.___tracy_source_location_data = undefined;`
`319`		`-`
`320`		- // Ensure that a unique struct type is generated for each unique `src`. See
`321`		`- // https://github.com/ziglang/zig/issues/18816`
`322`		`- comptime {`
`323`		`- // https://github.com/ziglang/zig/issues/19274`
`324`		`- _ = @sizeOf(@TypeOf(src));`
`325`		`- }`
`326`		`- };`
`327`		`- static.loc = .{`
`328`		`- .name = name,`
`329`		`- .function = src.fn_name.ptr,`
`330`		`- .file = src.file.ptr,`
`331`		`- .line = src.line,`
`332`		`- .color = color,`
	`318`	`+ const loc: c.___tracy_source_location_data = .{`
	`319`	`+ .name = name,`
	`320`	`+ .function = src.fn_name.ptr,`
	`321`	`+ .file = src.file.ptr,`
	`322`	`+ .line = src.line,`
	`323`	`+ .color = color,`
	`324`	`+ };`
`333`	`325`	`};`
`334`	`326`
`335`	`327`	`const zone = if (has_callstack_support)`
`@@ -345,32 +337,32 @@ const tracy_full = struct {`
`345`	`337`	`}`
`346`	`338`	`}`
`347`	`339`
`348`		`- pub inline fn SetThreadName(name: [*:0]const u8) void {`
	`340`	`+ pub inline fn SetThreadName(comptime name: [*:0]const u8) void {`
`349`	`341`	`c.___tracy_set_thread_name(name);`
`350`	`342`	`}`
`351`	`343`
`352`	`344`	`pub inline fn Zone(comptime src: Src) ZoneCtx {`
`353`	`345`	`return initZone(src, null, 0, callstack_depth);`
`354`	`346`	`}`
`355`		`- pub inline fn ZoneN(comptime src: Src, name: [*:0]const u8) ZoneCtx {`
	`347`	`+ pub inline fn ZoneN(comptime src: Src, comptime name: [*:0]const u8) ZoneCtx {`
`356`	`348`	`return initZone(src, name, 0, callstack_depth);`
`357`	`349`	`}`
`358`	`350`	`pub inline fn ZoneC(comptime src: Src, color: u32) ZoneCtx {`
`359`	`351`	`return initZone(src, null, color, callstack_depth);`
`360`	`352`	`}`
`361`		`- pub inline fn ZoneNC(comptime src: Src, name: [*:0]const u8, color: u32) ZoneCtx {`
	`353`	`+ pub inline fn ZoneNC(comptime src: Src, comptime name: [*:0]const u8, color: u32) ZoneCtx {`
`362`	`354`	`return initZone(src, name, color, callstack_depth);`
`363`	`355`	`}`
`364`	`356`	`pub inline fn ZoneS(comptime src: Src, depth: i32) ZoneCtx {`
`365`	`357`	`return initZone(src, null, 0, depth);`
`366`	`358`	`}`
`367`		`- pub inline fn ZoneNS(comptime src: Src, name: [*:0]const u8, depth: i32) ZoneCtx {`
	`359`	`+ pub inline fn ZoneNS(comptime src: Src, comptime name: [*:0]const u8, depth: i32) ZoneCtx {`
`368`	`360`	`return initZone(src, name, 0, depth);`
`369`	`361`	`}`
`370`	`362`	`pub inline fn ZoneCS(comptime src: Src, color: u32, depth: i32) ZoneCtx {`
`371`	`363`	`return initZone(src, null, color, depth);`
`372`	`364`	`}`
`373`		`- pub inline fn ZoneNCS(comptime src: Src, name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {`
	`365`	`+ pub inline fn ZoneNCS(comptime src: Src, comptime name: [*:0]const u8, color: u32, depth: i32) ZoneCtx {`
`374`	`366`	`return initZone(src, name, color, depth);`
`375`	`367`	`}`
`376`	`368`
`@@ -431,56 +423,56 @@ const tracy_full = struct {`
`431`	`423`	`}`
`432`	`424`	`}`
`433`	`425`
`434`		`- pub inline fn AllocN(ptr: ?const anyopaque, size: usize, name: [:0]const u8) void {`
	`426`	`+ pub inline fn AllocN(ptr: ?const anyopaque, size: usize, comptime name: [:0]const u8) void {`
`435`	`427`	`if (has_callstack_support) {`
`436`	`428`	`c.___tracy_emit_memory_alloc_callstack_named(ptr, size, callstack_depth, 0, name);`
`437`	`429`	`} else {`
`438`	`430`	`c.___tracy_emit_memory_alloc_named(ptr, size, 0, name);`
`439`	`431`	`}`
`440`	`432`	`}`
`441`		`- pub inline fn FreeN(ptr: ?const anyopaque, name: [:0]const u8) void {`
	`433`	`+ pub inline fn FreeN(ptr: ?const anyopaque, comptime name: [:0]const u8) void {`
`442`	`434`	`if (has_callstack_support) {`
`443`	`435`	`c.___tracy_emit_memory_free_callstack_named(ptr, callstack_depth, 0, name);`
`444`	`436`	`} else {`
`445`	`437`	`c.___tracy_emit_memory_free_named(ptr, 0, name);`
`446`	`438`	`}`
`447`	`439`	`}`
`448`		`- pub inline fn SecureAllocN(ptr: ?const anyopaque, size: usize, name: [:0]const u8) void {`
	`440`	`+ pub inline fn SecureAllocN(ptr: ?const anyopaque, size: usize, comptime name: [:0]const u8) void {`
`449`	`441`	`if (has_callstack_support) {`
`450`	`442`	`c.___tracy_emit_memory_alloc_callstack_named(ptr, size, callstack_depth, 1, name);`
`451`	`443`	`} else {`
`452`	`444`	`c.___tracy_emit_memory_alloc_named(ptr, size, 1, name);`
`453`	`445`	`}`
`454`	`446`	`}`
`455`		`- pub inline fn SecureFreeN(ptr: ?const anyopaque, name: [:0]const u8) void {`
	`447`	`+ pub inline fn SecureFreeN(ptr: ?const anyopaque, comptime name: [:0]const u8) void {`
`456`	`448`	`if (has_callstack_support) {`
`457`	`449`	`c.___tracy_emit_memory_free_callstack_named(ptr, callstack_depth, 1, name);`
`458`	`450`	`} else {`
`459`	`451`	`c.___tracy_emit_memory_free_named(ptr, 1, name);`
`460`	`452`	`}`
`461`	`453`	`}`
`462`		`- pub inline fn AllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, name: [:0]const u8) void {`
	`454`	`+ pub inline fn AllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, comptime name: [:0]const u8) void {`
`463`	`455`	`if (has_callstack_support) {`
`464`	`456`	`c.___tracy_emit_memory_alloc_callstack_named(ptr, size, depth, 0, name);`
`465`	`457`	`} else {`
`466`	`458`	`c.___tracy_emit_memory_alloc_named(ptr, size, 0, name);`
`467`	`459`	`}`
`468`	`460`	`}`
`469`		`- pub inline fn FreeNS(ptr: ?const anyopaque, depth: c_int, name: [:0]const u8) void {`
	`461`	`+ pub inline fn FreeNS(ptr: ?const anyopaque, depth: c_int, comptime name: [:0]const u8) void {`
`470`	`462`	`if (has_callstack_support) {`
`471`	`463`	`c.___tracy_emit_memory_free_callstack_named(ptr, depth, 0, name);`
`472`	`464`	`} else {`
`473`	`465`	`c.___tracy_emit_memory_free_named(ptr, 0, name);`
`474`	`466`	`}`
`475`	`467`	`}`
`476`		`- pub inline fn SecureAllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, name: [:0]const u8) void {`
	`468`	`+ pub inline fn SecureAllocNS(ptr: ?const anyopaque, size: usize, depth: c_int, comptime name: [:0]const u8) void {`
`477`	`469`	`if (has_callstack_support) {`
`478`	`470`	`c.___tracy_emit_memory_alloc_callstack_named(ptr, size, depth, 1, name);`
`479`	`471`	`} else {`
`480`	`472`	`c.___tracy_emit_memory_alloc_named(ptr, size, 1, name);`
`481`	`473`	`}`
`482`	`474`	`}`
`483`		`- pub inline fn SecureFreeNS(ptr: ?const anyopaque, depth: c_int, name: [:0]const u8) void {`
	`475`	`+ pub inline fn SecureFreeNS(ptr: ?const anyopaque, depth: c_int, comptime name: [:0]const u8) void {`
`484`	`476`	`if (has_callstack_support) {`
`485`	`477`	`c.___tracy_emit_memory_free_callstack_named(ptr, depth, 1, name);`
`486`	`478`	`} else {`
`@@ -491,62 +483,62 @@ const tracy_full = struct {`
`491`	`483`	`pub inline fn Message(text: []const u8) void {`
`492`	`484`	`c.___tracy_emit_message(text.ptr, text.len, callstack_depth);`
`493`	`485`	`}`
`494`		`- pub inline fn MessageL(text: [*:0]const u8, color: u32) void {`
	`486`	`+ pub inline fn MessageL(comptime text: [*:0]const u8, color: u32) void {`
`495`	`487`	`c.___tracy_emit_messageL(text, color, callstack_depth);`
`496`	`488`	`}`
`497`	`489`	`pub inline fn MessageC(text: []const u8, color: u32) void {`
`498`	`490`	`c.___tracy_emit_messageC(text.ptr, text.len, color, callstack_depth);`
`499`	`491`	`}`
`500`		`- pub inline fn MessageLC(text: [*:0]const u8, color: u32) void {`
	`492`	`+ pub inline fn MessageLC(comptime text: [*:0]const u8, color: u32) void {`
`501`	`493`	`c.___tracy_emit_messageLC(text, color, callstack_depth);`
`502`	`494`	`}`
`503`	`495`	`pub inline fn MessageS(text: []const u8, depth: c_int) void {`
`504`	`496`	`const inner_depth: c_int = if (has_callstack_support) depth else 0;`
`505`	`497`	`c.___tracy_emit_message(text.ptr, text.len, inner_depth);`
`506`	`498`	`}`
`507`		`- pub inline fn MessageLS(text: [*:0]const u8, depth: c_int) void {`
	`499`	`+ pub inline fn MessageLS(comptime text: [*:0]const u8, depth: c_int) void {`
`508`	`500`	`const inner_depth: c_int = if (has_callstack_support) depth else 0;`
`509`	`501`	`c.___tracy_emit_messageL(text, inner_depth);`
`510`	`502`	`}`
`511`	`503`	`pub inline fn MessageCS(text: []const u8, color: u32, depth: c_int) void {`
`512`	`504`	`const inner_depth: c_int = if (has_callstack_support) depth else 0;`
`513`	`505`	`c.___tracy_emit_messageC(text.ptr, text.len, color, inner_depth);`
`514`	`506`	`}`
`515`		`- pub inline fn MessageLCS(text: [*:0]const u8, color: u32, depth: c_int) void {`
	`507`	`+ pub inline fn MessageLCS(comptime text: [*:0]const u8, color: u32, depth: c_int) void {`
`516`	`508`	`const inner_depth: c_int = if (has_callstack_support) depth else 0;`
`517`	`509`	`c.___tracy_emit_messageLC(text, color, inner_depth);`
`518`	`510`	`}`
`519`	`511`
`520`	`512`	`pub inline fn FrameMark() void {`
`521`	`513`	`c.___tracy_emit_frame_mark(null);`
`522`	`514`	`}`
`523`		`- pub inline fn FrameMarkNamed(name: [*:0]const u8) void {`
	`515`	`+ pub inline fn FrameMarkNamed(comptime name: [*:0]const u8) void {`
`524`	`516`	`c.___tracy_emit_frame_mark(name);`
`525`	`517`	`}`
`526`		`- pub inline fn FrameMarkStart(name: [*:0]const u8) void {`
	`518`	`+ pub inline fn FrameMarkStart(comptime name: [*:0]const u8) void {`
`527`	`519`	`c.___tracy_emit_frame_mark_start(name);`
`528`	`520`	`}`
`529`		`- pub inline fn FrameMarkEnd(name: [*:0]const u8) void {`
	`521`	`+ pub inline fn FrameMarkEnd(comptime name: [*:0]const u8) void {`
`530`	`522`	`c.___tracy_emit_frame_mark_end(name);`
`531`	`523`	`}`
`532`	`524`	`pub inline fn FrameImage(image: ?*const anyopaque, width: u16, height: u16, offset: u8, flip: c_int) void {`
`533`	`525`	`c.___tracy_emit_frame_image(image, width, height, offset, flip);`
`534`	`526`	`}`
`535`	`527`
`536`		`- pub inline fn FiberEnter(name: [*:0]const u8) void {`
	`528`	`+ pub inline fn FiberEnter(comptime name: [*:0]const u8) void {`
`537`	`529`	`c.___tracy_fiber_enter(name);`
`538`	`530`	`}`
`539`	`531`	`pub inline fn FiberLeave() void {`
`540`	`532`	`c.___tracy_fiber_leave();`
`541`	`533`	`}`
`542`	`534`
`543`		`- pub inline fn PlotF(name: [*:0]const u8, val: f64) void {`
	`535`	`+ pub inline fn PlotF(comptime name: [*:0]const u8, val: f64) void {`
`544`	`536`	`c.___tracy_emit_plot(name, val);`
`545`	`537`	`}`
`546`		`- pub inline fn PlotU(name: [*:0]const u8, val: u64) void {`
	`538`	`+ pub inline fn PlotU(comptime name: [*:0]const u8, val: u64) void {`
`547`	`539`	`c.___tracy_emit_plot(name, @as(f64, @floatFromInt(val)));`
`548`	`540`	`}`
`549`		`- pub inline fn PlotI(name: [*:0]const u8, val: i64) void {`
	`541`	`+ pub inline fn PlotI(comptime name: [*:0]const u8, val: i64) void {`
`550`	`542`	`c.___tracy_emit_plot(name, @as(f64, @floatFromInt(val)));`
`551`	`543`	`}`
`552`	`544`	`pub inline fn AppInfo(text: []const u8) void {`