diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-06 13:28:30 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-06 14:24:59 -0300 |
| commit | 0f81de017ca7b52e951bb70f6f5f3e8c88b425e6 (patch) | |
| tree | fde88db0ed0dd68fbeb7bf7aaa49d3cd1f08b1c1 /addons/image/image.zig | |
| parent | b7fdfb18ffd199d49a254c1c799bc3415ad45ec2 (diff) | |
| download | pardes-0f81de017ca7b52e951bb70f6f5f3e8c88b425e6.tar.gz pardes-0f81de017ca7b52e951bb70f6f5f3e8c88b425e6.zip | |
kinds #25, addons in Zig: src/kinds/addon.zig, over the translated header and nothing of the core, makes a kind's pa_ops from a struct of the functions it has (its head from name, version, extensions and words; a public function of no kind's name a compile error), the pane's arena and a job's pa_out as std Allocators, typed keys, a Window to put text in, a Paint for the prefix and placements, tick's flags and a Deadline, dump and load as an extern struct's bytes in one line each, and body and ctl over a Writer; snake.zig and image.zig (stb_image in stb.c, static, beside any zstbi) replace snake.c and image.c with the same goldens, harness and perf cell, and addon-test runs their own zig tests
Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'addons/image/image.zig')
| -rw-r--r-- | addons/image/image.zig | 124 |
1 files changed, 124 insertions, 0 deletions
diff --git a/addons/image/image.zig b/addons/image/image.zig new file mode 100644 index 00000000..824d708f --- /dev/null +++ b/addons/image/image.zig @@ -0,0 +1,124 @@ +//! image.zig: pictures as a pardes addon (.png .jpg .gif .bmp .ppm .pgm .tga). +//! A pane keeps its file's bytes (its record in a dump) and decodes them on +//! a job with stb_image (stb.c), at most max_dim pixels a side; the core +//! shows the RGBA fitted to the pane (or as glyph art, its Petscii word). +const std = @import("std"); +const addon = @import("addon"); + +const max_dim = 1280; // the longest side kept +const max_pixels = 64 << 20; // refused before decoding + +extern fn pa_image_info(bytes: [*]const u8, n: c_int, w: *c_int, h: *c_int) c_int; +extern fn pa_image_load(bytes: [*]const u8, n: c_int, w: *c_int, h: *c_int) ?[*]const u8; +extern fn pa_image_resize(in: [*]const u8, w: c_int, h: c_int, out: [*]u8, nw: c_int, nh: c_int) c_int; + +/// stb's memory (stb.c): the job's on a worker, else the pane's arena. +threadlocal var job: ?std.mem.Allocator = null; +export fn pa_image_mem(n: usize) ?*anyopaque { + return ((job orelse addon.arena).alignedAlloc(u8, .@"16", n) catch return null).ptr; +} +export fn pa_image_remem(p: ?*anyopaque, old: usize, n: usize) ?*anyopaque { + const q: [*]u8 = @ptrCast(pa_image_mem(n) orelse return null); + if (p) |from| @memcpy(q[0..@min(old, n)], @as([*]const u8, @ptrCast(from))); + return q; +} + +/// Its width and height, if stb can read it. +fn info(bytes: []const u8) ?[2]u32 { + var w: c_int, var h: c_int = .{ 0, 0 }; + if (bytes.len == 0 or bytes.len > std.math.maxInt(c_int) or pa_image_info(bytes.ptr, @intCast(bytes.len), &w, &h) == 0) return null; + return .{ @intCast(w), @intCast(h) }; +} + +pub const Image = struct { + raw: []const u8 = &.{}, // the file's bytes + w: u32 = 0, + h: u32 = 0, + rgba: ?[]const u8 = null, // w x h, once its job is done + + pub const head: addon.Head = .{ .name = "image", .version = 1, .exts = ".png .jpg .jpeg .gif .bmp .ppm .pgm .tga" }; + + /// The bytes kept, and decoded on a job. + fn keep(im: *Image, bytes: []const u8) void { + im.raw = addon.arena.dupe(u8, bytes) catch return; + if (bytes.len > 0) _ = addon.job(im.raw); + } + + /// One it cannot read (corrupt, truncated, not what its name says) is + /// refused, rather than shown as a blank pane. + pub fn open(im: *Image, bytes: ?[]const u8) void { + const b = bytes orelse return; + if (info(b) == null) return addon.say("not an image pardes can read", .err); + im.keep(b); + } + + pub fn paint(im: *const Image, w: addon.Window, out: addon.Paint) void { + out.prefix("img", .{}); // the core follows it with its art words and the path + const rgba = im.rgba orelse return; + out.place(.{ .rgba = rgba.ptr, .w = im.w, .h = im.h, .src = .{ .w = im.w, .h = im.h }, .dst = .{ .w = w.cols, .h = w.rows } }); + } + + /// On a worker: width and height (little endian), then the RGBA. + pub fn jobRun(in: []const u8, gpa: std.mem.Allocator) ?[]u8 { + job = gpa; + defer job = null; + const wh = info(in) orelse return null; + if (@as(u64, wh[0]) * wh[1] > max_pixels) return null; + var w: c_int, var h: c_int = .{ 0, 0 }; + var px = pa_image_load(in.ptr, @intCast(in.len), &w, &h) orelse return null; + const longest: u64 = @max(wh[0], wh[1]); + var nw, var nh = wh; + if (longest > max_dim) { + nw = @max(1, @as(u32, @intCast(@as(u64, wh[0]) * max_dim / longest))); + nh = @max(1, @as(u32, @intCast(@as(u64, wh[1]) * max_dim / longest))); + const small = gpa.alloc(u8, @as(usize, nw) * nh * 4) catch return null; + if (pa_image_resize(px, w, h, small.ptr, @intCast(nw), @intCast(nh)) == 0) return null; + px = small.ptr; + } + const a = gpa.alloc(u8, 8 + @as(usize, nw) * nh * 4) catch return null; // the last: the answer + std.mem.writeInt(u32, a[0..4], nw, .little); + std.mem.writeInt(u32, a[4..8], nh, .little); + @memcpy(a[8..], px[0 .. a.len - 8]); + return a; + } + + pub fn jobDone(im: *Image, _: u32, out: []const u8) void { + if (out.len < 8) return; + const w = std.mem.readInt(u32, out[0..4], .little); + const h = std.mem.readInt(u32, out[4..8], .little); + if (@as(u64, w) * h * 4 != out.len - 8) return; + im.rgba = addon.arena.dupe(u8, out[8..]) catch return; + im.w, im.h = .{ w, h }; + } + + /// The record is the file's bytes. + pub fn dump(im: *const Image, buf: []u8) usize { + if (im.raw.len <= buf.len) @memcpy(buf[0..im.raw.len], im.raw); + return im.raw.len; + } + + /// On a state with no picture (a Restore's), the record's; one open + /// made from the file as it is now (it changed on disk) keeps that one. + pub fn load(im: *Image, bytes: []const u8, _: u32) bool { + if (im.raw.len == 0) im.keep(bytes); + return true; + } +}; + +export const pardes_addon = addon.ops(Image); + +test "a job decodes a picture to its size and pixels, and one past max_dim is scaled to fit" { + var arena: std.heap.ArenaAllocator = .init(std.testing.allocator); + defer arena.deinit(); + const png = "\x89PNG\r\n\x1a\n\x00\x00\x00\rIHDR\x00\x00\x00\x01\x00\x00\x00\x01\x08\x02\x00\x00\x00\x90wS\xde\x00\x00\x00\x0cIDATx\x9cc\xf8\xcf\xc0\x00\x00\x03\x01\x01\x00\xc9\xfe\x92\xef\x00\x00\x00\x00IEND\xaeB`\x82"; + const got = Image.jobRun(png, arena.allocator()).?; + try std.testing.expectEqualSlices(u8, &.{ 1, 0, 0, 0, 1, 0, 0, 0, 0xff, 0, 0, 0xff }, got); + // A PPM 2600x1: 1280x1 after. + var ppm: std.ArrayList(u8) = .empty; + try ppm.print(arena.allocator(), "P6\n2600 1\n255\n", .{}); + try ppm.appendNTimes(arena.allocator(), 0x80, 2600 * 3); + const wide = Image.jobRun(ppm.items, arena.allocator()).?; + try std.testing.expectEqual(1280, std.mem.readInt(u32, wide[0..4], .little)); + try std.testing.expectEqual(8 + 1280 * 4, wide.len); + try std.testing.expect(Image.jobRun("not a picture", arena.allocator()) == null); +} |
