summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-05 14:23:41 -0300
committerGabriel Schneider <[email protected]>2026-11-05 15:28:16 -0300
commitd967b8e955e966ccffdc94607ed1de4e61dc56ef (patch)
tree4566db68f2c1ba2f9b7ac417e1eb0365e0ceed3f /src
parent3488111273764c17a42870484fabc36abb0634a1 (diff)
downloadpardes-d967b8e955e966ccffdc94607ed1de4e61dc56ef.tar.gz
pardes-d967b8e955e966ccffdc94607ed1de4e61dc56ef.zip
docs: the effects programme's documents go with it: docs/effects.md (its catalogue, its feel reviews) and docs/next-anim.md (the animation plan) are gone, and docs/render-pipeline.md says only what is left: the core's frame (the pump, its deadlines, one Surface that does not move) and what each frontend draws on its own clock from it (the glide, the window's caret, the blink, a jump's trail, InactiveDim, the Pet) and the window's four draw groups; the changelog says what left and what stayed; code comments and docs that cited the old sections or files cite the new note or nothing (building.typ, next-pdfrender.md, config.zig, gui.zig, glide.zig)
Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
Diffstat (limited to 'src')
-rw-r--r--src/CHANGELOG.md12
-rw-r--r--src/config.zig2
-rw-r--r--src/glide.zig2
-rw-r--r--src/gui/gui.zig16
4 files changed, 22 insertions, 10 deletions
diff --git a/src/CHANGELOG.md b/src/CHANGELOG.md
index 2719717b..346b5214 100644
--- a/src/CHANGELOG.md
+++ b/src/CHANGELOG.md
@@ -11,6 +11,18 @@
`-Desp32p4-cols` and `-rows`, the `Peek`, `Poke`, `Hexdump` and `Gpio`
words, and every limit and guard only the board needed; the desktop
builds keep their capacities.
+- The effects are out of the core: the panel transitions (the eleven
+ Panel words), the post chain (Crt, Bloom, Vignette, Grain, Shader,
+ ShaderAnimation and the glslc it spawned), Lift, the glows
+ (SelectionGlow, HoverGlow, Occlusion), ChipShadow, ThumbFlash, the
+ lapis ornament and Parallax (with `lapis_plain`, which lapis now is),
+ the message fall and dissolve (MessageAnimation, MessageFall,
+ MessageDissolve), the theme crossfade and Motion with its five
+ flavours; a PDF's scroll lands at once. What stays is the frontends':
+ a scroll glides (the window at the pixel, a terminal by rows) and the
+ window's caret eases, each on its own clock, and CursorBlink, JumpTrail
+ (both frontends), InactiveDim and Pet (the window's) are plain settings
+ the frontends read. docs/render-pipeline.md says what is left.
- 9P over QUIC is gone: the `-Dquic` build with its OpenSSL, `quic!`
dials for `--9p-quic` and Mount, the poll loop that served them on the
editor's thread, and their tests. Unix and TCP serve and mount sessions
diff --git a/src/config.zig b/src/config.zig
index 50748b60..9eb95cfd 100644
--- a/src/config.zig
+++ b/src/config.zig
@@ -714,7 +714,7 @@ pub const Runtime = struct {
/// Builtins announce themselves on the message row.
verbose: bool = true,
- /// The cursor blinks, a pixel shell's (docs/render-pipeline.md §5.4):
+ /// The cursor blinks, a pixel shell's (docs/render-pipeline.md):
/// solid while typing and for half a second after, eased at each edge,
/// solid again after ten idle seconds.
cursor_blink: bool = true,
diff --git a/src/glide.zig b/src/glide.zig
index 723beba9..6f8fe9a3 100644
--- a/src/glide.zig
+++ b/src/glide.zig
@@ -305,7 +305,7 @@ pub const Follow = struct {
pub const bodies_per_s: f32 = 15;
/// Inputs this close, each the way the last went, are one stream.
pub const stream_ns = 150 * std.time.ns_per_ms;
- /// The spring's natural frequency, rad/s: arrivals land inside §8.1's
+ /// The spring's natural frequency, rad/s: an arrival lands inside
/// 220 ms.
pub const omega: f32 = 51;
diff --git a/src/gui/gui.zig b/src/gui/gui.zig
index 8d69ed80..60b00f7a 100644
--- a/src/gui/gui.zig
+++ b/src/gui/gui.zig
@@ -1059,7 +1059,7 @@ const Gui = struct {
capture_pad: u32 = 0,
capture_dir: []const u8 = "",
/// PARDES_TEST_SERIES: every captured frame is kept too, numbered, for a
- /// feel review's frame series (docs/render-pipeline.md §8.4).
+ /// frame series to look at.
capture_series: bool = false,
captured: u32 = 0,
capture_tex: ?*c.SDL_GPUTexture = null,
@@ -3713,7 +3713,7 @@ fn waitInput(ctx: ?*anyopaque, timeout_ms: u32) void {
// would; otherwise a wait that ran out moves it exactly to the
// core's wake.
// Through an edge, or woken for the next: the shell redraws the last
- // frame with the new alpha, no core render (§5.5 level B).
+ // frame with the new alpha, no core render.
if (blink_ms != null and (blink.?.edge or !got)) g.blink_due = true;
if (s.test_clock) |*virtual| {
if (frontendMoving(g)) {
@@ -3769,7 +3769,7 @@ fn waitInput(ctx: ?*anyopaque, timeout_ms: u32) void {
// limiter spins: asleep between 60 Hz frames, the CPU's clock fell
// (intel_pstate, 4.9 GHz down toward 0.8) and every frame, an
// input's first among them, took 2-5x as long: input-to-present p50
- // 1.9 ms spinning against 7-8 ms asleep (docs/next-anim.md).
+ // 1.9 ms spinning against 7-8 ms asleep.
// ponytail: a core while something moves (~250 ms a scroll); a
// sleep to a millisecond short of the tick if the power matters more.
while (paced and !g.input_seen and s.held == null) {
@@ -3989,7 +3989,7 @@ fn runDemo(g: *Gui, in: *Input, core: *pardes.Pardes) void {
/// The blink now, from the frame's time since input and how long ago it
/// arrived; null where nothing blinks (off, idle, an unfocused window).
-/// The cursor's opacity under blink (§5.4): solid while typing and for
+/// The cursor's opacity under blink: solid while typing and for
/// `hold_ns` after, then on and off with an eased edge, solid again after
/// `idle_ns` of no input. `edge` says whether it is mid-edge (a frame is
/// owed), `next_ns` when the next edge starts (a wake).
@@ -7332,8 +7332,8 @@ fn softPresentFrame(g: *Gui, cmd: *c.SDL_GPUCommandBuffer, target: *c.SDL_GPUTex
defer if (frame_probe) |probe| probe.zone(.gui_upload, probe_upload);
if (!c.SDL_UpdateTexture(texture, null, mapped, @intCast(sw * bpp))) return error.GpuMap;
// PARDES_FRAMES_CAPTURE: every presented frame's pixels as they went
- // out, and when, for a recording at the frames' own times (the
- // samples of docs/next-anim.md). One write a frame; nothing else.
+ // out, and when, for a recording at the frames' own times. One write a
+ // frame; nothing else.
if (frame_capture_dir) |dir| captureSeries(dir, @as([*]const u8, @ptrCast(mapped))[0..size], sw, sh);
// The cell shader already produced premultiplied backgrounds with opaque
// foreground ink. Copy that alpha unchanged; never modulate the full frame.
@@ -7512,7 +7512,7 @@ fn bodyPixels(region: pardes.Region, layout: CellLayout) [4]f32 {
};
}
-/// The frame's decor, group by group (docs/render-pipeline.md §3.4), all of it
+/// The frame's decor, group by group (docs/render-pipeline.md), all of it
/// read from the regions and the palette: the page's rules and the panes'
/// rails, rules and grip marks with the page, notice rules with the
/// notices, bar cursors with the ink.
@@ -8222,7 +8222,7 @@ const Caret = struct {
seen: struct { owner: u8 = pardes.Region.none, line: i32 = 0, x: u16 = 0, y: u16 = 0 } = .{},
/// The default flavour's spring, as fast again as the caret follows
- /// input (§8.1: it settles in 90-150 ms).
+ /// input (it settles in 90-150 ms).
const omega: f32 = 34 * 2.4;
/// The trailing corners of a jump, a little behind the leading ones.
const follow: f32 = 0.85;