CommunityImagegithub.com

pcb-render

Transforme les packs de matériaux exportés par EasyEDA (version Pro) en rendus 3D photoréalistes avec Blender Cycles : STEP 3D + calques DXF → matériaux PBR, résine bleue, pads dorés, sérigraphie blanche, cuivre, sortie en 2K/4K, vue principale, vue de dessus, macro.

Qu'est-ce que pcb-render ?

pcb-render est un skill d'agent IA dédié à la génération de rendus 3D photoréalistes de circuits imprimés (PCB) à partir de packs de matériaux exportés par EasyEDA (version Pro). Il utilise Blender Cycles pour combiner les modèles STEP 3D avec les calques DXF afin de produire des images haute résolution (2K/4K) avec des matériaux PBR distincts pour chaque composant : résine bleue, pads dorés, sérigraphie blanche et pistes cuivrées. Le skill prend en charge plusieurs vues (héroïque, dessus, macro) et dispose de commandes automatisées pour le post-traitement (conversion 8 bits, optimisation JPEG). Il est conçu pour fonctionner avec Claude Code, Cursor et Codex, et suit des règles strictes pour éviter les erreurs courantes comme le remplissage massif des zones de cuivre ou le décalage de la sérigraphie, avec une vérification systématique des assets avant rendu. L'installation se fait via un lien symbolique dans le répertoire DSH pour une mise à jour instantanée.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/maker114/PCB-Render-Kit/tree/HEAD/skill/pcb-render

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait pcb-render ?

Transformez le « pack de matériaux exporté en un clic par EasyEDA Pro » en rendus finis. Tous les scripts de la chaîne se trouvent dans scripts/ ; ce fichier sert uniquement au routage et à la discipline. Pour les détails, consultez references/.

Conditions de déclenchement

  • L'utilisateur fournit un zip exporté par EDA (contenant *_3D.step, *_DXF.dxf, BOM, PickAndPlace) pour générer une image.
  • L'utilisateur dit « refais une version », « change d'angle », « fais un macro », « agrandis en 4K », « la carte d'avant ».
  • L'utilisateur parle de rendu PCB, de carte 3D, d'image produit.

Règles absolues (chacune est le fruit d'erreurs douloureuses ; les enfreindre garantit un échec)

  1. Privilégier le STEP, ne pas redessiner les calques existants avec le DXF. Lorsque STEP contient des éléments comme TopCopper / TopSilkscreen, le cuivre et la sérigraphie doivent être projetés à partir de la géométrie STEP (layers_from_step.py). Le DXF ne sert qu'à compléter les calques absents du STEP : ouverture de masque de soudure, perçage, contour de carte.
    • Contre-exemple 1 : utiliser le DXF pour redessiner le cuivre → les zones de cuivre sont remplies pleinement (taux de couverture 97 %), toutes les pistes disparaissent.
    • Contre-exemple 2 : utiliser du texte DXF + une police de substitution pour redessiner la sérigraphie → largeur des caractères incohérente, décalage de 0,3 à 0,5 mm pour 4 à 6 caractères.
  2. Audit préalable obligatoire. audit_assets.py doit se terminer avec un code de sortie non nul pour stopper le rendu. Il vérifie la couverture et les blocs connectés, permettant de détecter les « remplissages pleins », « calques vides » ou « domaine unique connecté ».
  3. File d'attente GPU unique. Interdiction de lancer deux rendus Blender OptiX simultanément (6 Go de VRAM en conflit, temps mesuré 85 s → 696 s).
  4. Pas d'écrasement. Les images de vérification vont dans render/out/diag/, render/out/final/ ne reçoit qu'une seule écriture ; confirmer la résolution cible avant un nouveau rendu.
  5. Échantillonnage 1:1 avant livraison. Vérifier au moins 3 zones à 100 % : pads, pistes, références de sérigraphie. Les vignettes ne comptent pas comme validation.
  6. Mettre à jour la correspondance des matériaux à chaque changement de carte. recon_footprints.py affiche l'empreinte et la couleur, à ajouter dans FOOTPRINT_MAP de materials.py.

Détection d'environnement (à faire à chaque démarrage)

Aucun chemin n'est codé en dur dans les scripts ; scripts/env.py se charge de la détection (exécutez d'abord python scripts/env.py pour voir le rapport) :

