Versão do documento v2026.10.17.0

Comparar duas revisões da placa (Board Diff)¶

Esta rodada só verificou a entrada Compare Revisions… da biblioteca. O fluxo de comparação abaixo não foi reoperado em 2026-09-11. Não trate esta página como um registro completo de aceitação de Diff do build atual.

Objetivo da página¶

Ajudar você a iniciar o Board Diff a partir das revisões da biblioteca, entender a direção Before / After, inspecionar mudanças objeto a objeto e exportar JSON ou PNG revisáveis.

Plataformas compatíveis¶

macOS 14 ou posterior: a experiência principal em tela larga e a primeira plataforma de aceitação do Board Diff hoje.
iOS / iPadOS 17.0 ou posterior: a entrada é fornecida com o aplicativo. Prefira paisagem ou uma janela mais larga; a otimização dedicada para tela estreita ainda é trabalho de acompanhamento.

Público-alvo¶

Equipes de projeto, fabricação ou revisão que precisam comparar duas revisões da mesma PCB
Testadores que precisam aceitar o Diff por direção, camada, objeto e dicas de risco

Pré-requisitos¶

Escolha um par de placas cujo conteúdo difira, mas cujos formatos realmente analisados sejam os mesmos:

Entrada	Estado atual
DSN	Suportado
KiCad `.kicad_pcb` de placa única	Suportado
Pasta ou arquivo compactado Gerber + Excellon	Suportado
SES	Suportado somente quando os dois lados puderem ser verificados e apontarem para o mesmo projeto-base
ODB++, IPC-2581, Altium PCB / biblioteca, projeto KiCad completo	Explicitamente não suportado para Board Diff hoje

Before e After são direcionais:

Added: existe somente em After.
Removed: existe somente em Before.
Modified: os objetos dos dois lados podem ser pareados, mas atributos ou geometria diferem.
Unchanged: iguais nos dois lados, mostrados apenas como contexto.

A mesma extensão de arquivo não garante o mesmo formato. O PCBAtlas analisa cada lado separadamente e então decide se a comparação é possível.

Passos¶

Comparar duas revisões na biblioteca¶

Na biblioteca, encontre um documento com pelo menos duas revisões.
Abra o menu de mais ações no cartão do documento.
Clique em Compare Revisions….
Em Before e After, escolha duas revisões diferentes do mesmo formato.
Clique em Compare.

Se a revisão atual tiver um parent, a página prefere parent como Before e current como After. Você ainda pode alterar qualquer um dos lados manualmente.

Uma comparação hospedada concluída salva um artefato validado. Na próxima vez que você entrar na página de comparação do mesmo documento, pode usar Reopen Saved Comparison.

Confirmar o pareamento ambíguo de camadas¶

Se o PcbCore encontrar vários candidatos compatíveis, a comparação pausa em Layer pairing needs confirmation:

Para cada camada Before, confira nome, função, ordem e contagem de objetos.
À direita, escolha a After layer correta.
Confirme que cada item tem uma seleção.
Clique em Confirm and Compare para executar de novo.

O PCBAtlas não adivinha uma camada quando o pareamento é ambíguo, e não força duas placas ao alinhamento com translação / rotação automática. Translação ou rotação da placa inteira é mantida como uma mudança real.

Esperar ou cancelar a comparação¶

A comparação mostra o progresso por validação de entrada, importação de Before / After, pareamento de camadas, snapshot, correspondência geométrica, análise de risco, cena Diff e persistência.

Depois de clicar em Cancel, espere até Cancelling comparison… terminar. A página permite uma nova tentativa segura somente depois que as duas sessões nativas e os dados temporários de staging forem liberados.

Ler o espaço de trabalho de comparação¶

Modos de exibição¶

Overlay: superpõe as mudanças em uma cena composta exata; Context controla a intensidade do contexto inalterado.
Split: Before à esquerda, After à direita; Sync Camera fica ligado por padrão, e desligá-lo permite inspecionar cada lado separadamente.
Blink: troca automaticamente Before / After com a mesma câmera, útil para deslocamentos pequenos.
Fit: reajusta a cena atual à área visível.

