Versión del documento v2026.10.17.0

Comparar dos revisiones de placa (Board Diff)¶

Esta pasada solo verificó la entrada Compare Revisions… de la biblioteca. El flujo de comparación siguiente no se volvió a operar el 2026-09-11. No trates esta página como un registro completo de aceptación de Diff de la compilación actual.

Objetivo de la página¶

Ayudarte a iniciar Board Diff desde las revisiones de la biblioteca, entender la dirección Before / After, inspeccionar los cambios objeto por objeto y exportar JSON o PNG revisables.

Plataformas compatibles¶

macOS 14 o posterior: la experiencia principal de pantalla ancha y la primera plataforma de aceptación de Board Diff hoy.
iOS / iPadOS 17.0 o posterior: la entrada se incluye con la aplicación. Prefiere la orientación horizontal o una ventana más ancha; la optimización específica de pantalla estrecha sigue siendo trabajo posterior.

Destinatarios¶

Personal de diseño, fabricación o revisión que necesita comparar dos revisiones del mismo PCB
Probadores que necesitan aceptar Diff por dirección, capa, objeto e indicaciones de riesgo

Requisitos previos¶

Elige un par de placas cuyo contenido difiera pero cuyos formatos realmente analizados sean el mismo:

Entrada	Estado actual
DSN	Admitido
KiCad `.kicad_pcb` de una sola placa	Admitido
Carpeta o archivo comprimido Gerber + Excellon	Admitido
SES	Admitido solo cuando ambos lados se pueden verificar y apuntan al mismo diseño base
ODB++, IPC-2581, Altium PCB / biblioteca, proyecto KiCad completo	Explícitamente no admitido para Board Diff hoy

Before y After son direccionales:

Added: existe solo en After.
Removed: existe solo en Before.
Modified: los objetos de ambos lados se pueden emparejar, pero los atributos o la geometría difieren.
Unchanged: igual en ambos lados, se muestra solo como contexto.

La misma extensión de archivo no garantiza el mismo formato. PCBAtlas analiza cada lado por separado y luego decide si la comparación es posible.

Pasos¶

Comparar dos revisiones en la biblioteca¶

En la biblioteca, encuentra un documento con al menos dos revisiones.
Abre el menú de más acciones de la tarjeta del documento.
Haz clic en Compare Revisions….
En Before y After, elige dos revisiones distintas del mismo formato.
Haz clic en Compare.

Si la revisión actual tiene un padre, la página prefiere parent como Before y current como After. Aun así puedes cambiar cualquiera de los dos lados de forma manual.

Una comparación alojada completada guarda un artifact validado. La próxima vez que entres en la página de comparación del mismo documento, puedes usar Reopen Saved Comparison.

Confirmar un emparejamiento de capas ambiguo¶

Si PcbCore encuentra varios candidatos compatibles, la comparación se detiene en Layer pairing needs confirmation:

Para cada capa Before, comprueba el nombre, el rol, el orden y el recuento de objetos.
A la derecha, elige la After layer correcta.
Confirma que cada elemento tiene una selección.
Haz clic en Confirm and Compare para volver a ejecutar.

PCBAtlas no adivina una capa cuando el emparejamiento es ambiguo, y no fuerza el alineamiento de dos placas con translate / rotate automático. La traslación o rotación de la placa completa se conserva como un cambio real.

Esperar o cancelar la comparación¶

La comparación muestra el progreso de validación de entrada, importación de Before / After, emparejamiento de capas, instantánea, coincidencia geométrica, análisis de riesgo, escena Diff y persistencia.

Después de hacer clic en Cancel, espera a que termine Cancelling comparison…. La página permite un reintento seguro solo cuando se han liberado las dos native session y los datos temporales de staging.

Leer el espacio de trabajo de comparación¶

Modos de visualización¶

Overlay: superpone los cambios en una escena compuesta exacta; Context controla la intensidad del contexto sin cambios.
Split: Before a la izquierda, After a la derecha; Sync Camera está activado de forma predeterminada, y desactivarlo te permite inspeccionar cada lado por separado.
Blink: cambia automáticamente Before / After con la misma cámara, útil para desplazamientos pequeños.
Fit: reajusta la escena actual al área visible.