ÉlémentComment le trouver
BlenderParamètre --blender → champ blender de config.json → variable d'environnement PCB_RENDER_BLENDER → PATH → emplacements d'installation courants (Program Files / bibliothèque Steam sous Windows, /Applications sous macOS, /usr/bin, snap, flatpak sous Linux)
PythonL'interpréteur exécutant pipeline.py (sys.executable), donc lancez-le avec votre Python contenant les dépendances installées
Dépendancespython -m pip install -r requirements.txt (cascadio / ezdxf / numpy / Pillow)

En cas d'absence de Blender, deux façons de le préciser :

# A. Ligne de commande
python pipeline.py --blender "C:/Program Files/Blender Foundation/Blender 5.2/blender.exe" ...

# B. Fichier de configuration (à faire une fois)
#    Copiez config.example.json en config.json, renseignez "blender": "<chemin>"
#    Prend aussi en charge %APPDATA%/pcb-render/config.json ou ~/.config/pcb-render/config.json

En cas de dépendances manquantes, pipeline.py affiche directement la commande d'installation avec le chemin de l'interpréteur, sans lancer un simple traceback.

Tous les appels à Blender doivent inclure --factory-startup. Sinon, les préférences utilisateur (interface en français) sont chargées, les nouveaux nœuds sont localisés en « Arrière-plan », et studio.py (qui accède aux nœuds par nom) plante. Notre studio.py a été modifié pour accéder aux nœuds par type, mais le paramètre reste recommandé (évite aussi les erreurs dues à des modules complémentaires incompatibles).

Flux principal

Une seule commande suffit (recommandé, environ 40 s pour un preview, 3 à 5 min pour une 2K) :

