# Top-panel artwork sources

The three original SVG files are from [CrazyRedMachine/PopnPanel](https://github.com/CrazyRedMachine/PopnPanel), commit `b624b919f518a17aec46203c128cfa6e1ded59d2`. They are retained unchanged so the adaptation can be regenerated. Their inclusion does not imply a new license or ownership of the original artwork.

`tools/export-artwork.py` removes construction guides, registers the source button centers to this enclosure, simplifies small details, reduces colors per segment, and intersects the resulting inlays with the actual top-panel solids. Generated meshes and previews go to `build/artwork/`.

## Additional adaptations

**Type P (Pico-derived):** `PopnPico2-original.3mf` comes from [whowechina/popn_pico](https://github.com/whowechina/popn_pico), commit `3aff670833ff4510a46aa20f253776a70f625866`, `Production/3DPrint/popn_pico2_panel.3mf`. Credit: whowechina. The author describes the project as CC-NC, free for personal/friend use and noncommercial; consult the upstream terms before redistribution or commercial use. The three bubble meshes are registered to our button spacing and expanded slightly. New black rings surround the 100 mm hardware rims.

**Type E (engraved-style):** an interpretation of [Oscar Wong’s engraved controller](https://impman.github.io/pop-n-music-controller.html), using the PopnPanel Type B bubble silhouette with black, white and gray filament. It is not converted from Oscar’s original CAD or an exact reproduction of his artwork.

`tools/prepare-extra-artwork.py` creates `Adapted-P.svg` and `Adapted-E.svg` from the vendored sources. Neither design adds lettering. Physical button colors do not count toward their filament palettes.

See [the printing guide](../docs/ARTWORK.md).

## F/H/N adaptations

- **F — Fredo-derived:** reference PNG shared by Fredo in [the Sega cabinet panel thread](https://www.arcade-projects.com/threads/popn-music-control-panel-for-sega-cabinets.15941/), [direct image](https://www.arcade-projects.com/attachments/popn-panel-final-png.124744/). Rebuilt group geometry uses the Pico-derived silhouettes, with the source lettering traced rather than retyped, simplified character cameos, and new music-note motifs. The panel is recomposed for 100 mm rims; it is not an exact reproduction. Credit the original artists; no new license is asserted for their artwork.
- **H — Hungry Mario-derived:** [source page](https://malio.tistory.com/324). Adapted from the supplied preview with reconstructed sweeps and corners, Pico-derived group geometry and traced lettering. This is a private local adaptation; the source page displays an attribution/noncommercial/no-derivatives notice, so a modified pack is not cleared for public redistribution.
- **N — Aquatic:** original vector wave bands, bubbles and a stylized lily, inspired by the aquatic color direction in [Noodlefighter's build photograph](https://noodlefighter.com/posts/9f3a/). It does not reproduce the photograph's character illustration.

`References/fredo.png` and `References/hungry-mario.jpg` preserve the source previews used for tracing. Run `uv run tools/prepare-new-artwork.py`, then `uv run tools/export-artwork.py --skip-export --themes FHN`. These designs use the same 0.8 mm flush inlay and unchanged enclosure geometry. All artwork previews include the four-color-per-segment constraint; physical button colors are separate.

## C — High Cheers cabinet inspiration

Original vector composition inspired by Konami's High☆Cheers!! / Pikapika Pop-kun cabinet: red/cyan side fields, white playing surface, yellow trim, stars, musical notes and two simplified smiling faces. Reference: [Konami's official cabinet announcement and photos](https://www.konami.com/arcadegames/corporate/ja/topics/2025/1218/). This is an inspired adaptation, not official panel artwork or a reproduction of the cabinet graphics. No lettering or logo has been retyped. Decorative rings begin outside the 100 mm physical button rim. The four global filament colors include the white structural body; physical button colors are excluded.

Regenerate with `python3 tools/prepare-cheers-artwork.py`, then `uv run tools/export-artwork.py --skip-export --themes C`.