Skip to content

fix(installer): stage the branded dmg background at the window's point size (#322) - #323

Merged
turinglambdaai merged 1 commit into
mainfrom
fix/dmg-background-resample
Oct 25, 2026
Merged

turinglambdaai merged 1 commit into
mainfrom
fix/dmg-background-resample

Conversation

@turinglambdaai

Copy link
Copy Markdown
Owner

Summary

Fixes #322. Finder no longer scales the icon-view backdrop: it draws the PNG 1:1 at native pixel size, so the family convention of authoring 2x artwork (1320x800 for the 660x400 window) rendered only the top-left quarter of the image — reproduced and confirmed by the Fulcrum install (fulcrum#92 fixed it product-side).

  • create-branded-macos-dmg! now resamples the staged .background/background.png to the window's point size (660x400) via sips -z whenever its pixel size differs, and re-reads the result to verify.
  • The live DMG test gates the staged dimensions at exactly 660x400 (fulcrum added the same product-side gate).
  • raster-pixel-size (sips-based reader) is exported via test-support and unit-tested on macOS.
  • docs/configuration.md no longer claims Finder scales the backdrop; it documents the 2x authoring convention, the aspect requirement, and the title-bar / icon-label safe zones.

Validation

  • raco test rivet/tests/macos-installer.rkt: 18 passed locally, including a full live branded DMG build whose mounted background measured exactly 660x400 from a 1x1 source.
  • raco test rivet/ rivet-cli/: 10204 passed.

…t size

Current Finder draws the icon-view backdrop 1:1 at its native pixel size
and never scales it to the window, so a 2x (1320x800) artwork rendered
only its top-left quarter (issue #322). The packager now resamples the
staged copy to the window's 660x400 point size with sips and verifies the
result; products keep authoring 2x artwork for sharpness. The live DMG
test gates the staged dimensions, and configuration.md documents the real
behavior plus the title-bar and icon-label safe zones.
@turinglambdaai
turinglambdaai merged commit 74c451e into main Oct 25, 2026
23 checks passed
@turinglambdaai
turinglambdaai deleted the fix/dmg-background-resample branch October 25, 2026 03:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

branded DMG: Finder no longer scales the backdrop — 2x artwork renders cropped; stage a window-sized background instead

1 participant