& $py "<skill>\scripts\pipeline.py" `
    --package "<pack.zip>" `
    --workdir "<répertoire de travail>" `
    --resolution preview        # preview | 2k | 4k
# Optionnel : --views hero,top,macro  --samples 160  --skip-render
#       --macro-target 0.010,-0.010,0.0016  --macro-distance 0.062

Il exécute successivement : décompression → STEP→GLB → DXF pour les calques mask/drill (et écrit align.json) → STEP pour copper/silk → Porte d'audit (sortie immédiate sans rendu si échec) → impression de la liste des empreintes → build_board → rendu 3 images → conversion en 8 bits/jpg. Les commandes pas à pas et les artefacts de chaque étape sont dans references/pipeline.md.

Après exécution, à faire :

  1. Regarder les images (render/out/final/) → composition, matériaux, pistes normales
  2. Échantillonnage 1:1 (3 zones avec Python, vérifier chaque plan lisible)
  3. Convertir en 8 bits : le master 16 bits garde *_16bit.png, le nom de fichier principal donne 8 bits, enregistrer aussi en jpg q95
  4. Écrire README.md dans le répertoire de livraison : pack d'entrée, modèle de carte, dimensions, contenu/taille de chaque image, chiffres d'audit, commande de reproduction
  5. Livrer les 3 images + README avec present

Composition et paramètres rapides

Type de carteVue principaleVue de dessusMacro
Carte large (100×65)16:9 3840x2160Verticale/horizontale selon la carte2560x1600
Carte carrée (36×36)1:1 2048x2048 (2K) / 3840x3840 (4K)1:12400x1680
Carte longue4:5 ou 16:9Verticale—

Caméras/lumières validées (pas besoin de réinitialiser à chaque fois) :

  • Vue 3/4 : --framing three_quarter --azimuth -32 --elevation 38 --margin 0.0~0.02
  • Vue de dessus : --framing top --azimuth 0 --elevation 84 --margin 0.05 --exposure -0.2
  • Macro : --framing three_quarter --target X,Y,0.0016 --lens 100 --distance 0.05~0.07 (Doit utiliser --distance : la distance de cadrage du studio détail est 2 à 3 fois trop grande)
  • Lumière : toujours --light pcb_hero --floor black --exposure -0.8 (vue de dessus -0.2)
  • Échantillonnage : 2K 128~160, 4K 200 ; débruitage OIDN

Tableau des pannes

SymptômeCauseTraitement
Les pistes invisibles / carte entièrement bleueCuivre redessiné avec DXF, rempli pleinExécuter layers_from_step.py pour utiliser la projection STEP
Texte de sérigraphie décalé, d'autant plus que l'étiquette est longueDXF redessiné avec une police de substitutionIdem ci-dessus, utiliser STEP pour la sérigraphie aussi
KeyError: 'Background'/'Arrière-plan'Absence de --factory-startup, interface en français avec nœuds localisésAjouter --factory-startup
La macro donne encore la carte entièreDistance automatique du studio détail trop grandeAjouter --distance 0.05~0.07
Rendu soudainement 5 à 10 fois plus lentDeux rendus OptiX simultanésSérie, un seul à la fois
Sérigraphie du module inversée haut/basComposant tourné à 180° (normal)Vérifier Rotation dans PickAndPlace, pas un bug
Trous traversants / de montage transformés en disques dorésDisque doré utilise « ouverture » sans « ouverture ET cuivre »Implémenté mask ∧ copper, vérifier si la texture cuivre est vide
Pads plus grands que les broches du composantExpansion du masqueNormal, en réalité l'ouverture est légèrement plus grande que le pad
Texture de carte globalement décaléealign.json du contour ne correspond pas à l'UVVérifier que build_board.py lit le même align.json

Fichiers de référence

Quand lireFichierContenu
Pour exécuter par étapes / comprendre les artefactsreferences/pipeline.mdCommandes, structure des répertoires, entrées/sorties de chaque étape, signification de l'audit
En cas de problème à diagnostiquerreferences/pitfalls.mdDonnées de 5 incidents, causes racines, méthodes de détection
Nouvelle carte : mauvaise couleur / ajout d'empreintereferences/materials.mdPalette de couleurs, structure FOOTPRINT_MAP, procédure d'ajout
Réglage de la composition, de l'éclairage, du point macroreferences/lighting-camera.mdPresets studio, décision d'aspect, conversion des coordonnées macro

Installation (où DSH scanne)

DSH découvre les skills via le plugin skill-filesystem selon les répertoires racines suivants (rang le plus bas = priorité la plus élevée) :

PérimètreCheminRang
Projet<racine du projet>/.dsh/skills100
Projet<racine du projet>/.agents/skills200
PersonnaliséRépertoire customSkillDirs dans la config de skill-filesystem (cordis.patch.yml)300
Utilisateur%USERPROFILE%\.dsh\skills (Windows) / ~/.dsh/skills (macOS, Linux)400
Utilisateur~/.agents/skills500

Un skill = un répertoire + SKILL.md. Le frontmatter doit avoir name (kebab-case, regex ^[a-z0-9]+(?:-[a-z0-9]+)*$) et description ; les autres champs (compatibility / allowed-tools) sont ignorés ou stockés dans les métadonnées, sans erreur. Pour empêcher l'invocation automatique par le modèle, ajouter disable-model-invocation: true.

# Local : attachez le dépôt via un lien symbolique dans le répertoire DSH des skills — les modifications du dépôt prennent effet immédiatement, un seul contenu
cmd /c mklink /J "%USERPROFILE%\.dsh\skills\pcb-render" "<ce dépôt>\skill\pcb-render"

# Autres machines : simple copie
Copy-Item -Recurse -Force "<ce dépôt>\skill\pcb-render" "$env:USERPROFILE\.dsh\skills\pcb-render"

# Ou utilisez le script du dépôt (par défaut junction, -Copy pour copie)
powershell -File "<ce dépôt>\scripts\install-skill.ps1"

Piège : le répertoire resources/runtime/office-skills/ sous le répertoire d'installation DSH n'est pas un répertoire de scan général — il s'agit du assetRoot propre au plugin office ; y mettre des skills ne sera pas détecté (nous avons perdu du temps). Les modifications apportées au skill sont détectées automatiquement (le fournisseur a un watcher chokidar), et les nouvelles sessions le verront immédiatement.

Skills associés