Skip to content

Redraw hero.png with proper alpha channel and move stage names to caption - #13

Merged
forkrul merged 1 commit into
masterfrom
claude/logo-transparency-fix-kamlrf
Aug 31, 2026
Merged

forkrul merged 1 commit into
masterfrom
claude/logo-transparency-fix-kamlrf

Conversation

@forkrul

@forkrul forkrul commented Aug 31, 2026

Copy link
Copy Markdown
Owner

Summary

Regenerate the pipeline hero image (docs/assets/hero.png) with a clean alpha channel and remove embedded text. The new image is generated from a detailed subject prompt and uses proper keying to eliminate background artifacts. Stage names are now documented in the README caption instead of painted into the image pixels.

Changes

  • docs/assets/hero.png: Replaced with a new 5-object plate (forge, anvil, tempered blade, quenching tub, whetstone) featuring:

    • Real alpha channel with 2.06% partial alpha (no opaque background remnant)
    • 5 regions matching 5 objects (clean keying with no debris)
    • No embedded lettering — stage names moved to README
    • Generated via transparent-logo skill with gemini-3-pro-image
  • docs/assets/hero-subject.txt (new): Committed the exact subject prompt used to generate the plate. Documents the precise specifications that produced the clean result (e.g., "coals glowing in orange, amber and straw yellow only … no flame, no wisp and no spark").

  • docs/assets/README.md (new): Provenance documentation explaining:

    • What each implement represents in the pipeline
    • Why lettering was removed (cannot be re-cropped, restyled, or localized; goes stale silently)
    • The generation command and keying parameters
    • Lessons from four rejected iterations and the defects they revealed
  • README.md: Updated the hero image alt text to name all five stages and added a caption below the image reading the stage names left to right.

  • CHANGELOG.md: Documented the change under Changed section.

Implementation notes

The previous hero image carried an opaque cream background above the forge and ~250 speckle regions of keying debris, plus painted text that showed only four stages long after hone became stage five. The new plate is generated deterministically from a subject prompt (recorded in hero-subject.txt) and cut with proper alpha keying. The generation command and cut parameters are documented in docs/assets/README.md for reproducibility of the process, though each run produces a different image (image models are non-deterministic).

https://claude.ai/code/session_018ND32T9ygT3PJ6A9EjGV23

The committed hero.png keyed badly. It carried an opaque cream background
remnant sitting above the forge and 250 separate speckle regions of keying
debris — 258 regions in total against 4 objects, with subject pixels bleeding
onto the canvas border. Invisible on white, obvious on any mid-tone.

It was also stale and unfixable in place: `forge anvil temper quench` was
painted into the pixels, so it still read as a four-stage pipeline after `hone`
became stage five, and painted text cannot be re-cropped, restyled or read at
favicon size.

Redrawn with the transparent-logo skill as five objects and no lettering —
coke forge, anvil, tempered blade, quenching tub, whetstone — and cut to a real
alpha channel. The stage names now live in a README caption beside the pipeline
table, where they can be edited.

Cut: 5 regions for 5 objects, 2.06% partial alpha, zero opaque key-coloured
pixels, zero border bleed, no fringe over white, mid-grey or #0d1117.

Four plates were rejected first, each for a property of the subject rather than
of the keyer: an open recess bleeding the key through its hatching, glowing
flame wisps taking the key colour and detaching, a "sword blade" arriving
without a hilt, and a narrow enclosed gap under a bridging clamp surviving the
keyer's hole test because a sliver is mostly antialiased fringe. All four are
recorded in docs/assets/README.md with the fix each one bought.

Feature: hero-image
Symbol: docs/assets/hero.png
Changelog: Redraw docs/assets/hero.png with a real alpha channel and five stages

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018ND32T9ygT3PJ6A9EjGV23
@forkrul
forkrul merged commit 3760ff9 into master Aug 31, 2026
4 checks passed
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.

2 participants