문서 버전 v2026.10.17.0

PDF 다운로드

두 보드 리비전 비교 (Board Diff)

이번 검증은 라이브러리의 Compare Revisions… 진입점만 확인했습니다. 아래 비교 흐름은 2026-09-11에 다시 실제 조작하지 않았습니다. 이 페이지를 현재 빌드의 완전한 Diff 검수 기록으로 쓰지 마세요.

페이지 목표

라이브러리 리비전에서 Board Diff를 시작하고, Before / After 방향을 이해하며, 객체별 변화를 검사하고, 다시 볼 수 있는 JSON 또는 PNG를 내보내도록 돕습니다.

지원 플랫폼

• macOS 14 이상: 현재 Board Diff의 주요 와이드 화면 경험이자 첫 검수 플랫폼입니다.
• iOS / iPadOS 17.0 이상: 진입점은 앱과 함께 제공됩니다. 가로 방향이나 더 넓은 창을 권장하며, 좁은 화면 전용 최적화는 후속 작업입니다.

대상 독자

• 같은 PCB의 두 리비전을 비교해야 하는 설계, 제조, 검토 담당자
• 방향, 레이어, 객체, 리스크 힌트별로 Diff를 검수해야 하는 테스터

사전 준비

내용은 다르지만 실제로 해석된 형식이 같은 보드 쌍을 고르세요.

입력	현재 상태
DSN	지원
단일 보드 KiCad .kicad_pcb	지원
Gerber + Excellon 폴더 또는 아카이브	지원
SES	양쪽을 검증할 수 있고 같은 기초 설계를 가리킬 때만 지원
ODB++, IPC-2581, Altium PCB／라이브러리, 전체 KiCad Project	현재 Board Diff에서 명시적으로 미지원

Before와 After는 방향이 있습니다.

• Added: After에만 있습니다.
• Removed: Before에만 있습니다.
• Modified: 양쪽 객체를 짝지을 수 있지만 속성이나 기하가 다릅니다.
• Unchanged: 양쪽이 같으며 컨텍스트로만 표시합니다.

파일 확장자가 같다고 형식이 같은 것은 아닙니다. PCBAtlas는 양쪽을 따로 해석한 뒤 비교 가능 여부를 결정합니다.

단계

라이브러리의 두 리비전 비교

1. 라이브러리에서 리비전이 둘 이상인 문서를 찾습니다.
2. 문서 카드의 추가 동작 메뉴를 엽니다.
3. Compare Revisions…를 클릭합니다.
4. Before와 After에서 서로 다르고 형식이 같은 리비전 두 개를 선택합니다.
5. Compare를 클릭합니다.

현재 리비전에 부모 리비전이 있으면 페이지는 parent를 Before, current를 After로 우선 사용합니다. 양쪽은 직접 바꿀 수 있습니다.

완료된 호스팅 비교는 검증된 아티팩트를 저장합니다. 같은 문서의 비교 페이지에 다음에 들어가면 Reopen Saved Comparison으로 다시 열 수 있습니다.

모호한 레이어 페어링 확인

PcbCore가 호환 후보를 여러 개 찾으면 비교는 Layer pairing needs confirmation에서 멈춥니다.

1. 각 Before 레이어의 이름, 역할, 순서, 객체 수를 확인합니다.
2. 오른쪽에서 올바른 After layer를 선택합니다.
3. 모든 항목에 선택이 있는지 확인합니다.
4. Confirm and Compare를 클릭해 다시 실행합니다.

PCBAtlas는 페어링이 모호할 때 레이어를 추측하지 않으며, 자동 이동／회전으로 두 보드를 강제로 맞추지도 않습니다. 보드 전체 이동이나 회전은 실제 변화로 남깁니다.

비교 대기 또는 취소

비교는 입력 검증, Before / After 가져오기, 레이어 페어링, 스냅샷, 기하 매칭, 리스크 분석, Diff scene, 영속화 진행을 차례로 표시합니다.

Cancel을 클릭한 뒤에는 Cancelling comparison…이 끝날 때까지 기다리세요. 두 native session과 임시 스테이징 데이터가 모두 해제된 뒤에야 페이지가 안전한 재시도를 허용합니다.

비교 워크스페이스 읽기

표시 모드

• Overlay: 하나의 정확한 합성 장면에 변화를 겹칩니다. Context는 변하지 않은 컨텍스트의 강도를 조절합니다.
• Split: 왼쪽이 Before, 오른쪽이 After입니다. 기본으로 Sync Camera가 켜져 있으며, 끄면 양쪽을 따로 볼 수 있습니다.
• Blink: 같은 카메라로 Before / After를 자동 전환하며, 작은 변위를 찾기 좋습니다.
• Fit: 현재 장면을 보이는 영역에 다시 맞춥니다.

레이어와 변화

• 왼쪽 Layer Pairs는 페어링 결과와 각 레이어 쌍의 변화 수를 보여 줍니다.
• All layers로 보드 전체를 보거나, 레이어 쌍 하나를 골라 범위를 줄입니다.
• 오른쪽 Changes는 Added / Removed / Modified를 켜고 끄고, 객체 유형과 Net으로 필터할 수 있습니다.
• 변화 행을 클릭하면 객체를 찾고 하이라이트합니다. Viewer에서 객체를 점 선택해도 해당 변화를 역으로 찾습니다.
• Previous / Next는 현재 필터 결과를 순서대로 봅니다. macOS 단축키는 ⌘[와 ⌘]입니다.
• Risks 패널은 방향성 힌트를 리스크 수준으로 필터합니다. 리스크 힌트는 검토 위치 찾기용이며 DRC나 제조 승인을 대신하지 않습니다.

