Skip to content

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

4.4 KB
Raw Blame

Cursor refresh requirements

This file consolidates the cursor decisions from the design and implementation conversation. It is the working acceptance list for the replacement themes and their 3D models.

Replacement artwork

  • Remove the Sweezy packs because redistribution rights are unclear or insufficient.
  • Ship original OpenScreen cursor artwork as clean, transparent PNGs. Do not vectorize the generated artwork or ship SVG intermediates.
  • Preserve cursor readability and useful choices for users who liked the old pixel, character, colorful, glossy, or playful cursors.
  • Keep the range professional, attractive, and varied without copying Screen Studio or third-party packs.
  • Keep correct arrow-tip and raised-fingertip hotspots and preserve other OS cursor states through the built-in artwork.

3D option

  • Every replacement theme and supported cursor state must work with the existing 3D cursor option.
  • Every replacement arrow and hand is a real volume, modelled 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. Each pack adds style-specific volume: gloves with separate fingers, beveled voxels, flat cut-paper sheets, cushions set in the rim of their drawn outline, and a faceted glass crystal that refracts the picture under it.
  • 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 model.

Theme-specific shape and outline decisions

Theme Arrow Hand
Studio Ink Black rim, raised ivory band, recessed satin black field. Ivory glove cushion; the black outline stays as a physical rim, with black ridges between the fingers.
Prism Glow A glass crystal cut along the drawing's facets, in a thin navy rim; the picture under it shows through, refracted with a slight dispersion, privacy blurs included; the facets glow faintly in their drawn colours. Modelled from the 2D drawing alone, keeping its polygonal simplicity. The same, a crystal hand.
Pop Coral Cut paper: a coral sheet on a navy sheet, flat tops, matte; the yellow offset becomes a flat sheet behind; the click dashes become flat pieces. A yellow sheet on a navy sheet, flat tops, matte; the coral offset becomes a flat sheet behind; the coral click dashes become flat pieces.
Pixel Candy Simplified pixel art that reads at 20 px as at full size; the 3D model is one cube per pixel of the same grid as the sprite. A pixel hand from the same kind of grid: index, three knuckles, thumb.
Star Sprout Puffy mint cushion; the navy outline stays as a physical rim (a navy tray and a rounded bead) around it, the star and its leaves in front, each in its own navy rim. Puffy ivory glove in the same navy rim, with navy ridges between the fingers; separate mint cuff framed in navy; the star and leaves in front, as in star-sprout/3d-reference.png.
Glass Lens A glass lens with a defined dark outline and an outer rim of glass, after the macOS glass material: the picture under it is refracted by real shader optics (magnified by the lens, bent and slightly dispersed along its edge), in 3D and, unlike the other themes, in 2D too. The same, a glass glove with dark ridges between the fingers.

The 2D PNG may keep a drawn contour where it helps readability. Its contour must not be copied blindly onto the 3D material: decide per model whether it 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 eight sculpted models follow (Prism Glow's crystal follows its 2D drawing instead), 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.
  • README.md: source PNG and preparation workflow.

The intended deliverable is the actual in-app 3D treatment, not just these references.