위젯 패널 사용법

ImEDA의 위젯 패널은 설계 작업을 보조하는 도킹 가능한 보조 창들입니다. 프로젝트 트리, 파일 관리자, 콘솔, 레이어 관리자, 속성 검사기 등 다양한 위젯을 자유롭게 배치하여 작업 환경을 구성할 수 있습니다. 위젯은 문서와 독립적으로 동작하며, 비동기 이벤트를 통해 문서와 통신합니다.

위젯 설계 원칙

모든 위젯은 문서 없이도 독립적으로 동작합니다. 문서가 열려 있지 않아도 위젯 패널은 정상적으로 표시되며, 문서가 열리면 비동기 이벤트를 통해 자동으로 동기화됩니다. 위젯 패널의 레이아웃과 상태는 세션 종료 시 자동 저장되어 다음 실행 시 복원됩니다.

프로젝트 트리

프로젝트 트리는 현재 작업 중인 프로젝트의 파일 구조를 계층적으로 표시하는 위젯입니다. 프로젝트 파일(.imprj)과 프로젝트 그룹(.imgrp)을 관리하며, 회로도, PCB, 심볼 라이브러리 등 설계 파일을 트리 형태로 탐색할 수 있습니다.

주요 기능

기능	설명
계층 구조 표시	프로젝트 그룹 → 프로젝트 → 파일 순서의 트리 구조로 표시됩니다. 회로도의 서브시트 계층도 트리에 반영됩니다.
파일 생성	프로젝트에 새 회로도(`.imsch`), PCB(`.impcb`), 심볼 라이브러리(`.imslib`) 등을 추가할 수 있습니다.
파일 삭제/이름 변경	트리에서 파일을 선택한 후 컨텍스트 메뉴를 통해 삭제하거나 이름을 변경합니다.
Active Project 설정	여러 프로젝트가 열려 있을 때, 특정 프로젝트를 Active로 설정하여 빌드/검증 대상을 지정합니다.
서브시트 구조	회로도의 계층 구조(Sheet → SubSheet)가 트리에 자동으로 반영됩니다. 더블클릭으로 해당 시트를 엽니다.

컨텍스트 메뉴

트리 항목을 우클릭하면 상황에 맞는 컨텍스트 메뉴가 표시됩니다. 메뉴 항목은 선택된 노드의 종류(프로젝트/파일/폴더)에 따라 달라집니다.

메뉴 항목	대상	설명
New File	프로젝트	프로젝트에 새 설계 파일을 추가합니다. 파일 종류를 선택하는 서브메뉴가 표시됩니다.
Rename	파일	선택한 파일의 이름을 변경합니다. 인라인 편집 모드로 전환됩니다.
Delete	파일	선택한 파일을 프로젝트에서 제거합니다. 실제 파일 삭제 여부를 확인합니다.
Open Folder	프로젝트/파일	해당 항목이 위치한 폴더를 시스템 파일 탐색기에서 엽니다.
Set as Active	프로젝트	선택한 프로젝트를 Active Project로 설정합니다.

프로젝트 트리 팁

트리 노드의 화살표를 클릭하면 하위 항목을 펼치거나 접을 수 있습니다. 파일을 더블클릭하면 해당 문서가 에디터에서 열립니다. 현재 열려 있는 파일(Cut/Delete 등이 비활성화됨)은 컨텍스트 메뉴에서 조건부로 표시됩니다. 빈 영역을 우클릭하면 프로젝트 생성 등의 배경 컨텍스트 메뉴가 표시됩니다.

파일 관리자

파일 관리자는 시스템 파일 시스템을 탐색하고 관리하는 위젯입니다. 프로젝트 폴더뿐만 아니라 임의의 디렉터리를 탐색할 수 있으며, 설계 파일을 직접 열거나 관리할 수 있습니다.

주요 기능

