Lewati ke isi
Versi Dokumen v2026.10.17.0
Unduh PDF

Bandingkan dua revisi papan (Board Diff)

Putaran ini hanya memverifikasi entri Compare Revisions… di pustaka. Alur perbandingan di bawah ini tidak dioperasikan ulang pada 2026-09-11. Jangan anggap halaman ini sebagai catatan penerimaan Diff yang lengkap untuk build saat ini.

Tujuan halaman

Membantu Anda memulai Board Diff dari revisi pustaka, memahami arah Before / After, memeriksa perubahan objek demi objek, dan mengekspor JSON atau PNG yang dapat ditinjau ulang.

Platform yang didukung

  • macOS 14 atau lebih baru: pengalaman layar lebar utama dan platform penerimaan pertama untuk Board Diff saat ini.
  • iOS / iPadOS 17.0 atau lebih baru: entri disediakan bersama aplikasi. Lebih baik landscape atau jendela yang lebih lebar; pengoptimalan khusus layar sempit masih pekerjaan lanjutan.

Untuk siapa

  • Staf desain, manufaktur, atau peninjauan yang perlu membandingkan dua revisi PCB yang sama
  • Penguji yang perlu menerima Diff berdasarkan arah, lapisan, objek, dan petunjuk risiko

Prasyarat

Pilih sepasang papan yang isinya berbeda tetapi format hasil parse-nya sama:

Input Status saat ini
DSN Didukung
KiCad .kicad_pcb papan tunggal Didukung
Folder atau arsip Gerber + Excellon Didukung
SES Didukung hanya ketika kedua sisi dapat diverifikasi dan menunjuk ke desain dasar yang sama
ODB++, IPC-2581, Altium PCB / library, KiCad Project lengkap Secara eksplisit tidak didukung untuk Board Diff saat ini

Before dan After bersifat berarah:

  • Added: hanya ada di After.
  • Removed: hanya ada di Before.
  • Modified: objek di kedua sisi dapat dipasangkan, tetapi atribut atau geometri berbeda.
  • Unchanged: sama di kedua sisi, ditampilkan hanya sebagai konteks.

Ekstensi file yang sama tidak menjamin format yang sama. PCBAtlas mem-parse setiap sisi secara terpisah, lalu memutuskan apakah perbandingan memungkinkan.

Langkah

Bandingkan dua revisi di pustaka

  1. Di pustaka, temukan dokumen dengan setidaknya dua revisi.
  2. Buka menu tindakan lainnya pada kartu dokumen.
  3. Klik Compare Revisions….
  4. Di Before dan After, pilih dua revisi berbeda dengan format yang sama.
  5. Klik Compare.

Jika revisi saat ini memiliki induk, halaman lebih memilih parent sebagai Before dan current sebagai After. Anda tetap dapat mengganti salah satu sisi secara manual.

Perbandingan terkelola yang selesai menyimpan artifact yang divalidasi. Saat berikutnya Anda masuk ke halaman perbandingan untuk dokumen yang sama, Anda dapat menggunakan Reopen Saved Comparison.

Konfirmasi pemasangan lapisan yang ambigu

Jika PcbCore menemukan beberapa kandidat yang kompatibel, perbandingan berhenti di Layer pairing needs confirmation:

  1. Untuk setiap lapisan Before, periksa nama, peran, urutan, dan jumlah objek.
  2. Di kanan, pilih After layer yang benar.
  3. Pastikan setiap item memiliki pilihan.
  4. Klik Confirm and Compare untuk menjalankan lagi.

PCBAtlas tidak menebak lapisan ketika pemasangan ambigu, dan tidak memaksa dua papan sejajar dengan translate / rotate otomatis. Translasi atau rotasi seluruh papan tetap disimpan sebagai perubahan nyata.

Tunggu atau batalkan perbandingan

Perbandingan menampilkan progres melalui validasi input, impor Before / After, pemasangan lapisan, snapshot, pencocokan geometri, analisis risiko, Diff scene, dan persistensi.

Setelah Anda klik Cancel, tunggu hingga Cancelling comparison… selesai. Halaman mengizinkan percobaan ulang yang aman hanya setelah kedua sesi native dan data staging sementara dilepaskan.

Baca ruang kerja perbandingan

Mode tampilan

  • Overlay: menumpuk perubahan dalam satu scene komposit yang tepat; Context mengontrol kekuatan konteks yang tidak berubah.
  • Split: Before di kiri, After di kanan; Sync Camera aktif secara default, dan mematikannya memungkinkan Anda meninjau setiap sisi secara terpisah.
  • Blink: secara otomatis beralih Before / After dengan kamera yang sama, berguna untuk pergeseran kecil.
  • Fit: menyesuaikan ulang scene saat ini ke area yang terlihat.

Lapisan dan perubahan

  • Layer Pairs di kiri menampilkan hasil pemasangan dan jumlah perubahan untuk setiap pasangan.
  • Pilih All layers untuk seluruh papan, atau satu pasangan lapisan untuk mempersempit cakupan.
  • Changes di kanan dapat mengaktifkan Added / Removed / Modified dan memfilter menurut tipe objek dan Net.
  • Mengklik baris perubahan melokalkan dan menyorot objek; memilih di Viewer juga mencari perubahan yang cocok.
  • Previous / Next menelusuri hasil filter saat ini; pintasan macOS adalah ⌘[ dan ⌘].
  • Panel Risks memfilter petunjuk berarah menurut tingkat risiko. Petunjuk risiko untuk pelokalan peninjauan, bukan pengganti DRC atau tanda tangan manufaktur.

