Versión del documento v2026.08.31.0

Comparar dos revisiones de placa (Board Diff)¶

Objetivo de la página¶

Iniciar Board Diff desde revisiones gestionadas, entender la dirección Before / After, inspeccionar cambios por objeto y exportar JSON o PNG revisables.

Plataformas compatibles¶

macOS 14 o posterior: experiencia principal en pantalla ancha y plataforma de aceptación inicial.
iOS / iPadOS 17.0 o posterior: la entrada está incluida; se recomienda orientación horizontal o ventana ancha mientras continúa la optimización para pantallas estrechas.

Destinatarios¶

Usuarios de diseño, fabricación o revisión que comparan dos revisiones del mismo PCB
Personal de pruebas que valida cambios direccionales, pares de capas, objetos y avisos de riesgo

Requisitos previos¶

Elige dos placas con contenido diferente que se resuelvan al mismo formato real:

Entrada	Estado actual
DSN	Compatible
KiCad `.kicad_pcb` independiente	Compatible
Carpeta o archivo Gerber + Excellon	Compatible
SES	Solo si ambos lados identifican el mismo diseño base verificado
ODB++, IPC-2581, KiCad Project completo	No compatible explícitamente con Board Diff

Before y After son direccionales:

Added: solo existe en After.
Removed: solo existe en Before.
Modified: objeto emparejado cuyas propiedades o geometría difieren.
Unchanged: igual en ambos lados y mostrado solo como contexto.

Las extensiones iguales no demuestran formatos iguales. PCBAtlas resuelve cada lado antes de permitir la comparación.

Pasos¶

Comparar dos revisiones gestionadas¶

Busca un documento de la biblioteca con al menos dos revisiones.
Abre el menú de más acciones de su tarjeta.
Selecciona Compare Revisions….
Elige dos revisiones diferentes del mismo formato en Before y After.
Selecciona Compare.

Si la revisión actual tiene un padre, la página prefiere parent para Before y current para After. Puedes cambiar ambos.

La comparación terminada guarda un artifact verificado. Vuelve a la página de ese documento y usa Reopen Saved Comparison para abrirlo de nuevo.

Confirmar emparejamientos ambiguos de capas¶

Si PcbCore encuentra varios candidatos compatibles, se detiene en Layer pairing needs confirmation:

Revisa nombre, función, orden y cantidad de objetos de cada capa Before.
Elige la After layer correcta.
Asigna todas las entradas ambiguas.
Selecciona Confirm and Compare.

PCBAtlas no adivina una capa ni fuerza la alineación con traslación / rotación automáticas. El desplazamiento o giro global sigue siendo una diferencia real.

Esperar o cancelar¶

El progreso cubre validación, importación Before / After, emparejamiento, snapshots, coincidencia geométrica, análisis de riesgos, Diff scene exacta y persistencia.

Después de Cancel, espera a que termine Cancelling comparison…. Solo se puede reintentar cuando se liberan las dos native session y los datos staging temporales.

Leer el espacio de comparación¶

Modos de visualización¶

Overlay: combina cambios exactos en una escena; Context controla la intensidad del contexto sin cambios.
Split: Before a la izquierda y After a la derecha; Sync Camera está activo por defecto y puede desactivarse.
Blink: alterna Before y After con la misma cámara para revelar desplazamientos pequeños.
Fit: vuelve a ajustar la escena al área visible.

Capas y cambios¶

Layer Pairs muestra los pares y la cantidad de cambios de cada uno.
Usa All layers para la placa completa o un par para limitar el ámbito.
En Changes, activa Added / Removed / Modified y filtra por tipo de objeto o Net.
Una fila localiza y resalta el cambio; seleccionar en el Viewer también busca su cambio.
Previous / Next recorren el filtro actual; en macOS usa ⌘[ y ⌘].
Risks filtra avisos direccionales por gravedad. No sustituye DRC ni aprobación de fabricación.

Intercambiar, exportar y reabrir¶

Swap crea una solicitud inversa y recalcula Added / Removed, estadísticas, riesgos y detalles.
JSON exporta el resultado semántico estable y versionado; iOS entrega el archivo a otras aplicaciones.
PNG exporta la vista Diff actual; iOS la guarda directamente en Fotos y macOS continúa mediante la interfaz del sistema para entregar archivos.
Una comparación gestionada se reabre con Reopen Saved Comparison.
Si cambia el contenido, formato, política o emparejamiento, el artifact anterior se invalida en lugar de mostrarse en silencio.

Lista de aceptación¶

Límites actuales¶

Solo se comparan entradas del mismo formato; no hay comparación entre formatos.
ODB++, IPC-2581, KiCad Project completo, Diff de esquema y Diff 3D no son compatibles.
No se fusionan, aceptan ni escriben cambios en los archivos fuente.
No hay alignment automático; traslación y giro global siguen visibles.
No se usan píxeles, bbox ni texto de archivo como respaldo de Diff geométrico exacto.

Preguntas frecuentes¶

¿Por qué `Compare` está desactivado?¶

Comprueba que ambos lados estén elegidos, sean distintos y se resuelvan al mismo formato compatible. Para Gerber / Excellon, entrega una carpeta o archivo package completo en cada lado, no dos capas individuales arbitrarias.

¿Por qué extensiones iguales producen formatos distintos?¶

El formato procede de la resolución real, no solo del nombre. Directorios, archivos, diseño base SES y board entry resuelta forman parte de la validación.

¿Por qué no puedo reintentar inmediatamente tras cancelar?¶

PcbCore debe liberar ambas sesiones Before / After y los datos temporales para evitar solapamientos. Reintenta después de que desaparezca Cancelling comparison….

¿Por qué cambian cantidades o riesgos tras Swap?¶

Added / Removed y los riesgos son direccionales. Swap recalcula con Before / After inversos; no solo intercambia etiquetas.

Resultado¶

Puedes localizar cambios exactos entre ambos lados, revisar riesgos direccionales y exportar JSON / PNG. Las comparaciones gestionadas también se guardan, verifican y reabren.

Última verificación¶

2026-07-30