기능	설명
폴더 감시 (자동 갱신)	현재 표시 중인 폴더의 파일 변경을 실시간으로 감지하여 목록을 자동 갱신합니다. 외부에서 파일을 추가/삭제해도 즉시 반영됩니다.
SVN 연동	SVN 버전 관리 상태를 파일 목록에 표시합니다. 수정됨, 추가됨, 충돌 등의 상태 아이콘이 파일명 옆에 나타납니다.
휴지통 기능	파일 삭제 시 시스템 휴지통으로 이동합니다. 실수로 삭제한 파일을 복원할 수 있습니다.
드래그 & 드롭	파일을 드래그하여 다른 폴더로 이동하거나, 에디터 영역에 드롭하여 파일을 열 수 있습니다.
파일 복사/이동/삭제	선택한 파일에 대해 복사, 이동, 삭제 등 기본적인 파일 관리 작업을 수행합니다.

파일 관리자 팁

폴더 트리에서 경로를 선택하면 오른쪽 파일 목록이 해당 폴더의 내용으로 갱신됩니다. 설계 파일(.imsch, .impcb 등)을 더블클릭하면 해당 에디터에서 바로 열립니다. SVN 상태 표시는 SVN이 설치되어 있고 해당 폴더가 SVN 관리 하에 있을 때 자동으로 활성화됩니다.

콘솔

콘솔은 애플리케이션의 로그 메시지를 실시간으로 표시하는 위젯입니다. ERC 결과, 파일 변환 로그, 시스템 알림 등 다양한 메시지가 콘솔에 출력됩니다. 디버깅과 작업 상태 확인에 필수적인 위젯입니다.

로그 레벨

레벨	색상	용도
Info	기본	일반적인 작업 진행 상황, 파일 열기/저장 완료, 변환 결과 등의 정보 메시지입니다.
Warning	주황	잠재적 문제를 알리는 경고 메시지입니다. ERC 경고, 호환성 이슈, 누락된 라이브러리 등이 해당됩니다.
Error	빨강	작업 실패나 심각한 오류를 나타냅니다. 파일 읽기 실패, 변환 오류, ERC 에러 등이 해당됩니다.

콘솔 조작

기능	설명
복사	로그 텍스트를 선택하여 클립보드에 복사할 수 있습니다. 오류 보고 시 유용합니다.
지우기	콘솔의 모든 로그 메시지를 삭제합니다. 새 작업 시작 전 로그를 정리할 때 사용합니다.
로그 필터링	Info, Warning, Error 레벨별로 메시지를 필터링하여 표시할 수 있습니다. 특정 레벨의 메시지만 확인할 때 유용합니다.

콘솔 활용 팁

ERC를 실행하면 결과가 콘솔에 출력됩니다. Error 레벨로 필터링하면 심각한 문제만 빠르게 확인할 수 있습니다. 파일 변환(KiCad, Altium 등) 시에도 변환 과정과 결과가 콘솔에 상세히 기록되므로, 변환 후 콘솔 로그를 확인하는 습관을 들이면 문제를 빠르게 발견할 수 있습니다.

레이어 관리자

레이어 관리자는 PCB 에디터에서 레이어의 가시성, 색상, 활성 상태를 관리하는 위젯입니다. PCB 설계에서는 다수의 레이어를 사용하므로, 레이어 관리자를 통해 필요한 레이어만 표시하고 작업 대상 레이어를 빠르게 전환할 수 있습니다.

레이어 그룹

그룹	레이어	설명
동박 (Copper)	`CU_FR`, `CU_IN_1`~`CU_IN_60`, `CU_BK`	전면/내층/후면 동박 레이어입니다. 전기적 배선이 이루어지는 핵심 레이어입니다.
실크 (Silkscreen)	`SILK_FR`, `SILK_BK`	PCB 표면에 인쇄되는 텍스트, 심볼, 외곽선 등을 표시합니다.
솔더마스크 (Solder Mask)	`SM_FR`, `SM_BK`	솔더링 영역을 정의합니다. 마스크가 제거된 부분에 솔더링이 이루어집니다.
페이스트 (Paste)	`PASTE_FR`, `PASTE_BK`	SMD 부품의 솔더 페이스트 도포 영역을 정의합니다.
풋프린트 (Fabrication)	`CRTYD_FR/BK`, `FAB_FR/BK`	부품 외곽(Courtyard)과 제조 참조선(Fabrication)을 표시합니다.
기타	`BOARD_OUTLINE`, `DIM_FR/BK`, `USER_1`~`USER_16`	보드 외곽선, 치수, 사용자 정의 레이어입니다.

