O que Pixel Print Kit faz?
Imagem entra, kit imprimível sai. O script encontra a grade de pixels (ou pixeliza uma imagem normal), limpa a paleta, constrói geometria à prova d'água por cor com manifold3d e verifica o resultado da mesma forma que um fatiador o lê.
Início rápido
SKILL_DIR = a pasta que contém este arquivo (${CLAUDE_SKILL_DIR} quando disponível). Coloque os caminhos entre aspas.
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png # chaveiro de 45 mm, uma peça por cor
python "$SKILL_DIR/scripts/pixelkit.py" sprite.png --product magnet --style swap # impressora de bico único
python "$SKILL_DIR/scripts/pixelkit.py" logo.png --pixels 32 --max-colors 4 --render # pixelizar um logotipo, adicionar renders
Na primeira vez: python -m pip install manifold3d numpy pillow (o script exibe isso se faltar algo).
Saída em pixelkit-out/<nome>/: stl/ (um arquivo por cor), <nome>.3mf (um objeto, uma peça por cor, nomeada
01_preto, 02_... na ordem dos slots), guide.md (filamentos, configurações, alturas de troca de cor), kit.json,
preview.png (verificação de cores planas) e com --render: hero.jpg, top.jpg, turntable.mp4.
Escolher produto e estilo
| o usuário quer | flags |
|---|---|
| chaveiro (padrão) | --product keychain (45 mm, contorno de 2.2 mm, furo de anel Ø4.2 mm) |
| ímã de geladeira | --product magnet (adiciona um bolso para ímã de 10x2 mm; --magnet 8x3 para alterar) |
| porta-copo | --product coaster (95 mm redondo) |
| placa de parede / letreiro | --product plaque (retângulo arredondado de 120 mm) |
| apenas a arte | --product tile (sem contorno) |
| tem AMS / multimaterial | --style ams (padrão): cores niveladas, mudanças apenas nas camadas superiores |
| bico único, sem AMS | --style swap: um corpo, cada cor um degrau de altura; o guia lista a camada para cada troca de filamento |
Úteis: --size 60 (tamanho externo final, mm) · --grid-gap 0.3 (ranhuras entre pixels, bem "pixel") ·
--raise 0.6 (ams: cores se destacam) · --shape silhouette|rect|round · --border 0 · --hole 0 ·
--hole-pos left|center|right · --base-color "#hex" (cor do contorno) · --order "#a,#b,..." (swap: de baixo para cima) ·
--max-colors 4 (combinar com os slots AMS do usuário) · --keep-bg (fundo opaco faz parte da arte).
Fluxo de trabalho
- [ ] executar pixelkit.py; ler o console: tamanho da grade, cores -> filamentos, verificações OK
- [ ] olhar preview.png: a paleta está correta? (cores de suavização indevidas -> aumentar --merge ou diminuir --max-colors)
- [ ] tamanho do pixel >= 0.8 mm (um aviso aparece caso contrário -> aumentar --size ou diminuir --pixels)
- [ ] --render e ler hero.jpg / top.jpg antes de entregar
- [ ] informar o usuário: dimensões, slots de filamento e, para swap, as alturas de troca de cor do guide.md
As verificações (arestas abertas 0, sobreposição 0) devem passar; o script sai com código 2 caso contrário. Nunca entregue um kit com falhas.
Regras práticas
- Pixel art real é melhor que fotos pixelizadas. Para um logotipo, 24-40 pixels de largura e 3-5 cores funcionam melhor.
- Cores = filamentos. Mantenha
--max-colorsigual ou abaixo dos slots AMS do usuário; os nomes PLA sugeridos são os mais próximos, então peça ao usuário para comparar com seus carretéis. - Ordem de swap: a cor mais escura na base funciona para a maioria das artes (contorno primeiro). Detalhes claros no topo permanecem nítidos.
- Pixels pequenos: chaveiros com menos de 40 mm e 32+ pixels podem ter detalhes frágeis; aumente o tamanho ou simplifique a arte.
- Pixel art de jogos/marcas é propriedade intelectual de terceiros: tudo bem para impressões pessoais, não para venda.
Quando ler o quê
references/print-notes.md— passos no fatiador (Bambu/Orca/Prusa), tolerâncias, ímãs, solução de problemas.