Camadas e mudanças¶

Layer Pairs à esquerda mostra os resultados do pareamento e a contagem de mudanças de cada par.
Escolha All layers para a placa inteira, ou um par de camadas para reduzir o escopo.
Changes à direita pode ligar e desligar Added / Removed / Modified e filtrar por tipo de objeto e Net.
Clicar em uma linha de mudança localiza e destaca o objeto; selecionar no Viewer também busca a mudança correspondente.
Previous / Next percorrem os resultados filtrados atuais; os atalhos do macOS são ⌘[ e ⌘].
O painel Risks filtra dicas direcionais por nível de risco. As dicas de risco servem para localizar na revisão, não substituem DRC nem a aprovação de fabricação.

Trocar a direção, exportar e reabrir¶

Swap cria um pedido invertido e recalcula; Added / Removed originais, estatísticas, riscos e detalhes invertem com a direção.
JSON exporta um resultado semântico estável e versionado; o iOS entrega o arquivo a outros aplicativos.
PNG exporta uma captura da vista Diff atual; o iOS salva direto em Photos, enquanto o macOS continua usando a interface de entrega de arquivos do sistema.
Depois que uma comparação hospedada de revisão termina, reabra o resultado validado em Reopen Saved Comparison.
Se o conteúdo da revisão, o formato, a política ou o pareamento de camadas tiverem mudado, o artefato antigo é tratado como inválido em vez de mostrar em silêncio um resultado desatualizado.

Shell larga e shell estreita¶

Os dois layouts entram na comparação pelo menu de ações do documento na biblioteca. Não use o Split comum do Viewer como substituto do Board Diff. O Split comum de projeto é uma tela dupla de PCB e esquemático; o Split do Diff é Before e After. Se as configurações de comparação ou os painéis de resultado ficarem apertados em uma janela estreita, amplie a janela para lê-los. Esta rodada não verificou o layout Diff da shell estreita.

Checklist de aceitação¶

Limites explícitos atuais¶

Só entradas do mesmo formato são comparadas; comparação entre formatos não é suportada.
ODB++, IPC-2581, Altium PCB / biblioteca, projeto KiCad completo, Diff de esquemático e Diff 3D não são suportados.
Não há mesclagem automática, aceitação de mudança nem modificação inversa de arquivos-fonte.
Não há alinhamento automático; translação e rotação da placa inteira continuam diferenças visíveis.
Pixels de imagem, bbox ou texto de arquivo não são usados como fallback para Diff geométrico exato.

Perguntas frequentes¶

Por que o botão `Compare` não está disponível?¶

Confira se os dois lados estão selecionados, se os conteúdos diferem e se eles são analisados como o mesmo formato suportado. Para Gerber / Excellon, entregue a cada lado a pasta ou o arquivo compactado completo do pacote; dois arquivos arbitrários de camada única não podem representar uma placa completa.

Por que a mesma extensão ainda relata incompatibilidade de formato?¶

O formato é decidido pelos resultados reais da análise, não só pelo nome do arquivo. Diretórios, arquivos compactados, projetos-base SES e a entrada real da placa todos participam da validação.

Por que não consigo comparar de novo imediatamente depois de cancelar?¶

A página espera o PcbCore liberar as duas sessões Before / After e os dados temporários, para que uma tarefa nova não ocupe recursos ao mesmo tempo que uma antiga. Tente de novo depois que Cancelling comparison… desaparecer.

Por que as contagens de mudança ou os riscos também mudaram depois do Swap?¶

Added / Removed e as dicas de risco são direcionais. Swap não só troca rótulos de exibição; ele recalcula com Before / After invertidos.

Resultado¶

Depois da comparação, você pode localizar mudanças exatas nos dois lados no mesmo espaço de trabalho, conferir riscos direcionais e exportar JSON / PNG. Comparações de revisão da biblioteca também podem ser salvas e reabertas depois da validação.

Última verificação¶

2026-07-30 (registro original do fluxo); 2026-09-11 verificou a entrada da biblioteca e não reexecutou a comparação.