Skip to content

Logo: keep the drawing as the source, generate every variant with ffmpeg - #44

Merged
zeyuyang42 merged 1 commit into
mainfrom
logo-rework
Oct 15, 2026
Merged

zeyuyang42 merged 1 commit into
mainfrom
logo-rework

Conversation

@zeyuyang42

Copy link
Copy Markdown
Collaborator

The raw charcoal-on-paper scan was the only logo in the repo, used as-is in the README and as the 105 KB picture in the Max help patches. It moves to assets/logo/zerr-logo-paper.png untouched, and tools/make-logo-variants.sh derives everything else from it with ffmpeg: black/white ink on transparent, opaque black-on-white and white-on-black, grey ink, 512–32 px sizes, a multi-size .ico, trimmed versions, disc-masked avatars, and the 256 px maxmsp/media/zerr_logo.png the help patches load (now 41 KB). assets/logo/README.md says which file is for what. The root README shows the black-ink version and switches to white ink in dark mode.

Review

  • Rerunning the script into a scratch folder reproduces all 25 generated files byte for byte, so "generated, do not hand-edit" is true.
  • Rename of the source is a 100% similarity rename; nothing else in the tree referenced the old root path. The Max help patches reference zerr_logo.png by name through the package media/ folder, which maxmsp/CMakeLists.txt already installs, so they pick up the smaller copy with no patch change.
  • .DS_Store files in the new folders are already gitignored.
  • Two nits fixed in the script: it also checks for ffprobe, which it uses, and a comment no longer points at a histogram "in the commit message".
  • Adds 6.8 MB of images to the repo, 2 MB of it the source scan.

🤖 Generated with Claude Code

The only logo in the repo was the raw charcoal-on-paper scan, used as-is in the
README and, at 105 KB, as the picture in the Max help patches. It moves to
assets/logo/zerr-logo-paper.png and stays untouched; tools/make-logo-variants.sh
derives everything else from it:

  - black/white ink on transparent, black-on-white, white-on-black, grey ink
  - 512..32 px copies of the two transparent variants, a 16..256 px .ico
  - versions trimmed to the ink bounding box, disc-masked avatars
  - maxmsp/media/zerr_logo.png, the 256 px copy the help patches load (now 41 KB)

One luminance stretch (black point 0.16, white point 0.81; paper measures
208-239, solid ink 0-63 on the 1024 px source) turns the scan into an ink mask;
every variant is that mask over a colour. The output is deterministic: rerunning
the script reproduces all 25 files byte for byte. assets/logo/README.md says
which file is for what.

The README shows the black-ink version and switches to the white-ink one in
dark mode via <picture>.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@zeyuyang42
zeyuyang42 merged commit 55e876e into main Oct 15, 2026
@zeyuyang42
zeyuyang42 deleted the logo-rework branch October 15, 2026 22:18
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.

1 participant