Skip to content

Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.

docs(cursor): say Prism Glow is extruded, not sculpted

Claude54bfe3122c03
diff --git a/design/cursors/3d-direction.md b/design/cursors/3d-direction.md
index 782f0afb8..33dd399ae 100644
--- a/design/cursors/3d-direction.md
+++ b/design/cursors/3d-direction.md
@@ -2,13 +2,13 @@
`3d-concept.png` is a visual reference, not a render from OpenScreen.
-With the 3D option on, mode 15 ray-marches each original theme's arrow and hand
-as a sculpted model: signed distance functions written in the compositor's three
-shaders (HLSL, Metal, WGSL), not a PNG face or a height map.
-`crates/compositor/src/sculpt.rs` names the ten models and holds their bounding
-boxes and hotspots. The scene names the model (`"<theme>/<state>"`); text,
-resize, move and the other OS states keep their built-in art and the
-compositor's beveled extrusion.
+With the 3D option on, mode 15 ray-marches the arrow and hand of Studio Ink, Pop
+Coral, Pixel Candy and Star Sprout as sculpted models: signed distance functions
+written in the compositor's three shaders (HLSL, Metal, WGSL), not a PNG face or
+a height map. `crates/compositor/src/sculpt.rs` names the eight models and holds
+their bounding boxes and hotspots; Prism Glow has none. The scene names the
+model (`"<theme>/<state>"`); text, resize, move and the other OS states keep
+their built-in art and the compositor's beveled extrusion.
| Theme | Arrow model | Hand model |
| --- | --- | --- |
diff --git a/design/cursors/README.md b/design/cursors/README.md
index bf564c1a4..8b58dc6dd 100644
--- a/design/cursors/README.md
+++ b/design/cursors/README.md
@@ -18,11 +18,12 @@ fringe pixels, and resize them into transparent 128 × 128 PNGs under
`public/cursors/<theme>/`. It prints the normalized tip hotspots; copy them into
`src/lib/cursor/cursorThemes.ts` after changing a master.
-With the 3D option on, the compositor draws each theme's arrow and hand as a
-model sculpted in its shaders (`crates/compositor/src/sculpt.rs`), not from these
-PNGs. The theme picker and the flat cursor keep using the PNGs. Text, resize,
-move and other states remain state-accurate through the built-in art and
-receive the shared 3D extrusion.
+With the 3D option on, the compositor draws the arrow and hand of Studio Ink,
+Pop Coral, Pixel Candy and Star Sprout as models sculpted in its shaders
+(`crates/compositor/src/sculpt.rs`), not from these PNGs. Prism Glow's arrow and
+hand keep their PNGs and receive the shared 3D extrusion. The theme picker and
+the flat cursor keep using the PNGs. Text, resize, move and other states remain
+state-accurate through the built-in art and receive the shared 3D extrusion.
`contact-sheet.png` shows the sprites enlarged on a light background;
`dark-32px.png` shows them at their 32-pixel reference size on a dark background.
diff --git a/design/cursors/requirements.md b/design/cursors/requirements.md
index 992c0d7b7..5495e39c7 100644
--- a/design/cursors/requirements.md
+++ b/design/cursors/requirements.md
@@ -21,16 +21,17 @@ their 3D models.
- Every replacement theme and supported cursor state must work with the
existing 3D cursor option.
-- Every replacement arrow and hand is a real volume, sculpted in the
- compositor's shaders (`crates/compositor/src/sculpt.rs`): lighting, normals,
- self shadows and contact shadows respond to cursor tilt and rotation. A PNG
- face or a height map is not a model.
+- Every replacement arrow and hand except Prism Glow's is a real volume,
+ sculpted in the compositor's shaders (`crates/compositor/src/sculpt.rs`):
+ lighting, normals, self shadows and contact shadows respond to cursor tilt
+ and rotation. A PNG face or a height map is not a model.
- A rounded extrusion of the PNG silhouette remains the fallback for cursor
- states that do not have a dedicated theme model. The five replacement packs
- add style-specific volume: a glove with separate fingers, cut crystal facets,
- beveled voxels, and cushions set in the rim of their drawn outline.
-- Model the arrow and hand separately for every theme. Do not apply one
- contour, material, or roundness rule to all designs.
+ states that do not have a dedicated theme model, and for Prism Glow, whose
+ faceted drawing is extruded as drawn. The four sculpted packs add
+ style-specific volume: gloves with separate fingers, beveled voxels, flat
+ cut-paper sheets, and cushions set in the rim of their drawn outline.
+- Model the arrow and hand separately for every sculpted theme. Do not apply
+ one contour, material, or roundness rule to all designs.
- Preserve the cursor hotspot through hover, tilt, yaw, click, and size changes.
- Reuse the compositor's 3D lighting and contact shadows. The surface must
change with the compositor camera; a static image of a 3D render is not a
@@ -53,8 +54,8 @@ becomes an inlay, side material, separate piece, or disappears.
## Review references
- `contact-sheet.png`: 2D PNG themes.
-- `3d-concept.png`: the 3D reference sheet the ten models follow, not
- rendered by the app.
+- `3d-concept.png`: the 3D reference sheet the eight sculpted models follow
+ (Prism Glow is extruded), not rendered by the app.
- `star-sprout/3d-reference.png`: a closer view of the Star Sprout hand; also
not rendered by the app.
- `3d-direction.md`: per-theme modeling notes.
diff --git a/docs/3d-effects-v2.md b/docs/3d-effects-v2.md
index 253b65d68..41528c542 100644
--- a/docs/3d-effects-v2.md
+++ b/docs/3d-effects-v2.md
@@ -233,12 +233,12 @@ inconnues sont ignorées).
### B.2 Le réglage
**Un seul interrupteur**, `cursor.model3d` (« 3D cursor », **éteint par défaut**) : il passe
-**chaque état** du curseur en 3D. La flèche et la main des cinq thèmes d'origine deviennent leur
-modèle sculpté (B.3 bis) ; les autres états, et tous ceux du thème par défaut (les seize de
-`DEFAULT_CURSOR_SPRITES` : flèche, I, main, croix, mains ouverte et fermée, redimensionnements,
-déplacement, interdit, attente…), leur sprite extrudé. Curseur masqué, l'interrupteur est grisé et
-son info-bulle dit pourquoi. Éteint, la frame est celle d'avant **à l'octet** (vérifié à plat et
-incliné contre le commit de base).
+**chaque état** du curseur en 3D. La flèche et la main de quatre des cinq thèmes d'origine
+deviennent leur modèle sculpté (B.3 bis) ; celles de Prism Glow, les autres états, et tous ceux
+du thème par défaut (les seize de `DEFAULT_CURSOR_SPRITES` : flèche, I, main, croix, mains
+ouverte et fermée, redimensionnements, déplacement, interdit, attente…), leur sprite extrudé.
+Curseur masqué, l'interrupteur est grisé et son info-bulle dit pourquoi. Éteint, la frame est
+celle d'avant **à l'octet** (vérifié à plat et incliné contre le commit de base).
Tuyauterie : `CursorVisualSettings.model3d`, clé legacy `cursorModel3d`, préréglages (absent →
éteint), `SceneCursor.model3d` (`serde(default)`), `LiveParams.cursor_model3d`, paramètre live