Skip to content

Let the icon show a shape turning into another one - #47

Merged
Veneury merged 1 commit into
mainfrom
feature/new-icon
Sep 30, 2026
Merged

Veneury merged 1 commit into
mainfrom
feature/new-icon

Conversation

@Veneury

@Veneury Veneury commented Sep 30, 2026

Copy link
Copy Markdown
Owner

The old mark was a filled rounded square and an outlined one, overlapping. It said there are two things here, a source and a destination, but nothing about what happens between them — and it was the same two shapes in the same two colours, so the eye had no reason to read one as becoming the other.

Now a square goes in, an arrow crosses, and a circle comes out. The shape itself changes, which is the whole of what the library does: one type in, another type out. It also stops competing with Mediarion's mark, which is a centre with three satellites; the two still share the navy tile and the same mint and amber, so they read as a pair without reading as the same drawing.

The icon gains a source

There was only icon.png before, drawn once and not reproducible, so changing it meant redrawing it by hand. Now icon.svg holds the geometry and tools/draw-icon.py draws the PNG from the same numbers at eight times the size, reducing with LANCZOS. That is not an SVG renderer and it is not trying to be — the numbers are written twice, and the script says so, so the two files have to be changed together.

Two things in the drawing are easy to get wrong and are written down in the script:

  • A stroke straddles its path in SVG, so an outlined circle of radius 17 with width 7 runs from radius 13.5 to 20.5. Pillow grows an outline inwards from the bounding box, so the box has to be the outer radius, not the SVG's.
  • Pillow has no round line caps. The arrow's shaft is a rounded rectangle and its head gets a disc at each open end.

Checks

Packed Mapperion and compared the icon.png inside the .nupkg against the file in the tree — same 6575 bytes, same SHA-256. Same dimensions and mode as before, 128×128 RGBA, so nothing downstream has to care.

One file feeds all six packages through PackageIcon in Directory.Build.props, and it is also the site's logo and favicon through _appLogoPath and _appFaviconPath, so regenerating it updates all three places.

NuGet keeps whatever icon a version was published with, so 0.14.0 and earlier go on showing the old mark and this one appears from the next release onwards.

The old mark was a filled rounded square and an outlined one, overlapping. It
said there are two things here, a source and a destination, but nothing about
what happens between them — and it was the same two shapes in the same two
colours, so the eye had no reason to read one as becoming the other.

Now a square goes in, an arrow crosses, and a circle comes out. The shape
itself changes, which is the whole of what the library does: one type in,
another type out. It also stops competing with Mediarion's mark, which is a
centre with three satellites; the two still share the navy tile and the same
mint and amber, so they read as a pair without reading as the same drawing.

The icon gains a source. There was only icon.png before, drawn once and not
reproducible, so changing it meant redrawing it by hand. Now icon.svg holds the
geometry and tools/draw-icon.py draws the PNG from the same numbers at eight
times the size, reducing with LANCZOS. That is not an SVG renderer and it is
not trying to be — the numbers are written twice, and the script says so, so
the two files have to be changed together.

Verified by packing Mapperion and comparing the icon.png inside the nupkg
against the file in the tree. NuGet keeps whatever icon a version was published
with, so 0.14.0 and earlier go on showing the old mark and this one appears
from the next release.
@Veneury
Veneury merged commit 94f6f50 into main Sep 30, 2026
7 checks passed
@Veneury
Veneury deleted the feature/new-icon branch September 30, 2026 22:01
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