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)
- 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.
- Audit préalable obligatoire.
audit_assets.pydoit 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é ». - 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).
- 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. - É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.
- Mettre à jour la correspondance des matériaux à chaque changement de carte.
recon_footprints.pyaffiche l'empreinte et la couleur, à ajouter dansFOOTPRINT_MAPdematerials.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ément | Comment le trouver |
|---|---|
| Blender | Paramè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) |
| Python | L'interpréteur exécutant pipeline.py (sys.executable), donc lancez-le avec votre Python contenant les dépendances installées |
| Dépendances | python -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 :
- Regarder les images (
render/out/final/) → composition, matériaux, pistes normales - Échantillonnage 1:1 (3 zones avec Python, vérifier chaque plan lisible)
- Convertir en 8 bits : le master 16 bits garde
*_16bit.png, le nom de fichier principal donne 8 bits, enregistrer aussi en jpg q95 - É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
- Livrer les 3 images + README avec
present
Composition et paramètres rapides
| Type de carte | Vue principale | Vue de dessus | Macro |
|---|---|---|---|
| Carte large (100×65) | 16:9 3840x2160 | Verticale/horizontale selon la carte | 2560x1600 |
| Carte carrée (36×36) | 1:1 2048x2048 (2K) / 3840x3840 (4K) | 1:1 | 2400x1680 |
| Carte longue | 4:5 ou 16:9 | Verticale | — |
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ôme | Cause | Traitement |
|---|---|---|
| Les pistes invisibles / carte entièrement bleue | Cuivre redessiné avec DXF, rempli plein | Exécuter layers_from_step.py pour utiliser la projection STEP |
| Texte de sérigraphie décalé, d'autant plus que l'étiquette est longue | DXF redessiné avec une police de substitution | Idem 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és | Ajouter --factory-startup |
| La macro donne encore la carte entière | Distance automatique du studio détail trop grande | Ajouter --distance 0.05~0.07 |
| Rendu soudainement 5 à 10 fois plus lent | Deux rendus OptiX simultanés | Série, un seul à la fois |
| Sérigraphie du module inversée haut/bas | Composant tourné à 180° (normal) | Vérifier Rotation dans PickAndPlace, pas un bug |
| Trous traversants / de montage transformés en disques dorés | Disque 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 composant | Expansion du masque | Normal, en réalité l'ouverture est légèrement plus grande que le pad |
| Texture de carte globalement décalée | align.json du contour ne correspond pas à l'UV | Vérifier que build_board.py lit le même align.json |
Fichiers de référence
| Quand lire | Fichier | Contenu |
|---|---|---|
| Pour exécuter par étapes / comprendre les artefacts | references/pipeline.md | Commandes, structure des répertoires, entrées/sorties de chaque étape, signification de l'audit |
| En cas de problème à diagnostiquer | references/pitfalls.md | Données de 5 incidents, causes racines, méthodes de détection |
| Nouvelle carte : mauvaise couleur / ajout d'empreinte | references/materials.md | Palette de couleurs, structure FOOTPRINT_MAP, procédure d'ajout |
| Réglage de la composition, de l'éclairage, du point macro | references/lighting-camera.md | Presets 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ètre | Chemin | Rang |
|---|---|---|
| Projet | <racine du projet>/.dsh/skills | 100 |
| Projet | <racine du projet>/.agents/skills | 200 |
| 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/skills | 500 |
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.