Tukar arah, ekspor, dan buka ulang

  • Swap membuat permintaan terbalik dan menghitung ulang; Added / Removed, statistik, risiko, dan detail asli berbalik bersama arah.
  • JSON mengekspor hasil semantik yang stabil dan berversi; iOS menyerahkan file ke aplikasi lain.
  • PNG mengekspor tangkapan layar tampilan Diff saat ini; iOS menyimpannya langsung ke Photos, sementara macOS tetap memakai UI pengiriman file sistem.
  • Setelah perbandingan revisi terkelola selesai, buka ulang hasil yang divalidasi dari Reopen Saved Comparison.
  • Jika konten revisi, format, kebijakan, atau pemasangan lapisan telah berubah, artifact lama diperlakukan sebagai tidak valid, bukan menampilkan hasil usang secara diam-diam.

Shell lebar dan shell sempit

Kedua tata letak masuk ke perbandingan dari menu tindakan dokumen di pustaka. Jangan memakai Split Viewer biasa sebagai pengganti Board Diff. Split proyek biasa adalah kanvas ganda PCB dan skema; Split Diff adalah Before dan After. Jika pengaturan perbandingan atau panel hasil sesak di jendela sempit, perbesar jendela untuk membacanya. Putaran ini tidak memverifikasi tata letak Diff di shell sempit.

Daftar periksa penerimaan

  • Dokumen dengan hanya satu revisi tidak mengaktifkan Compare Revisions….
  • Dua revisi pustaka berformat sama dapat dijalankan, dan dapat dibuka ulang dari Reopen Saved Comparison.
  • Input yang sama, format berbeda, format tidak didukung, atau basis SES yang tidak konsisten memblokir Compare dengan alasan yang jelas.
  • Lapisan yang ambigu harus menyelesaikan pemasangan manual sebelum lanjut.
  • Posisi kamera tetap konsisten saat beralih Overlay / Split / Blink.
  • Sync Camera Split on / off berperilaku benar, dan Fit mengembalikan tampilan seluruh papan.
  • Filter Added / Removed / Modified, tipe objek, Net, dan risiko semuanya mempersempit hasil.
  • Klik daftar, pilih di Viewer, dan Previous / Next dapat melokalkan perubahan yang sama di kedua arah.
  • Setelah Swap, arah, warna, statistik, detail, dan risiko berbalik dengan benar.
  • Setelah membatalkan perbandingan papan besar di tengah jalan, halaman menunggu pembersihan dan dapat membandingkan lagi.
  • JSON dan PNG keduanya mengekspor, dan artifact terkelola tidak dipakai ulang secara salah setelah input berubah.

Batas eksplisit saat ini

  • Hanya input berformat sama yang dibandingkan; perbandingan lintas format tidak didukung.
  • ODB++, IPC-2581, Altium PCB / library, KiCad Project lengkap, Diff skema, dan Diff 3D tidak didukung.
  • Tidak ada penggabungan otomatis, terima-perubahan, atau modifikasi terbalik pada file sumber.
  • Tidak ada alignment otomatis; translasi dan rotasi seluruh papan tetap perbedaan yang terlihat.
  • Piksel gambar, bbox, atau teks file tidak dipakai sebagai cadangan untuk Diff geometri yang tepat.

FAQ

Mengapa tombol Compare tidak tersedia?

Periksa bahwa kedua sisi sudah dipilih, isinya berbeda, dan keduanya ter-parse sebagai format didukung yang sama. Untuk Gerber / Excellon, berikan setiap sisi folder atau arsip paket lengkap; dua file lapisan tunggal sembarang tidak dapat mewakili papan lengkap.

Mengapa ekstensi yang sama tetap melaporkan format tidak cocok?

Format diputuskan oleh hasil parse aktual, bukan nama file saja. Direktori, arsip, desain dasar SES, dan entri papan aktual semuanya ikut dalam validasi.

Mengapa saya tidak dapat membandingkan lagi segera setelah membatalkan?

Halaman menunggu PcbCore melepaskan kedua sesi Before / After dan data sementara, agar tugas baru tidak memakai sumber daya bersamaan dengan tugas lama. Coba lagi setelah Cancelling comparison… hilang.

Mengapa jumlah perubahan atau risiko juga berubah setelah Swap?

Added / Removed dan petunjuk risiko bersifat berarah. Swap tidak hanya menukar label tampilan; ia menghitung ulang dengan Before / After yang dibalik.

Hasil

Setelah perbandingan, Anda dapat melokalkan perubahan tepat di kedua sisi dalam ruang kerja yang sama, memeriksa risiko berarah, dan mengekspor JSON / PNG. Perbandingan revisi pustaka juga dapat disimpan dan dibuka ulang setelah validasi.

Terakhir diverifikasi

2026-07-30 (catatan alur asli); 2026-09-11 memverifikasi entri pustaka dan tidak menjalankan ulang perbandingan.