summaryrefslogtreecommitdiff
path: root/anim/scenes/intro_stack.zig
diff options
context:
space:
mode:
Diffstat (limited to 'anim/scenes/intro_stack.zig')
-rw-r--r--anim/scenes/intro_stack.zig190
1 files changed, 129 insertions, 61 deletions
diff --git a/anim/scenes/intro_stack.zig b/anim/scenes/intro_stack.zig
index 49162e6..378d624 100644
--- a/anim/scenes/intro_stack.zig
+++ b/anim/scenes/intro_stack.zig
@@ -1,18 +1,23 @@
//! The introduction, chapter II: the stack (design/motion.md, "A scene: the
-//! introduction", II1 to II4; mock 31). It opens on chapter I's last
-//! picture, at the same moment of the `intro` recording (reverse's first
-//! instruction, its `push rbp`): the address space and the dump's link
+//! introduction", II1 to II4, here six beats; mock 31). It opens on chapter
+//! I's last picture, at the same moment of the `intro` recording (reverse's
+//! first instruction, its `push rbp`): the address space and the dump's link
//! fade, the words glide into the stack panel's rows where it stands in the
-//! working frame (sixteen of them and two `free` over rsp) and become it.
-//! rsp's row arrives over the stack and its pin lands on the top word; the
-//! push walked from the recording (rsp's pin climbing onto the saved rbp).
-//! The way back main left framed, main's three rows round its call arriving
-//! in the program column, the word aimed at the row it returns to (`aim`,
-//! this beat only), the offsets a `column`. rbp's row and pin, `mov rbp,
-//! rsp` and `sub rsp` walked: the frame; its roles and spans, a `column`
-//! each, the panel's tag last (`frame up`). Then the registers built over
-//! it a row at a time, their tag last. The text stands beside on the left,
-//! in the program column, empty until chapter III but for main's rows.
+//! working frame (sixteen of them and four `free` over rsp, the window held
+//! there so that nothing in the panel moves while the frame is made) and
+//! become it; the convention said there (lower addresses drawn higher), the
+//! offsets coming down the rows. rsp's and rbp's rows arrive over the stack,
+//! rsp's pin landing on the top word. The call first: the way back main
+//! left framed, main's three rows round its call arriving in the program
+//! column, the word aimed at the row it returns to (`aim`, drawn head first,
+//! standing at 60% through the push). Then reverse's first rows under
+//! main's (the disassembly) and `push rbp` walked: the pc's mark on its
+//! row, the touch to the word, rbp's value carried to it and struck, rsp's
+//! pin climbing. `mov rbp, rsp` and `sub rsp` walked: the frame; its roles
+//! (the way back named) and spans, a `column` each, the panels' tags last
+//! (`frame up`). Then the registers built over it a row at a time, their
+//! tag last. The text stands beside on the left, in the program column,
+//! over the code.
//!
//! What a beat has not reached yet is under the page (`Cover`, and the
//! stack's own `reveal`), lifted as the beat says it: the context's panels
@@ -99,36 +104,30 @@ fn run(s: *anim.Frame, v: anim.Value, frames: f32) void {
fn frame(s: *anim.Frame) void {
const rec = canim.open(recordings.intro);
const reverse = rec.call("reverse", 0);
- // Chapter I's moment: reverse's first instruction, `push rbp`; then `mov rbp, rsp` and `sub rsp, 0x20`.
+ // Chapter I's moment: reverse's first instruction, `push rbp`; then `mov rbp, rsp` and `sub rsp, 0x18`.
const moment = reverse.enter;
const framed = moment + 3;
var at = canim.cursor(s, rec, moment);
at.journey(.moment, framed);
- at.levels = .{ .fire = .disasm, .source_rows = 14 };
+ at.levels = .{ .fire = .disasm, .source_rows = 14, .introduction = true };
var split = canim.layout.split.none;
split.backtrace.h = 0;
const ctx = canim.context(s, at, .{ .split = split });
- // Sixteen slots and the headroom under the registers' box (the words
- // become them where they stand), not the column's rest.
+ const g = layout(ctx.stage, rec, moment);
+ const sb = g.stack;
const rb = ctx.stage.first.registers;
- ctx.stage.first.stack.h = canim.layout.panelH(18);
- ctx.stage.first.stack.y = rb.y + rb.h + canim.theme.canvas.row_gap;
- const sb = ctx.stage.first.stack;
- const rsp = rec.register(moment, "rsp");
- // The window has two `free` words over rsp; rows from the panel's tag and padding.
- const first = rsp - 16;
- const top = sb.y + tag + pad;
+ const rsp = g.rsp;
+ const first = g.first;
+ const top = g.top;
const slots = canim.layout.rowsIn(sb.h);
- const rowY = struct {
- fn y(t0: f32, from: u64, addr: u64) f32 {
- return t0 + row * @as(f32, @floatFromInt(@as(i64, @bitCast(addr -% from)) >> 3));
- }
- }.y;
+ // The window held where it is, four `free` words over rsp: the push and `sub rsp` fill them.
+ hold(s, ctx.stage, moment);
// The panels and the page over what they have not said yet, first: chapter I's
// picture, the words gliding into the stack among them, draws over them.
// The stack, its offsets, roles and spans under the page until their beats.
- const reveal: canim.Stack.Reveal = .{ .offsets = s.value(-1), .roles = s.value(-1), .spans = s.value(-1) };
+ // (Rows 4 f apart: the offsets come down while the convention is read.)
+ const reveal: canim.Stack.Reveal = .{ .offsets = s.value(-1), .roles = s.value(-1), .spans = s.value(-1), .apart = 4 };
const stack = canim.add(s, canim.Stack{ .cursor = ctx.cursor, .stage = ctx.stage, .reveal = reveal });
// The registers, under the page: rbp's and rsp's rows (the scene's two, the first two), the rest, the chrome.
s.play(.{ctx.registers.fadeIn()}, .{ .seconds = 0 });
@@ -137,10 +136,13 @@ fn frame(s: *anim.Frame) void {
// (From the third row on 2 higher: the rule over the folded rows goes with them.)
regs_rows[k] = cover(s, .{ .x = rb.x + 2, .y = rb.y + tag + pad + row * @as(f32, @floatFromInt(k)) - @as(f32, if (k >= 2) 2 else 0), .w = rb.w - 4, .h = row + @as(f32, if (k >= 2) 2 else 0) });
const regs_chrome = chrome(s, rb, false);
- // The pins' lane under the free words: rsp's row's lifted with rsp, the rest with rbp.
+ // The pins' lane: rsp's row's lifted with rsp, the rest (rbp's pin) with the push.
var lane: [32]?anim.Obj = @splat(null);
- for (2..@min(slots, 32)) |k| lane[k] = cover(s, .{ .x = sb.x + 2, .y = top + row * @as(f32, @floatFromInt(k)), .w = 116, .h = row });
+ const rsp_row: usize = held_free;
+ for (0..@min(slots, 32)) |k| lane[k] = cover(s, .{ .x = sb.x + 2, .y = top + row * @as(f32, @floatFromInt(k)), .w = canim.theme.metric.slot.lane_end - 2, .h = row });
const stack_chrome = chrome(s, sb, true);
+ // Reverse's first rows, the disassembly under main's: its rows with the push, its tag and strip last.
+ const disasm_chrome = chrome(s, ctx.stage.first.disasm, true);
// Chapter I's last picture: the address space, the words with their chains, the link standing.
const space = s.new(canim.Segments.init(s, rec, moment));
@@ -152,69 +154,92 @@ fn frame(s: *anim.Frame) void {
set(s, space.whole, 999);
for (space.rides) |v| set(s, v, 999);
for ([_]anim.Value{ dump.in, dump.ink, dump.chains }) |v| set(s, v, 999);
- set(s, dump.regroup, 386);
+ set(s, dump.regroup, canim.regroup.regroup_frames);
set(s, dump.left, 24);
const objs = .{ place(s, space), place(s, dump), place(s, tie) };
inline for (objs) |o| s.play(.{o.fadeIn()}, .{ .seconds = 0 });
- // main's rows, in the program column under II2's text; the aim joins them to the word.
- const rsp_after = rec.register(moment + 1, "rsp");
- const back_y = rowY(top, rsp_after - 16, rsp);
- const main_rows = s.new(canim.descent.Caller{ .rec = rec, .at = moment, .call = rec.register(moment - 1, "rip"), .box = .{ .x = canim.theme.layout.program.x, .y = back_y + row / 2 + 176, .w = canim.theme.layout.program.w, .h = 4 * row }, .in = s.value(-1), .faint = s.value(0) });
+ // main's rows, in the program column over reverse's; the aim joins them to the word.
+ const back_y = rowY(top, first, rsp);
+ const main_rows = s.new(canim.descent.Caller{ .rec = rec, .at = moment, .call = rec.register(moment - 1, "rip"), .box = g.caller, .in = s.value(-1), .faint = s.value(0) });
s.play(.{place(s, main_rows).fadeIn()}, .{ .seconds = 0 });
const main_word: canim.Rect = .{ .x = sb.x + canim.theme.metric.slot.address + 12 * 12 + canim.theme.metric.context.arrow_w, .y = back_y, .w = @as(f32, @floatFromInt(canim.ui.digits(rec.register(moment - 1, "rip") + 5))) * 12, .h = row };
const word_frame = place(s, s.new(Read{ .box = main_word }));
- const joins = ctx.ties(s);
+ // The relations, and rsp's link to its word as II2 names it.
+ const joins, const rsp_link = ctx.tiesWith(s, "rsp", 1.0);
s.play(.{joins.fadeIn()}, .{ .seconds = 0 });
var asides: canim.Asides = .{};
const left = canim.theme.canvas.margin_x;
// II1: the address space and the link fade (18 f); the words glide into
- // the stack's rows (36 f) and become the panel (12 f).
+ // the stack's rows (36 f) and become the panel (12 f). Where it first
+ // stands, its convention said, unlike the bar's: the offsets come down
+ // its rows (a column, 4 f apart), growing as the addresses do.
s.wait(t.beat);
s.play(.{ objs[0].fadeOut(), objs[2].fadeOut() }, .{ .seconds = f(18), .ease = anim.ease.linear });
s.play(.{dump.become.to(1)}, .{ .seconds = f(36), .ease = anim.ease.linear });
s.play(.{ stack.fadeIn(), objs[1].fadeOut() }, .{ .seconds = f(12), .ease = anim.ease.linear });
- asides.say(s, "`rsp` holds the address of the top of the stack. A push moves it down a word.", left, rowY(top, first, rsp) + row / 2);
- // rsp's row arrives over the stack (12 f), then its pin lands on the top word (12 f).
- lift(s, &.{regs_rows[1]}, 0, 12);
- lift(s, &.{lane[2]}, 0, 12);
+ asides.say(s, texts[0], left, rowY(top, first, first) + row / 2);
+ const column = reveal.apart * @as(f32, @floatFromInt(slots)) + 12;
+ run(s, reveal.offsets, column);
+ s.wait(t.beat);
+
+ // II2: rsp's and rbp's rows arrive over the stack (12 f), rsp's pin lands on the top word (12 f),
+ // then rsp's link from its row down to the word, held, drawn back.
+ asides.say(s, texts[1], left, back_y + row / 2);
+ lift(s, &.{ regs_rows[0], regs_rows[1] }, 0, 12);
+ lift(s, &.{lane[rsp_row]}, 0, 12);
+ rsp_link.play(s);
+ s.wait(rsp_link.total());
s.wait(f(18));
- at.walk(s, .moment, moment + 1);
s.wait(t.beat);
- // II2: the way back main left, framed; main's rows; the aim; the offsets, a column.
- asides.say(s, "A call pushes the address to come back to: here, `main+50`.", left, back_y + row / 2);
+ // II3: the call, first: the way back main left, framed; main's rows; the aim drawn to its row.
+ asides.say(s, texts[2], left, back_y + row / 2);
s.play(.{word_frame.fadeIn()}, .{ .seconds = f(6), .ease = anim.ease.linear });
s.wait(f(12));
run(s, main_rows.in, 12 + 2 * 2 + 12);
s.wait(f(6));
- at.aim(s, .standing);
- s.wait(f(30));
- run(s, reveal.offsets, 2 * @as(f32, @floatFromInt(slots)) + 12);
+ at.aim(s, .drawn);
+ s.wait(f(24 + 30));
s.wait(t.beat);
- // II3: rbp's row and its pin; the frame made (`mov rbp, rsp`, `sub rsp`); its roles, spans, and the tag last.
- const rsp_framed = rec.register(framed, "rsp");
- const span_y = (rowY(top, rsp_framed - 16, rsp_framed) + rowY(top, rsp_framed - 16, rsp + 8)) / 2;
- asides.say(s, "A function's words are its frame: the saved rbp, its locals, the way back.", left, span_y);
- at.aim(s, .off);
+ // II4: the push: reverse's first rows under main's, rbp's pin; `push rbp` walked
+ // (its row fires, the touch to the word, rbp's value carried there and struck, rsp's pin climbing).
+ asides.say(s, texts[3], left, rowY(top, first, rsp - 8) + row / 2);
+ at.aim(s, .standing);
s.play(.{ word_frame.fadeOut(), main_rows.faint.to(1) }, .{ .seconds = f(18), .ease = anim.ease.linear });
- lift(s, &.{regs_rows[0]}, 0, 12);
- lift(s, lane[3..], 2, 12);
+ s.play(.{ctx.disasm.fadeIn()}, .{ .seconds = f(12), .ease = anim.ease.linear });
+ var lanes: [32]?anim.Obj = lane;
+ lanes[rsp_row] = null;
+ lift(s, &lanes, 0, 12);
s.wait(f(12));
+ at.levels.carry = .after_touch;
+ at.walk(s, .moment, moment + 1);
+ at.levels.carry = .off;
+ s.wait(t.beat);
+
+ // II5: the frame made (`mov rbp, rsp`, `sub rsp`); its roles, spans, and the tags last.
+ asides.say(s, texts[4], left, g.span_y);
+ at.aim(s, .off);
at.walk(s, .moment, moment + 2);
at.walk(s, .moment, framed);
- run(s, reveal.roles, 2 * @as(f32, @floatFromInt(slots)) + 12);
- run(s, reveal.spans, 2 * 4 + 12);
+ run(s, reveal.roles, column);
+ run(s, reveal.spans, reveal.apart * 4 + 12);
s.wait(t.beat);
- // `frame up`: its rules (12 f), then its tag and strip (12 f).
+ // `frame up`: the rules (12 f), then the tags and strips (12 f).
+ const at_rules = s.cursor;
+ lift(s, disasm_chrome[1..4], 0, 12);
+ s.cursor = at_rules;
lift(s, stack_chrome[1..4], 0, 12);
+ const at_tags = s.cursor;
+ lift(s, &.{ disasm_chrome[0], disasm_chrome[4] }, 0, 12);
+ s.cursor = at_tags;
lift(s, &.{ stack_chrome[0], stack_chrome[4] }, 0, 12);
s.wait(t.beat);
- // II4: the registers built over the stack, a row at a time, their tag last.
- asides.say(s, "The registers are the other place values live: seventeen of them.", left, rb.y + tag + pad + row * 2.5);
+ // II6: the registers built over the stack, a row at a time, their tag last.
+ asides.say(s, texts[5], left, g.registers_y);
lift(s, regs_rows[2..], 12, 12);
lift(s, regs_chrome[1..4], 0, 12);
lift(s, &.{regs_chrome[0]}, 0, 12);
@@ -222,3 +247,46 @@ fn frame(s: *anim.Frame) void {
s.wait(@max(asides.read_by - s.cursor, 0));
s.wait(t.before_cut);
}
+
+/// The chapter's texts, in order (chapter III opens on the last two).
+pub const texts = [_][]const u8{
+ "Here lower addresses are drawn higher: down a word is up a row.",
+ "`rsp` holds the address of the top of the stack.",
+ "A call pushes the address to come back to: here, `main+50`.",
+ "A push moves `rsp` down a word and stores there: `push rbp` keeps the caller's `rbp`.",
+ "`rbp` marks the frame's base. A function's words are its frame: the saved rbp, its locals, the way back.",
+ "The registers are the other place values live: seventeen of them.",
+};
+
+/// Free words over rsp in the held window.
+pub const held_free = 4;
+
+/// The stack's window held from the first frame (no scroll to it), `held_free` words over rsp at `moment`.
+pub fn hold(s: *anim.Frame, stage: *canim.Stage, moment: u64) void {
+ s.play(.{ stage.hold.to(@floatFromInt(moment)), stage.hold_free.to(held_free), stage.hold_in.to(1) }, .{ .seconds = 0 });
+}
+
+/// Where the chapter's parts stand (chapter III opens on its last picture,
+/// laid out the same): the stack under the registers, its window from
+/// `first` (four free words over rsp), its rows from `top`; main's rows
+/// in the program column level with the lower stack, reverse's under them.
+pub fn layout(stage: *canim.Stage, rec: *canim.Recording, moment: u64) struct { stack: canim.Rect, rsp: u64, first: u64, top: f32, caller: canim.Rect, span_y: f32, registers_y: f32 } {
+ const rb = stage.first.registers;
+ // Sixteen slots and the headroom under the registers' box (the words
+ // become them where they stand), not the column's rest.
+ stage.first.stack.h = canim.layout.panelH(16 + held_free);
+ stage.first.stack.y = rb.y + rb.h + canim.theme.canvas.row_gap;
+ const sb = stage.first.stack;
+ const rsp = rec.register(moment, "rsp");
+ const first = rsp - 8 * held_free;
+ const top = sb.y + tag + pad;
+ const caller: canim.Rect = .{ .x = canim.theme.layout.program.x, .y = rowY(top, first, rsp) + row / 2 + 152, .w = canim.theme.layout.program.w, .h = 4 * row };
+ // Seven rows: reverse's from its first, which none of the chapter's steps scrolls away.
+ stage.first.disasm = .{ .x = caller.x, .y = caller.y + caller.h + canim.theme.canvas.row_gap, .w = caller.w, .h = canim.layout.panelH(7) };
+ const rsp_framed = rec.register(moment + 3, "rsp");
+ return .{ .stack = sb, .rsp = rsp, .first = first, .top = top, .caller = caller, .span_y = (rowY(top, first, rsp_framed) + rowY(top, first, rsp + 8)) / 2, .registers_y = rb.y + tag + pad + row * 2.5 };
+}
+
+fn rowY(t0: f32, from: u64, addr: u64) f32 {
+ return t0 + row * @as(f32, @floatFromInt(@as(i64, @bitCast(addr -% from)) >> 3));
+}