testdata/README.md

# Test fixtures — real production artifacts

These are **actual outputs captured from entropydrop.com** (via the HAR from
2026-09-13), not synthetic test images. They let you validate stage 2 against
ground truth.

| File | What it is | Verified properties |
|---|---|---|
| `ZNU125D1THWZTHE6_render.png` | stage-1 output, `SKING_DDJ_v104b`, seed 40491355 | 1024×1024 RGB |
| `ZNU125D1THWZTHE6_skin.png` | its final skin | 64×64 RGBA, alpha extrema (0,255) |
| `HQ8LSY6WVGNX6DHZ_render.png` | stage-1 output, `SKING_DDJ_v104b`, seed 22249174 | 1024×1024 RGB |
| `HQ8LSY6WVGNX6DHZ_skin.png` | its final skin | 64×64 RGBA |
| `QAX1LHF88F7ACYC1_render.png` | stage-1 output, `SKING_DDJ_v54`, seed 83963434 | 1024×1024 RGB |
| `QAX1LHF88F7ACYC1_skin.png` | its final skin | 64×64 RGBA |
| `5EEF3PRRKHFH12DC_skin_v73.png` | final skin from the `sking_v73_flux_4b_000027000` path | 64×64 RGBA |

Source URLs (all `is_public: true`):

```
https://cdn.entropydrop.com/real_to_render_intermediate/<ID>.png
https://cdn.entropydrop.com/generations/<ID>.png
```

## How to use them

Load a `*_render.png` in the **"Render → Skin (debug)"** tab and compare your
Space's output against the matching `*_skin.png`. The `v104b` pairs are the
strictest test: your Space runs the public **v104** parser, so output will be
close but not identical — differences in hair, eyes and beard are the known
weak spots. The `SKING_DDJ_v54` pair is a useful older-model reference.

A correct result is:

- exactly **64×64**, mode **RGBA**
- a non-empty alpha channel (extrema `(0, 255)`) — transparency encodes the
  outer layer, so an all-opaque result means the parser failed
- pixels aligned to the Minecraft UV grid (head at top-left 8×8 blocks, etc.)

## License and attribution

Copyright © EntropyDrop / Shanghai EqualRank Technology Co., Ltd.

Every generation record in the HAR carries
`"license": {"code": "cc-by-nc-4.0"}`, so these images are
**CC BY-NC 4.0** — attribution required, **non-commercial use only**.

That is compatible with a free public demo Space, but:

- keep the attribution in this file and in the Space README;
- do **not** use them in any monetised deployment, paid tier, or print service;
- do not relicense them.

If you would rather not carry third-party NC-licensed assets in your repo at
all, delete this directory and remove the `gr.Examples` block from the debug
tab in `app.py` — nothing else depends on it.