픽셀 프린트 키트은(는) 무엇을 하나요?
이미지를 넣으면 인쇄 가능한 키트가 나옵니다. 스크립트는 픽셀 그리드를 찾거나(또는 일반 이미지를 픽셀화하고), 팔레트를 정리하고, manifold3d로 각 색상별 방수 형상을 만든 후 슬라이서가 읽는 방식과 동일하게 결과를 검증합니다.
빠른 시작
SKILL_DIR = 이 파일이 포함된 폴더(사용 가능한 경우 ${CLAUDE_SKILL_DIR}). 경로는 따옴표로 묶으세요.
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png # 45mm 열쇠고리, 색상당 하나의 부품
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png --product magnet --style swap # 단일 노즐 프린터
python "$SKILL_DIR/scripts/pixelkit.py" logo.png --pixels 32 --max-colors 4 --render # 로고 픽셀화, 렌더링 추가
처음 한 번만: python -m pip install manifold3d numpy pillow (누락된 항목이 있으면 스크립트가 이 메시지를 출력합니다).
출력 폴더: pixelkit-out/<name>/: stl/ (색상당 하나의 파일), <name>.3mf (슬롯 순서대로 01_black, 02_...과 같이 이름이 지정된 하나의 객체, 색상당 하나의 부품), guide.md (필라멘트, 설정, 색상 변경 높이), kit.json, preview.png (평면 색상 확인), --render 사용 시: hero.jpg, top.jpg, turntable.mp4.
제품 및 스타일 선택
| 사용자 요구사항 | 플래그 |
|---|---|
| 열쇠고리 (기본값) | --product keychain (45mm, 2.2mm 외곽선, Ø4.2mm 링 구멍) |
| 냉장고 자석 | --product magnet (10x2mm 자석용 포켓 추가; 변경 시 --magnet 8x3) |
| 코스터 | --product coaster (95mm 원형) |
| 벽걸이 플라크/표지판 | --product plaque (120mm 모서리 둥근 직사각형) |
| 아트만 | --product tile (외곽선 없음) |
| AMS/다중 재료 있음 | --style ams (기본값): 색상이 평평하게 맞춰지며, 상단 레이어에서만 변경됨 |
| 단일 노즐, AMS 없음 | --style swap: 하나의 본체, 각 색상은 하나의 높이 단계; 가이드는 각 필라멘트 교체 레이어를 나열함 |
유용한 옵션: --size 60 (완성된 외부 크기, mm) · --grid-gap 0.3 (픽셀 사이의 홈, 매우 "픽셀" 느낌) ·
--raise 0.6 (ams: 색상이 돌출됨) · --shape silhouette|rect|round · --border 0 · --hole 0 ·
--hole-pos left|center|right · --base-color "#hex" (외곽선 색상) · --order "#a,#b,..." (swap: 아래에서 위로) ·
--max-colors 4 (사용자의 AMS 슬롯에 맞춤) · --keep-bg (불투명 배경을 아트의 일부로 유지).
워크플로우
- [ ] pixelkit.py 실행; 콘솔 확인: 그리드 크기, 색상 -> 필라멘트, 검사 통과
- [ ] preview.png 확인: 팔레트가 올바른가? (잘못된 안티앨리어싱 색상 -> --merge 높이거나 --max-colors 낮추기)
- [ ] 픽셀 크기 >= 0.8 mm (그렇지 않으면 경고 표시 -> --size를 키우거나 --pixels를 줄이기)
- [ ] --render 해서 전달하기 전에 hero.jpg / top.jpg 확인
- [ ] 사용자에게 알리기: 치수, 필라멘트 슬롯, 그리고 swap의 경우 guide.md의 색상 변경 높이
검사(open edges 0, overlap 0)는 반드시 통과해야 합니다. 실패 시 스크립트는 코드 2로 종료됩니다. 실패한 키트를 절대 전달하지 마세요.
경험 법칙
- 실제 픽셀 아트가 픽셀화된 사진보다 낫습니다. 로고의 경우 24-40 픽셀 너비와 3-5가지 색상이 가장 잘 읽힙니다.
- 색상 = 필라멘트.
--max-colors를 사용자의 AMS 슬롯 수 이하로 유지하세요. 제안된 PLA 이름은 가장 가까운 일치 항목이므로 사용자에게 자신의 스풀과 비교해 보도록 요청하세요. - 교체 순서: 가장 어두운 색상을 아래에 배치하는 것이 대부분의 아트에 효과적입니다(외곽선 먼저). 밝은 디테일은 위에 남아 선명하게 유지됩니다.
- 작은 픽셀: 40mm 미만의 열쇠고리에 32+ 픽셀은 세부 요소가 깨지기 쉽습니다. 크기를 키우거나 아트를 단순화하세요.
- 게임/브랜드의 픽셀 아트는 타인의 지적 재산권입니다. 개인 인쇄에는 괜찮지만 판매용은 아닙니다.
무엇을 언제 읽을지
references/print-notes.md- 슬라이서 단계(Bambu/Orca/Prusa), 공차, 자석, 문제 해결.