Capas y cambios¶

Layer Pairs a la izquierda muestra los resultados de emparejamiento y el recuento de cambios de cada par.
Elige All layers para toda la placa, o un par de capas para reducir el alcance.
Changes a la derecha puede activar o desactivar Added / Removed / Modified y filtrar por tipo de objeto y Net.
Al hacer clic en una fila de cambio se localiza y resalta el objeto; al seleccionar en Viewer también se busca el cambio coincidente.
Previous / Next recorren los resultados filtrados actuales; los atajos de macOS son ⌘[ y ⌘].
El panel Risks filtra indicaciones direccionales por nivel de riesgo. Las indicaciones de riesgo sirven para localizar en la revisión, no sustituyen DRC ni la aprobación de fabricación.

Intercambiar dirección, exportar y reabrir¶

Swap crea una solicitud invertida y vuelve a calcular; Added / Removed originales, estadísticas, riesgos y detalles se invierten con la dirección.
JSON exporta un resultado semántico estable y versionado; iOS entrega el archivo a otras aplicaciones.
PNG exporta una captura de la vista Diff actual; iOS la guarda directamente en Photos, mientras que macOS sigue usando la interfaz de entrega de archivos del sistema.
Tras completar una comparación de revisiones alojada, vuelve a abrir el resultado validado desde Reopen Saved Comparison.
Si el contenido de la revisión, el formato, la política o el emparejamiento de capas han cambiado, el artifact antiguo se trata como no válido en lugar de mostrar en silencio un resultado obsoleto.

Shell ancha y shell estrecha¶

Ambas disposiciones entran en la comparación desde el menú de acciones del documento en la biblioteca. No uses el Split habitual de Viewer como sustituto de Board Diff. El Split habitual de un proyecto es un lienzo dual de PCB y esquema; el Split de Diff es Before y After. Si los paneles de ajustes o de resultados de la comparación quedan apretados en una ventana estrecha, amplía la ventana para leerlos. Esta pasada no verificó la disposición Diff de la shell estrecha.

Lista de comprobación de aceptación¶

Límites actuales explícitos¶

Solo se comparan entradas del mismo formato; no se admite la comparación entre formatos.
No se admiten ODB++, IPC-2581, Altium PCB / biblioteca, proyecto KiCad completo, Diff de esquema ni Diff 3D.
No hay fusión automática, aceptación de cambios ni modificación inversa de los archivos de origen.
No hay alineación automática; la traslación y la rotación de la placa completa siguen siendo diferencias visibles.
No se usan píxeles de imagen, bbox ni texto de archivo como respaldo de un Diff geométrico exacto.

Preguntas frecuentes¶

¿Por qué no está disponible el botón `Compare`?¶

Comprueba que ambos lados estén seleccionados, que el contenido difiera y que se analicen como el mismo formato admitido. En Gerber / Excellon, entrega a cada lado la carpeta o el archivo comprimido completo del paquete; dos archivos de una sola capa cualquiera no pueden sustituir una placa completa.

¿Por qué la misma extensión sigue informando un desajuste de formato?¶

El formato lo deciden los resultados reales del análisis, no solo el nombre de archivo. Los directorios, los archivos comprimidos, los diseños base SES y la entrada real de placa participan en la validación.

¿Por qué no puedo volver a comparar de inmediato después de cancelar?¶

La página espera a que PcbCore libere las dos sesiones Before / After y los datos temporales, para que una tarea nueva no ocupe recursos al mismo tiempo que una antigua. Reintenta cuando desaparezca Cancelling comparison….

¿Por qué también cambiaron los recuentos de cambios o los riesgos después de Swap?¶

Added / Removed y las indicaciones de riesgo son direccionales. Swap no solo intercambia etiquetas de visualización; vuelve a calcular con Before / After invertidos.

Resultado¶

Tras la comparación, puedes localizar cambios exactos en ambos lados en el mismo espacio de trabajo, comprobar riesgos direccionales y exportar JSON / PNG. Las comparaciones de revisiones de la biblioteca también se pueden guardar y reabrir después de la validación.

Última verificación¶

2026-07-30 (registro original del flujo); 2026-09-11 se verificó la entrada de la biblioteca y no se volvió a ejecutar la comparación.