summaryrefslogtreecommitdiff
path: root/design/motion.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-11 22:10:47 -0300
committerGabriel Schneider <[email protected]>2026-11-11 23:46:02 -0300
commit9c0696447dbc5cf37e56aee562c7ebba4f4d4e6b (patch)
tree720b15eeee82900a50dc2f5712c8ed364638aa5d /design/motion.md
parent479d4914ecd8c7bfea68f9357ace1a4a6d0006ab (diff)
downloadcomputeranim-9c0696447dbc5cf37e56aee562c7ebba4f4d4e6b.tar.gz
computeranim-9c0696447dbc5cf37e56aee562c7ebba4f4d4e6b.zip
design: aim, a word holding a code address joined to its row; relations as one data model
From the user. aim joins a value on screen that is a code address (a return address, a function pointer, a GOT slot) to its row in the disassembly, off unless the scene's author turns it on; when the word is overwritten the head glides to the new row, or frays when it no longer points at code. Every relation is now one model, as data: tables per frame of places, values that may be addresses and the step's events; the kinds as one table of their joins, knobs, priority, ink, route and timing; a resolver of six passes over those tables, one budget, and no kind drawn because the budget has room. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNCKgYCGiANnEwcEQxa
Diffstat (limited to 'design/motion.md')
-rw-r--r--design/motion.md32
1 files changed, 19 insertions, 13 deletions
diff --git a/design/motion.md b/design/motion.md
index d026ffe..9a01afb 100644
--- a/design/motion.md
+++ b/design/motion.md
@@ -1402,11 +1402,16 @@ read by its fields (plain: `i`, `buf`, the saved rbp, the return address;
ASan: the fake frame's header, `buf`, its redzone, each row's shadow byte
beside it); each run's registers folded to the rows the loop moves.
*The column's panes* (A10 to A13): plain's source, 3 lines (3 to 5); plain's
-disassembly, 10 rows, the loop's turn; plain's frame as bytes, `rest` (13
-rows: `i`'s word, `buf`'s two, the saved rbp, the return address, then
-main's frame, which only the floor holds). On the shelf: `ASan · stopped:
-stack-buffer-overflow, WRITE of size 1` (its report's first line on the tag)
-and plain's registers (`rax` the turn's `i`).
+disassembly as a [descent](README.md#descent), so that the place the return
+address names is on screen: main's window (its `call fill` waiting, ringed;
+the row after it, `401134 main+20`; one more) over `fill`'s window whole, 13
+rows from `401140` to its `ret`; plain's frame as bytes, `rest` (`i`'s word,
+`buf`'s two, the saved rbp, the return address, then main's frame, which only
+the floor holds). On the shelf: `ASan · stopped: stack-buffer-overflow, WRITE
+of size 1` (its report's first line on the tag) and plain's registers (`rax`
+the turn's `i`). The scene turns `aim = .standing` on for these four beats
+(the knob is off everywhere else): the return address's field aims at the row
+it names, and the overflow is seen to break it.
| | Form · text | Level (column) | The step, and what plays | Text (characters) | Lands | Fires | Leaves |
| --- | --- | --- | --- | --- | --- | --- | --- |
@@ -1420,14 +1425,14 @@ and plain's registers (`rax` the turn's `i`).
| A8 | pair · below | | i = 16, they part: the chart below (mock 28) | i = 16, one past buf: plain writes an A into the saved rbp; ASan reads f3, a redzone. (85) | 2768 | 2828 | 3164 |
| A9 | pair · below | | ASan's partial check and its call walked; its run stops: its registers give way to its stderr, the report's lines, the three the text names framed | ASan does not store: it calls its report, which names buf and the write. (72) | 3182 | 3242 | 3532 |
| | | | 3550 to 3646, into the column (README, column, "Mixing them"): the text leaves; ASan's side folds to one tag on the shelf, its report's first line on it; plain's panes glide left and its frame's bytes open to the column's height | | | | |
-| A10 | column · beside | the saved rbp's row | i = 17 to 20, each walked as a store (the chart below, 96 f): a letter a turn crossing the saved rbp's bytes, its reading changing with them | Plain goes on alone, an A a turn, into the saved rbp. (53) | 3646 | 3706 | 4126 |
-| A11 | column · beside | the saved rbp's row (A10's glides up) | i = 21 to 23, walked: the saved rbp all letters, `0x4141414141414141`, `differs` gone with ASan folded | The saved rbp fills: 4141414141414141, no longer an address. (60) | 4144 | 4204 | 4528 |
-| A12 | column · beside | the return address's row, a row lower | i = 24, walked: the first struck, `34` to `41`; the reading `→ 401134 main+20` crossfades to `→ 401141 fill+1`, still code's ink | i = 24, the return address: it reads fill+1, still code. (56) | 4546 | 4606 | 4837 |
-| A13 | column · beside | the return address's row | i = 25 and 26, walked: `→ 404141` in data's ink, no name; then `0x414141`, the arrow and the ink gone, a number | Each turn makes it stranger: 404141 is data, 414141 is nowhere. (63) | 4855 | 4915 | 5172 |
+| A10 | column · beside; `aim = .standing` | the saved rbp's row | once its bubble has arrived (3664 to 3682) the aim draws from the return address's field up the gutter's left lane to main's `401134` row, standing at 60%, the row's address framed; then i = 17 to 20, each walked as a store (the chart below, 96 f): a letter a turn crossing the saved rbp's bytes, its reading changing with them; the aim holds | Plain goes on alone, an A a turn, into the saved rbp. (53) | 3646 | 3706 | 4126 |
+| A11 | column · beside | the saved rbp's row (A10's glides up) | i = 21 to 23, walked: the saved rbp all letters, `0x4141414141414141`, `differs` gone with ASan folded; the aim still holds: the return address is untouched | The saved rbp fills: 4141414141414141, no longer an address. (60) | 4144 | 4204 | 4528 |
+| A12 | column · beside; the beat's `emphasis = .aim` | the return address's row, a row lower | i = 24, walked: the touch to the field, the first byte struck, `34` to `41`; the reading `→ 401134 main+20` crossfades to `→ 401141 fill+1`, still code's ink (36 to 48); then the aim, full ink, leaves main's row and glides up the lane to `fill`'s second row, `401141` (54 to 78; this store's step 108 f), its address framed as it lands: the way back now leads into `fill` again | i = 24, the return address: it reads fill+1, still code. (56) | 4546 | 4606 | 4837 |
+| A13 | column · beside | the return address's row | i = 25, walked: `→ 404141` in data's ink, no name: no longer code, the aim **frays** (dashed 12 f, out 18 f, from 54); i = 26: `0x414141`, the arrow and the ink gone, a number; nothing aims | Each turn makes it stranger: 404141 is data, 414141 is nowhere. (63) | 4855 | 4915 | 5172 |
| | | | 5190 to 5286, back to the pair: the bubbles leave together; plain's panes glide back to their side; ASan's side unfolds from the shelf, stopped on its report, as it was | | | | |
| A14 | pair · below | | i = 27, walked: its store struck, the reading `0x41414141`; then the held rest, 5442 to 5736 (4.9 s): the half-written word, the struck byte solid, the plaque on the store, ASan standing on its report. The scene's poster, mock 38 | Half written: 41414141, no longer an address. On the right, ASan stopped at the first byte past buf. (100) | 5286 | 5346 | 5736 |
| A15 | pair · below | | i = 28 to 31, walked, 96 f each: `0x4141414141` to `0x4141414141414141` | Four more turns: the last A lands, and it reads 4141414141414141. (65) | 5754 | 5814 | 6234 |
-| A16 | pair · below | | the loop's exit, `pop rbp` (rsp's pin falls, rbp's flies to `4141414141414141`, off every window: a stub), `ret` (the touch to the return address, read; the fault: the `fault` mark on its row, hazard bands round an ink plaque, `SIGSEGV`; rip stays) | The loop ends: pop rbp, then ret to 4141414141414141: the CPU faults. SIGSEGV. (78) | 6252 | 6312 | 6623 |
+| A16 | pair · below | | the loop's exit, `pop rbp` (rsp's pin falls, rbp's flies to `4141414141414141`, off every window: a stub), `ret` (the touch to the return address, read; nothing aims, there is no row to go to; the fault: the `fault` mark on its row, hazard bands round an ink plaque, `SIGSEGV`; rip stays) | The loop ends: pop rbp, then ret to 4141414141414141: the CPU faults. SIGSEGV. (78) | 6252 | 6312 | 6623 |
The cut at 6743, 112.4 s, after 2 s on the two last pictures: a fault on
the left, a report on the right. The scene's poster (the thumbnail, the
@@ -1508,8 +1513,9 @@ address space, a tall subject (the bar is the column's height, to scale), its
bubbles level with each end as it is enlarged, so the chapter goes down the
address space with them, while the bytes wait on the shelf; the working
frame again to tie the bytes to their place; in chapter II the text `beside`
-on the left, in the program column, which is empty until III, level with the
-stack's rows it speaks of; in III `above` the aligned source and code, which
+on the left, in the program column, which holds nothing else until III but
+the three rows of main the return address aims at (II2, the scene's one
+`aim`), level with the stack's rows it speaks of; in III `above` the aligned source and code, which
span both columns and read down, then `below` as the working frame assembles,
and `on` the map. Every text lands in a rest, leads its step by 60 f (120 for
a chapter's first), is up its reading time and at most 720 f, and is covered
@@ -1539,7 +1545,7 @@ The chapter's last picture, 2 s, to 3969.
| | Form · text | Panes (rows) · shelf | Level | The step, and what plays | Text (characters) | Lands | Fires | Leaves |
| --- | --- | --- | --- | --- | --- | --- | --- | --- |
| II1 | working frame, text beside on the left (the program column, empty until III) | the address space and the dump's link fade (18 f); the words become the stack panel in the state column, 16 slots, the headroom over rsp | rsp's row | rsp's row arrives over the stack, its pin landing on the top word; `reverse`'s `push rbp` replayed from the recording by instruction: the touch, the word, rsp's pin climbing onto it (README, stack) | rsp holds the address of the top of the stack. A push moves it down a word. (75) | 78 | 198 | 438 |
-| II2 | the same | the stack | the return address's row | the word `10018b0 main+80` framed; the offsets arrive (`column`), counted from the frame's base | A call pushes the address to come back to: here, main+80. (57) | 456 | 516 | 751 |
+| II2 | the same; `aim = .step` for this beat | the stack; under the bubble, in the program column, three rows of main's code arrive (a descent's head row, `main`, then `call reverse`, `10018b0`, the next): the first code on screen | the return address's row | the word `10018b0 main+80` framed (516 to 522); the three rows fade in (528 to 546); the aim draws from the word across the gutter to the row `10018b0`, the one after the call (552 to 570), its address framed; the offsets arrive (`column`, 582 to 630). The rows stay, faint, and III's disassembly opens round them | A call pushes the address to come back to: here, main+80. (57) | 456 | 516 | 751 |
| II3 | the same | the stack | the frame's span | roles (`column`), the spans, rbp's pin; the stack's tag (`frame up`) | A function's words are its frame: the saved rbp, its locals, the way back. (74) | 769 | 829 | 1126 |
| II4 | the same | the registers built over the stack, a row at a time, top down, then their tag, its legend the inks of I (mock 31) | rax's row | the build | The registers are the other place values live: seventeen of them. (65) | 1144 | 1204 | 1468 |