Versão do documento v2026.08.31.0

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

Objetivo da página¶

Iniciar Board Diff a partir de revisões gerenciadas, entender a direção Before / After, inspecionar alterações por objeto e exportar JSON ou PNG revisável.

Plataformas compatíveis¶

macOS 14 ou posterior: experiência principal em tela ampla e primeira plataforma de aceitação.
iOS / iPadOS 17.0 ou posterior: a entrada está incluída; recomenda-se orientação horizontal ou janela ampla enquanto a otimização para telas estreitas continua.

Público-alvo¶

Usuários de projeto, fabricação ou revisão que comparam duas revisões do mesmo PCB
Testadores que validam direção, pares de camadas, objetos e indicações de risco

Pré-requisitos¶

Escolha duas placas com conteúdo diferente, resolvidas no mesmo formato real:

Entrada	Estado atual
DSN	Compatível
KiCad `.kicad_pcb` independente	Compatível
Pasta ou arquivo Gerber + Excellon	Compatível
SES	Somente quando ambos os lados identificam o mesmo projeto base verificado
ODB++, IPC-2581, KiCad Project completo	Explicitamente incompatível com Board Diff

Before e After são direcionais:

Added: existe apenas em After.
Removed: existe apenas em Before.
Modified: objeto pareado cujas propriedades ou geometria diferem.
Unchanged: igual nos dois lados, mostrado apenas como contexto.

Extensões iguais não provam formatos iguais. PCBAtlas resolve os lados separadamente.

Etapas¶

Comparar duas revisões gerenciadas¶

Encontre um documento da biblioteca com pelo menos duas revisões.
Abra o menu de mais ações do cartão.
Selecione Compare Revisions….
Escolha duas revisões diferentes do mesmo formato em Before e After.
Selecione Compare.

Se a revisão atual tiver pai, parent é preferido em Before e current em After. Ambos podem ser alterados.

A comparação concluída salva um artifact verificado. Use Reopen Saved Comparison na página do mesmo documento para reabrir.

Confirmar pareamento ambíguo de camadas¶

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

Revise nome, função, ordem e contagem de objetos de cada camada Before.
Escolha a After layer correta.
Atribua todos os itens ambíguos.
Selecione Confirm and Compare.

PCBAtlas não adivinha uma camada nem força alinhamento por translação / rotação automática. O deslocamento ou giro global permanece uma diferença real.

Aguardar ou cancelar¶

O progresso cobre validação, importação Before / After, pareamento, snapshots, correspondência geométrica, riscos, Diff scene exata e persistência.

Após Cancel, aguarde Cancelling comparison… terminar. Só é seguro tentar novamente após liberar as duas native session e os dados staging temporários.

Ler o espaço de comparação¶

Modos de exibição¶

Overlay: combina alterações exatas; Context controla a intensidade do contexto inalterado.
Split: Before à esquerda e After à direita; Sync Camera é ligado por padrão e pode ser desligado.
Blink: alterna Before e After com a mesma câmera para revelar pequenos movimentos.
Fit: ajusta novamente a cena à área visível.

Camadas e alterações¶

Layer Pairs mostra pares e a contagem de alterações de cada um.
All layers mostra a placa inteira; um par reduz o escopo.
Em Changes, alterne Added / Removed / Modified e filtre por tipo de objeto ou Net.
Uma linha localiza e destaca; uma seleção no Viewer também encontra sua alteração.
Previous / Next percorre os resultados filtrados; no macOS use ⌘[ e ⌘].
Risks filtra indicações direcionais por gravidade. Não substitui DRC nem aprovação de fabricação.

Inverter, exportar e reabrir¶

Swap cria uma solicitação inversa e recalcula Added / Removed, estatísticas, riscos e detalhes.
JSON exporta o resultado semântico estável e versionado; iOS entrega o arquivo a outros apps.
PNG exporta a visualização Diff atual; iOS a salva diretamente em Fotos, enquanto macOS continua usando a interface do sistema para entrega de arquivos.
Uma comparação gerenciada é reaberta com Reopen Saved Comparison.
Se conteúdo, formato, política ou pareamento mudar, o artifact antigo é invalidado em vez de exibido silenciosamente.

Checklist de aceitação¶

Limites atuais¶

Somente formatos iguais; não há comparação entre formatos.
ODB++, IPC-2581, KiCad Project completo, Diff esquemático e 3D não são compatíveis.
Não há mesclagem, aceitação ou gravação de alterações nas fontes.
Não há alignment automático; translação e rotação globais continuam visíveis.
Pixels, bbox e texto do arquivo não são usados como fallback para Diff geométrico exato.

Perguntas frequentes¶

Por que `Compare` está desabilitado?¶

Confirme que os dois lados estão escolhidos, são diferentes e resolvem no mesmo formato compatível. Para Gerber / Excellon, forneça uma pasta ou arquivo package completo por lado, não duas camadas arbitrárias.

Por que extensões iguais resultam em formatos diferentes?¶

O formato vem da resolução real. Diretórios, arquivos, projeto base SES e board entry resolvida fazem parte da validação.

Por que não posso tentar novamente logo após cancelar?¶

PcbCore precisa liberar as duas sessões Before / After e os dados temporários. Tente após Cancelling comparison… desaparecer.

Por que contagens ou riscos mudam após Swap?¶

Added / Removed e riscos são direcionais. Swap recalcula com Before / After invertidos; não troca apenas rótulos.

Resultado¶

Você localiza alterações exatas dos dois lados, revisa riscos direcionais e exporta JSON / PNG. Comparações gerenciadas também podem ser salvas, verificadas e reabertas.

Última verificação¶

2026-07-30