diff options
Diffstat (limited to 'anim/scenes/syscalls.zig')
| -rw-r--r-- | anim/scenes/syscalls.zig | 49 |
1 files changed, 49 insertions, 0 deletions
diff --git a/anim/scenes/syscalls.zig b/anim/scenes/syscalls.zig new file mode 100644 index 0000000..1516251 --- /dev/null +++ b/anim/scenes/syscalls.zig @@ -0,0 +1,49 @@ +//! A program that needs the kernel four times: open, read, close, write. +//! The debugger's context, and the kernel's side of each call as the lens. +//! +//! How it moves (design/motion.md): no effect before its cause. Each call +//! has its own caption, up a second before the line fires; the registers +//! that carry it are framed one at a time; the arrow goes down through +//! the line, and only then does the kernel's side take the call: its +//! name, its rows, its card. The bytes are copied two frames apart; the +//! arrow comes back; `rax` is struck. A call is as long as what it does. +const anim = @import("anim"); +const canim = @import("canim"); +const recordings = @import("recordings"); + +pub const background = canim.background; +pub const scene = anim.Live(frame, struct {}); + +/// What the narrator says before each of main's calls, in order. +const lines = [_][]const u8{ + "`open`: a name goes down, and a small number comes back.\nThat number is the file from now on.", + "`read`: the kernel copies the file's bytes into `buf`,\nand says how many.", + "`close`: the number is handed back.", + "`write`: the same bytes go the other way,\nfrom `buf` to file number 1, the output.", +}; + +fn frame(s: *anim.Frame) void { + const rec = canim.open(recordings.hello); + // From main's first call to its last line. + var at = canim.cursor(s, rec, rec.lineMoment(6, rec.call("main", 0).enter)); + at.journey(.line, rec.lineMoment(10, at.first)); + const split = canim.layout.split.beside; + at.levels = .{ .source_rows = 8 }; + const ctx = canim.context(s, at, .{ .split = split, .syscalls = true }); + // The lens: the kernel's side of each call. + const kernel = canim.crossing(s, .{ .cursor = at, .box = split.lens, .focus = true }); + var says: canim.Narrator = .{}; + const t = canim.theme.time; + + const joins = canim.ties(s, .{ .cursor = at }); + canim.establish(s, .{ ctx.clock, ctx.source, ctx.disasm, ctx.registers, ctx.stack, ctx.backtrace, kernel, joins }); + says.line(s, "A program cannot open a file or reach the screen itself.\nIt asks the kernel, and waits."); + + // One call a phrase: its caption while nothing moves, then the crossing. + for (lines) |line| { + says.line(s, line); + canim.syscalls.step(at, s, .line); + s.wait(t.phrase_rest); + } + s.wait(t.before_cut - t.phrase_rest); +} |
