Edge Softener 1.0.0
===================

Turn a sprite's black outline into a coloured one.

A black outline reads as ink laid on top of the colour, which is most obvious
over painted or soft-shaded backgrounds. Selective outlining ("selout") fixes
it: each outline pixel takes a darker shade of the colour it borders. Doing
that by hand is pixel-by-pixel work. Edge Softener does the per-pixel part on a
finished PNG or sprite sheet; you keep the choices.

How to use
1. Open edge-softener.html in a desktop browser. It works offline; your PNG
   never leaves the page.
2. Drop a PNG sprite or sheet on the dashed box, or click it to choose a file.
3. Compare Original and Softened at 1x and at the zoom you choose, over a
   background colour you pick. "Changed pixels" shows in red what was touched.
4. Adjust if needed:
   - Line strength: how dark the recoloured line is (outline = fill x this).
   - Keep a darker outer rim: pixels on the silhouette stay darker, so the
     sprite still reads over any background. Untick to treat them like
     inner lines.
   - Treat as outline when darker than: the darkness threshold (0-1).
   - Keep small enclosed dark marks: eyes and dots of up to 4 px stay black.
   - Never change these colours: click a pixel in the large Original view to
     protect that exact colour; click its swatch to remove it.
5. Press Download PNG. The file is saved as NAME-softened.png.

What it leaves alone
- Dark areas that are mostly not on an edge (an iron pot, a dark cloak).
- Small enclosed dark marks such as eyes (toggle).
- Lines that are already coloured (a dark brown outline stays as it is).
- Every frame of a sheet gets the same rule, so the tool adds no
  frame-to-frame colour change of its own.

Know the limits
- PNGs with transparency. A dark colour you meant as outline but that sits
  inside a large dark area may be kept; a dark detail touching the edge may be
  recoloured. Use the exclusion list or the threshold.
- Half-transparent edge pixels can shift by one colour level when the
  browser saves the PNG.
- It recolours existing outlines; it does not add new ones.

Tested
On ten synthetic test sprites (in examples/ are three of them), including eye
dots, an iron pot, a dark cloak, an anti-aliased tree, an engraved coin, an
already-coloured outline and a four-frame sheet. In one blind side-by-side
reading against a simple "recolour all dark pixels with the average colour"
filter, Edge Softener was preferred on 9 of 10 and tied on 1, with no case
where it damaged the art. The reader was an AI model, not a person. Tested in
Chromium on Linux (file chooser, recolour count and download driven through
the real browser); other browsers are untested. Animated sheets were checked
frame by frame by script, not watched in motion.

Licence: MIT, see LICENSE.txt (covers the page and the example sprites).
Made by Goblin, a workshop run with AI and guided by a human founder. The code
was written with AI assistance. Publisher: Roaming Minds, Danish CVR 46376692.
