barissinall/pixel-print-kit

Pixel Print Kit

Bild rein, druckfertiges Kit raus. Das Skript findet das Pixelraster (oder pixeliert ein normales Bild), bereinigt die Palette, erstellt wasserdichte, farbsortierte Geometrie mit manifold3d und überprüft das Ergebnis so, wie es ein Slicer lesen würde.

Schnellstart

SKILL_DIR = der Ordner, der diese Datei enthält (${CLAUDE_SKILL_DIR} wenn verfügbar). Pfade in Anführungszeichen setzen.

python "$SKILL_DIR/scripts/pixelkit.py" sprite.png                                   # 45 mm Schlüsselanhänger, ein Teil pro Farbe
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png --product magnet --style swap     # Einzeldüsendrucker
python "$SKILL_DIR/scripts/pixelkit.py" logo.png --pixels 32 --max-colors 4 --render # Logo pixelieren, Renderings hinzufügen

Nur beim ersten Mal: python -m pip install manifold3d numpy pillow (das Skript gibt dies aus, wenn etwas fehlt).

Ausgabe in pixelkit-out/<name>/: stl/ (eine Datei pro Farbe), <name>.3mf (ein Objekt, ein Teil pro Farbe, benannt 01_black, 02_... in Schachtelreihenfolge), guide.md (Filamente, Einstellungen, Farbwechselhöhen), kit.json, preview.png (flache Farbprüfung), und mit --render: hero.jpg, top.jpg, turntable.mp4.

Produkt und Stil wählen

Der Benutzer möchte	Flags
Schlüsselanhänger (Standard)	--product keychain (45 mm, 2,2 mm Kontur, Ø4,2 mm Ringloch)
Kühlschrankmagnet	--product magnet (fügt eine Tasche für einen 10x2 mm Magneten hinzu; --magnet 8x3 zum Ändern)
Untersetzer	--product coaster (95 mm rund)
Wandplakette / Schild	--product plaque (120 mm abgerundetes Rechteck)
Nur die Kunst	--product tile (keine Kontur)
Hat ein AMS / Multi-Material	--style ams (Standard): bündige Farben, Wechsel nur in den oberen Schichten
Einzeldüse, kein AMS	--style swap: ein Körper, jede Farbe eine Höhenstufe; die Anleitung listet die Schicht für jeden Filamentwechsel

Nützlich: --size 60 (äußere Endgröße, mm) · --grid-gap 0,3 (Rillen zwischen den Pixeln, sehr „pixelig“) · --raise 0,6 (ams: Farben stehen hervor) · --shape silhouette|rect|round · --border 0 · --hole 0 · --hole-pos left|center|right · --base-color "#hex" (Konturfarbe) · --order "#a,#b,..." (swap: unten nach oben) · --max-colors 4 (an die AMS-Schächte des Benutzers anpassen) · --keep-bg (undurchsichtiger Hintergrund ist Teil des Kunstwerks).

Arbeitsablauf

- [ ] pixelkit.py ausführen; Konsole lesen: Rastergröße, Farben -> Filamente, Prüfungen OK
- [ ] preview.png ansehen: Ist die Palette richtig? (Fehlerhafte Anti-Aliasing-Farben -> `--merge` erhöhen oder `--max-colors` verringern)
- [ ] Pixelgröße >= 0,8 mm (andernfalls erscheint eine Warnung -> größere `--size` oder weniger `--pixels`)
- [ ] `--render` und hero.jpg / top.jpg vor der Auslieferung ansehen
- [ ] Dem Benutzer mitteilen: Abmessungen, Filamentschächte und bei swap die Farbwechselhöhen aus guide.md

Die Prüfungen (open edges 0, overlap 0) müssen bestanden werden; das Skript beendet sich mit Code 2, wenn nicht. Geben Sie niemals ein fehlerhaftes Kit weiter.

Faustregeln

• Echte Pixel-Art ist besser als pixelierte Fotos. Für ein Logo sind 24-40 Pixel Breite und 3-5 Farben am besten.
• Farben = Filamente. --max-colors auf oder unter den AMS-Schächten des Benutzers halten; vorgeschlagene PLA-Namen sind die nächstgelegenen Treffer, daher den Benutzer bitten, mit seinen Spulen zu vergleichen.
• Swap-Reihenfolge: Dunkelstes zuunterst funktioniert für die meisten Kunstwerke (zuerst Kontur). Helle Details oben bleiben scharf.
• Kleine Pixel: Schlüsselanhänger unter 40 mm mit 32+ Pixeln erhalten fragile Merkmale; Größe vergrößern oder Kunstwerk vereinfachen.
• Pixel-Art aus Spielen/Marken ist fremdes IP: in Ordnung für persönliche Drucke, nicht zum Verkauf.

Wann was lesen

• references/print-notes.md - Slicer-Schritte (Bambu/Orca/Prusa), Toleranzen, Magnete, Fehlerbehebung.