← PicsartCONTENT HISTORY

Update to Picsart

Snapshot Oct 27, 2026 · 06:06 UTC · version 2.2.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save Picsart and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "The house zoom for screen footage in a panel - its scale, ramp and timing as scene keyframes, focus clamping, the readability rule, and a planner that decides which clicks of a long recording get a push. Use when timing and keyframing zooms on a screen recording shown in a panel.",
  "included_files": [
    {
      "relative_path": "scripts/cover.py",
      "size_in_bytes": 16819
    },
    {
      "relative_path": "scripts/framing.py",
      "size_in_bytes": 7644
    },
    {
      "relative_path": "scripts/panels.py",
      "size_in_bytes": 13591
    },
    {
      "relative_path": "scripts/readability.py",
      "size_in_bytes": 7792
    },
    {
      "relative_path": "scripts/safe_zone.py",
      "size_in_bytes": 61049
    },
    {
      "relative_path": "scripts/zoom.py",
      "size_in_bytes": 15530
    },
    {
      "relative_path": "scripts/zoom_plan.py",
      "size_in_bytes": 16698
    }
  ],
  "name": "screen-recording-zoom",
  "skill_md_contents": "---\nname: screen-recording-zoom\ndescription: The house zoom for screen footage in a panel - its scale, ramp and timing as scene keyframes, focus clamping, the readability rule, and a planner that decides which clicks of a long recording get a push. Use when timing and keyframing zooms on a screen recording shown in a panel.\nmetadata:\n  imports: screen-recording-layouts\n---\n\n# Screen zoom\n\nThe panel already frames the content column at a readable size, so the zoom is a gentle push toward\nthe result, not a dive into the screen. These numbers are the house zoom:\n\n| Parameter | Value |\n|---|---|\n| Rest | the content column fills the panel width |\n| Peak | **1.33× over rest** — never more than 1.5× over rest; a result that is mostly white (a logo on a white card) gets 1.1× |\n| Ramp | **1.0 s** in; no zoom out inside a step — the next step is a new panel |\n| Zoom out | **off.** For footage that stays on one screen for minutes, where the next push is not a new panel: `zoomOut`, the ramp back to rest on the same curve, and on each focus `until`, where its hold ends and the ramp starts |\n| Text floor | **off.** `textFloor`, in frame px: the peak rises until the UI's text reads at least that tall, past 1.33× if it must, and still never crops the focus box more than the push allows |\n| Easing | **`cubic-bezier(0.16, 1, 0.3, 1)`** — fast start, long settle |\n| Start | on a `result`: **0.1 s after the measured reveal**, so the result appears, then the frame leans in. On a `click`: 0.5 s before it, so the click lands on a settled frame (`delay: -0.5`) |\n| Merge | two focus events **within 2.5 s** share one push: choose their shared peak before checking whether the pans fit in the step |\n\nReveals are measured, never estimated: take each reveal's settle time as the screen-recording-analysis skill\nsays. As keyframes on the recording layer (`t` relative to the layer, `timeMode: \"layer\"`), with\nthe trim starting 1 s before the reveal:\n\n```\nt = 0      scale = rest   position = rest framing   easing: \"linear\"   (waiting state, held)\nt = 1.1    scale = rest   position = rest framing   easing: cubic_bezier  (reveal + 0.1)\nt = 2.1    scale = peak   position = peak framing                         (terminal: no easing)\n```\n\n**Run `scripts/zoom.py` for the keyframes; never work them out.** Write the recording's size, its\npanel, the content column, the layer's length and each result to lean in on (its measured reveal\nin layer seconds, its box, its mean luma, and the card it sits in when there is one) to a file,\nand from this skill's folder run `python3 scripts/zoom.py <file>`. It prints the layer's `scale`\nand `position` keyframes with their easings, how tall the UI's text reads at rest, and any push\nit had to skip because too little of the step was left. Its docstring lists every field, and\n`options` sets the zoom out and the text floor. Leave both off when each step gets a new panel.\nThe table and the example above say what it does, for a host that cannot run it.\n\n**Easing.** Scene keyframes take the curve exactly: `easing: { kind: \"cubic_bezier\", control:\n[0.16, 1, 0.3, 1] }`. **A keyframe's easing shapes the segment that STARTS at it**, so put the curve\non the keyframe that begins each ramp, and mark the hold's opening keyframe `easing: \"linear\"`\nexplicitly — a keyframe with no easing draws a `linear_easing_by_omission` warning. The terminal\nkeyframe takes no easing (`unused_easing_on_terminal_keyframe` otherwise).\n\n**Keep the focus inside the panel.** Clamp the framing so the zoomed window stays inside the\nrecording; let the focus sit off-center rather than show the panel's empty edge. The rest and peak\nframings use the framing formula in the screen-recording-layouts skill; `zoom.py` clamps both and applies it. A peak\ncapped at or below rest keeps rest's exact scale, even when that exceeds the focus crop cap; its\nscale never falls below the minimum needed to cover the panel.\n\n**Readable beats pretty.** If UI text is unreadable in the panel, frame the panel tighter or cut\nthe step; never ship a zoom on text nobody can read — and never fix readability by zooming harder.\nThe text floor is not a fix for that: it sets how far a push leans in on a whole screen that is\nsharp but drawn small, and it is capped like any push. A still that is soft stays soft at any\npeak. The screen-recording-layouts skill's `readability.py` measures readability before the build, and the\nscreen-ui-redesign skill redraws a step that cannot be framed to read.\n\n## Planning the pushes on a long recording\n\nA builder that pushes on its own steps decides its own pushes; keep them. When you place pushes\nyourself, on footage that stays on one screen with many clicks (a screen the user edited, a\nrecording no builder covers), let `scripts/zoom_plan.py` decide which actions get one:\n\n- **Zoom to what was revealed**, not the click: the bounding box of what changed, padded.\n- **No push on a wide change**: a box wider or taller than 60% of the rest view gets none.\n- **Never past 1:1**: the push stops where the recording would draw larger than its own pixels. A\n  recording no larger than the frame has no room, and the plan says so (`would_upscale`).\n- **Actions close together share one push**, held, panning from one to the next. Drop an event\n  whose padded window cannot cover the view as `no_gain` before grouping. **Never back to\n  rest for less than 1 s**: two pushes that close become one.\n- **Lead a click** by 0.3-1.0 s, so it lands on a settled frame; follow a change by 0.1 s, as\n  above. **Hold about 1.8 s** once the last action is in frame, then **zoom out slower than in**.\n- **One knob, `intensity`**: `subtle`, `balanced` (the house numbers) or `punchy`. It sets the\n  peak, the merge gap, the lead and the ramps together. Say which one you used; the user changes\n  it in one word.\n\nFrom this skill's folder, run `python3 scripts/zoom_plan.py <file>` with the recording's size,\nthe layer's length, the `view` it rests in (its panel, or the frame) and each measured click or\nchange, as the screen-recording-analysis skill reads them. It prints the `zooms` it planned, the events it\n`dropped` with the reason, and `foci` and `options` that are `zoom.py`'s input: add the panel and\nthe content column and run `zoom.py` for the keyframes. The plan is a proposal: name its pushes\nwhen the user reviews, and a push the user drops stays dropped when you plan again.\n"
}

SHA-256 of public snapshot: c7cdb1a1f9f912c29dbef90f7f60d45e002b4e6d2dd9aa0a1a3181e90da05a60