방향 바꾸기, 내보내기, 다시 열기

• Swap은 반대 방향 요청을 만들고 다시 계산합니다. 원래 Added / Removed, 통계, 리스크, 상세는 방향과 함께 뒤집힙니다.
• JSON은 안정적이고 버전 관리되는 의미 결과를 내보냅니다. iOS는 파일을 다른 앱에 넘깁니다.
• PNG는 현재 Diff 보기 스크린샷을 내보냅니다. iOS는 Photos에 바로 저장하고, macOS는 시스템 파일 전달 UI를 계속 사용합니다.
• 호스팅 리비전 비교가 끝나면 Reopen Saved Comparison에서 검증된 결과를 다시 열 수 있습니다.
• 리비전 내용, 형식, 정책, 레이어 페어링이 바뀌면 이전 아티팩트는 무효로 처리되며, 오래된 결과를 조용히 보여 주지 않습니다.

와이드 셸과 내로우 셸

두 레이아웃 모두 라이브러리 문서 동작 메뉴에서 비교로 들어갑니다. 일반 Viewer의 Split을 Board Diff 대신 쓰지 마세요. 일반 프로젝트 Split은 PCB와 회로도 듀얼 캔버스이고, Diff의 Split은 Before와 After입니다. 좁은 창에서 비교 설정이나 결과 패널이 붐비면 창을 키운 뒤 읽으세요. 이번 검증은 내로우 셸 Diff 레이아웃을 확인하지 않았습니다.

검수 체크리스트

• 리비전이 하나뿐인 문서에서는 Compare Revisions…가 활성화되지 않습니다.
• 형식이 같은 라이브러리 리비전 두 개로 비교를 실행할 수 있고, Reopen Saved Comparison에서 다시 열 수 있습니다.
• 같은 입력, 다른 형식, 미지원 형식, SES base 불일치에서는 Compare가 막히고 분명한 이유가 표시됩니다.
• 모호한 레이어는 수동 페어링을 마친 뒤에야 계속할 수 있습니다.
• Overlay / Split / Blink를 바꿀 때 카메라 위치가 유지됩니다.
• Split의 Sync Camera 켜기／끄기 동작이 올바르고, Fit으로 보드 전체 보기를 복원할 수 있습니다.
• Added / Removed / Modified, 객체 유형, Net, 리스크 필터가 모두 결과를 줄입니다.
• 리스트 클릭, Viewer 점 선택, Previous / Next로 같은 변화를 양방향으로 찾을 수 있습니다.
• Swap 후 방향, 색, 통계, 상세, 리스크가 올바르게 뒤집힙니다.
• 큰 보드 비교를 중간에 취소한 뒤, 페이지가 정리를 기다리고 다시 비교할 수 있습니다.
• JSON과 PNG를 모두 내보낼 수 있고, 입력이 바뀐 뒤 호스팅 아티팩트가 잘못 재사용되지 않습니다.

현재 명시적 경계

• 같은 형식 입력만 비교하며, 교차 형식 비교는 지원하지 않습니다.
• ODB++, IPC-2581, Altium PCB／라이브러리, 전체 KiCad Project, 회로도 Diff, 3D Diff는 지원하지 않습니다.
• 자동 병합, 변화 수락, 원본 파일 역수정은 없습니다.
• 자동 정렬은 없으며, 보드 전체 이동과 회전은 보이는 차이로 남습니다.
• 이미지 픽셀, bbox, 파일 텍스트를 정확한 기하 Diff의 대체 수단으로 쓰지 않습니다.

자주 묻는 질문

왜 Compare 버튼을 쓸 수 없나요?

양쪽이 모두 선택되었는지, 내용이 다른지, 같은 지원 형식으로 해석되는지 확인하세요. Gerber / Excellon은 각 쪽에 완전한 패키지 폴더나 아카이브를 주어야 하며, 임의의 단일 레이어 파일 두 개로 전체 보드를 대신할 수 없습니다.

같은 확장자인데도 형식이 다르다고 하는 이유는 무엇인가요?

형식은 실제 해석 결과로 결정되며 파일 이름만 보지 않습니다. 디렉터리, 아카이브, SES 기초 설계, 실제 board entry가 모두 검증에 참여합니다.

취소 직후에 다시 비교할 수 없는 이유는 무엇인가요?

페이지는 PcbCore가 Before / After 두 세션과 임시 데이터를 해제할 때까지 기다려, 새 작업이 이전 작업과 동시에 자원을 쓰지 않게 합니다. Cancelling comparison…이 사라진 뒤 다시 시도하세요.

Swap 후에 변화 수나 리스크도 바뀐 이유는 무엇인가요?

Added / Removed와 리스크 힌트는 방향성이 있습니다. Swap은 표시 레이블만 바꾸는 것이 아니라 뒤집힌 Before / After로 다시 계산합니다.

결과

비교가 끝나면 같은 워크스페이스에서 양쪽의 정확한 변화를 찾고, 방향성 리스크를 확인하며, JSON / PNG를 내보낼 수 있습니다. 라이브러리 리비전 비교는 저장한 뒤 검증을 거쳐 다시 열 수도 있습니다.

최근 검증일

2026-07-30(원래 흐름 기록). 2026-09-11에는 라이브러리 진입점을 확인했고 비교는 다시 실행하지 않았습니다.