Version du document v2026.08.31.0

Comparer deux révisions de carte (Board Diff)¶

Objectif de la page¶

Lancer Board Diff depuis des révisions gérées, comprendre le sens Before / After, examiner les changements par objet et exporter un JSON ou PNG vérifiable.

Plateformes prises en charge¶

macOS 14 ou version ultérieure : expérience principale sur écran large et plateforme de validation initiale.
iOS / iPadOS 17.0 ou version ultérieure : l’entrée est présente ; le mode paysage ou une fenêtre large est recommandé pendant l’amélioration de l’affichage étroit.

Public concerné¶

Utilisateurs de conception, fabrication ou revue comparant deux révisions d’un même PCB
Testeurs validant sens, paires de couches, objets et indices de risque

Prérequis¶

Choisissez deux cartes dont le contenu diffère mais dont le format réellement résolu est identique :

Entrée	État actuel
DSN	Pris en charge
KiCad `.kicad_pcb` autonome	Pris en charge
Dossier ou archive Gerber + Excellon	Pris en charge
SES	Seulement si les deux côtés identifient la même conception de base vérifiée
ODB++, IPC-2581, KiCad Project complet	Explicitement non pris en charge par Board Diff

Before et After sont directionnels :

Added : présent uniquement dans After.
Removed : présent uniquement dans Before.
Modified : objet apparié dont les propriétés ou la géométrie diffèrent.
Unchanged : identique des deux côtés et affiché uniquement comme contexte.

Des extensions identiques ne prouvent pas des formats identiques. PCBAtlas résout chaque côté avant d’autoriser la comparaison.

Étapes¶

Comparer deux révisions gérées¶

Trouvez un document de bibliothèque comportant au moins deux révisions.
Ouvrez le menu d’actions supplémentaires de sa carte.
Sélectionnez Compare Revisions….
Choisissez deux révisions différentes de même format dans Before et After.
Sélectionnez Compare.

Si la révision actuelle a un parent, parent est préféré pour Before et current pour After. Vous pouvez modifier les deux.

La comparaison terminée enregistre un artifact vérifié. Revenez à la page du même document et utilisez Reopen Saved Comparison.

Confirmer un appariement de couches ambigu¶

Si PcbCore trouve plusieurs candidats compatibles, la comparaison s’arrête à Layer pairing needs confirmation :

Vérifiez le nom, le rôle, l’ordre et le nombre d’objets de chaque couche Before.
Choisissez la bonne After layer.
Affectez chaque élément ambigu.
Sélectionnez Confirm and Compare.

PCBAtlas ne devine pas une couche et ne force pas les cartes à coïncider par translation / rotation automatique. Un déplacement ou une rotation globale reste une différence réelle.

Attendre ou annuler¶

La progression couvre validation, import Before / After, appariement, snapshots, correspondance géométrique, risques, Diff scene exacte et persistance.

Après Cancel, attendez la fin de Cancelling comparison…. Une nouvelle tentative n’est sûre qu’après libération des deux native session et des données staging temporaires.

Lire l’espace de comparaison¶

Modes d’affichage¶

Overlay : combine les changements exacts ; Context règle l’intensité du contexte inchangé.
Split : Before à gauche, After à droite ; Sync Camera est actif par défaut et peut être désactivé.
Blink : alterne Before et After avec la même caméra pour révéler les petits déplacements.
Fit : réajuste la scène à la zone visible.

Couches et changements¶

Layer Pairs affiche les paires et le nombre de changements de chacune.
All layers affiche toute la carte ; une paire réduit la portée.
Dans Changes, activez Added / Removed / Modified et filtrez par type d’objet ou Net.
Une ligne localise et surligne le changement ; une sélection Viewer retrouve aussi son changement.
Previous / Next parcourt les résultats filtrés ; sous macOS, utilisez ⌘[ et ⌘].
Risks filtre les indices directionnels par gravité. Ils ne remplacent pas DRC ni validation de fabrication.

Inverser, exporter et rouvrir¶

Swap crée une requête inverse et recalcule Added / Removed, statistiques, risques et détails.
JSON exporte le résultat sémantique stable et versionné ; iOS remet le fichier à d’autres apps.
PNG exporte la vue Diff actuelle ; iOS l’enregistre directement dans Photos, tandis que macOS continue via l’interface système de livraison de fichiers.
Une comparaison gérée se rouvre avec Reopen Saved Comparison.
Si le contenu, le format, la politique ou l’appariement change, l’ancien artifact est invalidé plutôt qu’affiché silencieusement.

Liste de validation¶

Limites actuelles¶

Seuls des formats identiques sont comparés ; aucune comparaison interformat.
ODB++, IPC-2581, KiCad Project complet, Diff de schéma et Diff 3D ne sont pas pris en charge.
Aucun fusionnement, acceptation ou écriture inverse dans les sources.
Aucun alignment automatique ; translation et rotation globales restent visibles.
Les pixels, bbox et textes de fichier ne servent pas de repli à un Diff géométrique exact.

Questions fréquentes¶

Pourquoi `Compare` est-il désactivé ?¶

Vérifiez que les deux côtés sont choisis, différents et résolus au même format pris en charge. Pour Gerber / Excellon, fournissez un dossier ou une archive package complète de chaque côté, pas deux couches arbitraires.

Pourquoi des extensions identiques donnent-elles des formats différents ?¶

Le format provient de la résolution réelle. Répertoires, archives, base SES et board entry résolue participent à la validation.

Pourquoi ne puis-je pas réessayer immédiatement après une annulation ?¶

PcbCore doit libérer les deux sessions Before / After et les données temporaires. Réessayez après la disparition de Cancelling comparison….

Pourquoi les nombres ou risques changent-ils après Swap ?¶

Added / Removed et les risques sont directionnels. Swap recalcule avec Before / After inversés ; il ne change pas seulement les libellés.

Résultat¶

Vous localisez les changements exacts, examinez les risques directionnels et exportez JSON / PNG. Les comparaisons gérées peuvent aussi être stockées, vérifiées et rouvertes.

Dernière vérification¶

2026-07-30