주요 기능

기능	설명
가시성 토글	각 레이어의 눈 아이콘을 클릭하여 표시/숨김을 전환합니다. 숨겨진 레이어의 객체는 화면에 표시되지 않습니다.
색상 변경	레이어 색상 사각형을 클릭하면 색상 선택기가 열립니다. Color Table의 Named Color를 사용하여 일관된 색상 테마를 유지합니다.
활성 레이어 선택	레이어를 클릭하여 활성(Active) 레이어로 설정합니다. 새로 그리는 객체는 활성 레이어에 배치됩니다.

레이어 관리 팁

작업 중인 레이어만 표시하면 복잡한 PCB에서도 편집이 용이합니다. 레이어 그룹 단위로 가시성을 일괄 전환할 수 있어, 예를 들어 모든 동박 레이어를 한 번에 숨기거나 표시할 수 있습니다. Color Table을 변경하면 모든 레이어의 색상이 즉시 갱신됩니다.

속성 검사기 (Object Inspector)

속성 검사기는 현재 선택된 객체의 속성을 표시하고 편집할 수 있는 위젯입니다. 선, 부품, 핀, 텍스트 등 모든 설계 객체의 속성을 실시간으로 확인하고 수정할 수 있습니다. 선택이 변경될 때마다 자동으로 해당 객체의 속성이 표시됩니다.

속성 그룹

속성은 논리적 그룹으로 분류되어 순서대로 표시됩니다. 각 그룹은 구분선으로 나뉩니다.

그룹	대표 속성	설명
Identity	Type, Unit, Layer	객체의 기본 식별 정보입니다. 타입은 읽기 전용입니다.
Position	Position, Start, End, Center, Radius, Angle	객체의 위치와 기하학적 정보입니다. 좌표값을 직접 입력하여 정밀 배치할 수 있습니다.
Values	Text, Direction, Flip	객체의 값과 방향 정보입니다.
Appearance	Line Width, Line Style, Font	객체의 시각적 스타일 설정입니다.
Colors	Stroke Color, Fill Color, Font Color	객체의 색상 속성입니다. 색상 선택기를 통해 변경합니다.
Symbol	Library, Name, Reference, Value	심볼/부품 관련 속성입니다. Reference와 Value는 직접 편집 가능합니다.
PCB Pad	Pad Number, Type, Shape, Drill	PCB 패드의 물리적 속성입니다.

주요 기능

기능	설명
단위 변환	좌표와 길이 필드는 현재 설계 단위(mil 또는 mm)로 표시됩니다. 입력 시 다른 단위를 지정하면 자동 변환됩니다 (예: `2.54mm` 입력 → mil 단위로 변환).
색상 선택기	색상 속성을 클릭하면 색상 선택기가 열립니다. Named Color를 사용하면 Color Table 변경 시 자동으로 업데이트됩니다.
다중 선택 편집	여러 객체를 선택하면 공통 속성만 표시됩니다. 값을 변경하면 선택된 모든 객체에 동시에 적용됩니다.
Bool 속성	가시성, 채움 여부 등의 Boolean 속성은 토글로 표시됩니다.

속성 검사기 팁

좌표/길이 필드에 단위를 명시하면 자동 변환됩니다. 예를 들어 설계 단위가 mil일 때 2.54mm를 입력하면 자동으로 100.0 mil로 변환됩니다. 다중 선택 시 서로 다른 값을 가진 속성은 빈 칸으로 표시되며, 새 값을 입력하면 모든 선택 객체에 일괄 적용됩니다.

위젯 요약

위젯	주요 용도	관련 에디터
프로젝트 트리	프로젝트 파일 구조 관리, 파일 열기/생성/삭제	전체
파일 관리자	파일 시스템 탐색, SVN 연동, 드래그&드롭	전체
콘솔	로그 출력, ERC 결과 확인, 디버깅	전체
레이어 관리자	레이어 가시성/색상/활성 상태 관리	PCB, Footprint
속성 검사기	선택 객체 속성 편집, 단위 변환, 색상 설정	전체