agentcut 0.2.6 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -36,7 +36,7 @@ export const DEVICE_FINISHES: Record<string, string> = {
36
36
  starlight: "#d9cdb6",
37
37
  "space-gray": "#6f7174",
38
38
  // The deep anodised black of the current MacBook Pro (matched to a reference model).
39
- "space-black": "#565457",
39
+ "space-black": "#3d3c40",
40
40
  // Colour iPhone finishes (iphone-color), most with calibrated logo tints in iphone-model.ts.
41
41
  lavender: "#c5a4df",
42
42
  "mist-blue": "#829dce",
@@ -246,29 +246,33 @@ function createLogoGeometry(width: number) {
246
246
  function createMaterials(finishColor: THREE.ColorRepresentation) {
247
247
  const finish = new THREE.Color(finishColor);
248
248
  const { l: lightness } = finish.getHSL({ h: 0, s: 0, l: 0 });
249
- const isDark = lightness < 0.35;
249
+ // Space black and darker finishes count as dark.
250
+ const isDark = lightness < 0.4;
250
251
  return {
251
252
  // Bead-blasted anodised aluminium: soft, wide highlights, the finish's own colour in the shadows.
253
+ // Dark finishes (space black) reflect much less of the studio, like real dark anodising: otherwise a
254
+ // low camera facing the deck sees the bright environment and the black washes out to light grey.
252
255
  aluminum: new THREE.MeshPhysicalMaterial({
253
256
  color: finish,
254
- metalness: 0.85,
255
- roughness: 0.34,
256
- clearcoat: 0.18,
257
+ metalness: isDark ? 0.55 : 0.85,
258
+ roughness: isDark ? 0.48 : 0.34,
259
+ clearcoat: isDark ? 0.04 : 0.18,
257
260
  clearcoatRoughness: 0.4,
258
- envMapIntensity: 0.75,
261
+ envMapIntensity: isDark ? 0.3 : 0.75,
259
262
  }),
260
263
  edge: new THREE.MeshPhysicalMaterial({
261
264
  color: finish.clone().lerp(new THREE.Color(0xffffff), isDark ? 0.08 : 0.2),
262
- metalness: 1,
263
- roughness: 0.22,
265
+ metalness: isDark ? 0.85 : 1,
266
+ roughness: isDark ? 0.3 : 0.22,
267
+ envMapIntensity: isDark ? 0.55 : 1,
264
268
  }),
265
269
  trackpad: new THREE.MeshPhysicalMaterial({
266
- color: finish.clone().lerp(new THREE.Color(0x000000), 0.06),
267
- metalness: 0.5,
268
- roughness: 0.28,
269
- clearcoat: 0.6,
270
+ color: finish.clone().lerp(new THREE.Color(0x000000), isDark ? 0.12 : 0.06),
271
+ metalness: isDark ? 0.4 : 0.5,
272
+ roughness: isDark ? 0.36 : 0.28,
273
+ clearcoat: isDark ? 0.25 : 0.6,
270
274
  clearcoatRoughness: 0.18,
271
- envMapIntensity: 0.6,
275
+ envMapIntensity: isDark ? 0.28 : 0.6,
272
276
  }),
273
277
  well: new THREE.MeshStandardMaterial({
274
278
  color: 0x050506,
@@ -40,7 +40,7 @@ narrower moves).
40
40
  tilt small (5–20) with some `turn` and `roll`.
41
41
  - `fov`: 15–25 flat telephoto (default 24, product look), 35 natural, 50–70 dramatic close-ups.
42
42
  - `focus`: a world point `[x, y, z]` (put it ON the thing that matters) or px toward the camera from
43
- the target. `aperture`: 0 none, 0.4 subtle, 1 strong, 2 macro. Focus and aperture animate: a rack
43
+ the target. `aperture`: 0 none, 0.4 subtle, 1 strong, 2.5–4 macro (see Macro focus), 6+ a razor line. Focus and aperture animate: a rack
44
44
  focus is two keys with different `focus` points.
45
45
  - `shiftX`, `shiftY`: move the subject off-center (fractions of the frame) to leave room for a title.
46
46
  - `float` 0–1: handheld drift (0.3–0.6 on holds keeps them alive). `motionBlur` 0–1: blur on fast moves.
@@ -126,6 +126,7 @@ narrower moves).
126
126
  | Hero push | same angle, zoom +15–25 % over the shot, `inOut`, `float 0.4` |
127
127
  | Rack focus | camera still or drifting; `focus` from region A to B over 20–30 f, `aperture 0.9–1.3` |
128
128
  | Lift-out | `Device3D` `lifts` (or `Lift` on a flat Screen) z 0→80–140, scale →1.08, `back` or `expo`, focus moves to the lift |
129
+ | Macro focus | see "Macro focus" below: a flat screen seen at a grazing angle, one line sharp, everything else melted; slow drift only |
129
130
  | Push to detail | zoom 1→2.2–3 on a hero region (`x, y` = its world center), aperture up as you go in |
130
131
  | Fly-over | low `tilt 55–65`, camera `y` travels down the page, `fov 35`, long screenshot with `scroll` |
131
132
  | Orbit | `Device3D` iPhone: camera `turn` −35 → +25, `tilt` 5–12, `fov 28–32`, a dark backdrop with a glow behind |
@@ -146,6 +147,27 @@ Find the brand colours first (logo, UI, website) and build the palette from them
146
147
  and type, not only in camera moves: write the rotation in the shot list, and check notes.md for what
147
148
  the last take used.
148
149
 
150
+ ## Macro focus (an occasional signature shot)
151
+
152
+ The extreme close-up where the camera skims the screen, one line of UI is crisp and everything in front
153
+ and behind melts into blur (the look of a macro lens). Use it **once or twice per film at most**, for a
154
+ detail worth savouring: a key number, a headline, a list. It is not the default framing.
155
+
156
+ - **Keep the screen flat** (no `tilt` on the Screen/Group) and get the angle from the **camera**:
157
+ `tilt 60–70`, `turn ±15–30`, `roll ±10–20`, `fov 30–36`, `zoom 2.5–3.2`, `aperture 2.5–4`
158
+ (6+ shrinks the sharp band to a line, only for a brief accent).
159
+ - **Focus on the surface:** `x, y` and `focus: [x, y, 0]` = the world point of the hero line on the flat
160
+ screen (measure it from the screenshot like a hero region). With a tilted screen a point `[x, y, 0]` is
161
+ off the surface and nothing comes out sharp.
162
+ - **The sharp area is a band, not a dot:** real depth of field is a slice across the surface at one
163
+ distance. Aim the band along the line of text you want (turn/roll set its direction). **Never** cut a
164
+ plane into tiles or stack copies to fake a focus point: the blurred tiles leave a visible grid.
165
+ - **Move slowly.** A macro shot is a slow, almost still drift: over 3–5 s, the camera's `x`/`y` travel at
166
+ most 60–120 world px and its angles at most 3–5°, with `inOut` or `linear` keys (no `expo`, `back`
167
+ or `whip`), `float 0.2–0.4`, no motion blur. Optionally a slow rack: `focus` slides 80–200 px along the
168
+ line over the whole shot. Fast moves at this magnification look like a glitch, not a lens.
169
+ - Cut into and out of it on a calm beat; the shots around it should be wider so the close-up lands.
170
+
149
171
  ## Taste rules
150
172
 
151
173
  - **The hero is always sharp.** Put `focus` on it; blur is for what's around it. Never blur text the