라이브러리 관리자

ImEDA의 라이브러리 관리자는 심볼과 풋프린트를 검색, 미리보기, 설치/제거할 수 있는 통합 관리 도구입니다. 속성 검사기(Object Inspector)와 Symbol-Footprint Mapper를 통해 부품 속성 편집과 매핑 작업까지 지원합니다.

심볼 라이브러리 관리자

심볼 라이브러리 관리자(SCHLIB Manager)는 심볼 라이브러리 파일(.imslib)을 관리하는 위젯입니다. 라이브러리에 포함된 심볼을 검색하고, 미리보기를 통해 확인한 뒤 회로도에 배치할 수 있습니다.

주요 기능

기능	설명
키워드 검색	심볼 이름, Reference, Value 등 텍스트 기반 검색. 입력 즉시 필터링됩니다.
AI 시맨틱 검색 AI	자연어로 부품을 검색합니다. 예: "8핀 오퍼앰프" → 관련 심볼 목록 반환. RAG VectorDB 기반으로 정확한 의미 매칭을 수행합니다.
심볼 미리보기	선택한 심볼을 캔버스에 실시간 렌더링하여 핀 배치와 바디 형상을 확인합니다.
라이브러리 설치/제거	`.imslib` 파일을 라이브러리 목록에 등록하거나 해제합니다.
심볼 배치	미리보기에서 선택한 심볼을 더블클릭하여 현재 회로도에 즉시 배치합니다.

라이브러리 파일 관리

항목	설명
파일 확장자	`.imslib` / `.imsym` (레거시: `.slib`, `.csislib`)
ContentType	SlibDocument (2)
저장 위치	프로젝트 로컬 또는 글로벌 라이브러리 경로
구조	1 파일 = N 심볼 (다중 심볼 라이브러리)

AI 시맨틱 검색 사용 팁

키워드 검색으로 찾기 어려운 부품은 자연어 설명으로 검색하세요.
핀 수, 패키지 타입, 기능 설명 등을 조합하면 더 정확한 결과를 얻을 수 있습니다.
예: "dual channel MOSFET driver", "16비트 ADC SPI 인터페이스"

풋프린트 라이브러리 관리자

풋프린트 라이브러리 관리자(FPLIB Manager)는 풋프린트 라이브러리 파일(.imflib)을 관리하는 위젯입니다. PCB 설계에 사용할 풋프린트를 검색하고, 3D 미리보기로 확인한 뒤 선택할 수 있습니다.

주요 기능

기능	설명
키워드 검색	풋프린트 이름, 패키지 타입 등 텍스트 기반 필터링. 입력 즉시 결과가 갱신됩니다.
풋프린트 미리보기 (3D)	선택한 풋프린트를 3D 뷰로 렌더링하여 패드 배치, 실크스크린, 외곽선을 확인합니다.
라이브러리 설치/제거	`.imflib` 파일을 라이브러리 목록에 등록하거나 해제합니다.
풋프린트 선택	심볼에 연결할 풋프린트를 선택하는 다이얼로그를 제공합니다.

라이브러리 파일 관리

항목	설명
파일 확장자	`.imflib`
ContentType	FpDocument (3) 기반 라이브러리 DB
개별 풋프린트	`.imfp` (레거시: `.fp`, `.pcblib`)
구조	SQLite 기반 라이브러리 데이터베이스

풋프린트 검색 다이얼로그

심볼 편집 중 풋프린트를 연결할 때, 풋프린트 검색 다이얼로그(GetFootprint Dialog)가 열립니다. 등록된 모든 라이브러리에서 풋프린트를 검색하고, 3D 미리보기를 통해 올바른 패키지를 선택할 수 있습니다.

속성 검사기 (Object Inspector)

속성 검사기는 선택한 객체의 속성을 표시하고 편집할 수 있는 위젯입니다. 심볼, 풋프린트, 회로도/PCB 아이템 등 모든 문서 객체의 속성을 통합된 인터페이스로 관리합니다.

속성 편집 기능

기능	설명
속성 표시	선택한 객체의 모든 속성을 그룹별로 정렬하여 표시합니다.
인라인 편집	속성값을 직접 클릭하여 편집합니다. 텍스트, 숫자, 불리언, 색상 등 타입별 전용 에디터를 제공합니다.
단위 변환	좌표/길이 필드에서 `mil`과 `mm` 간 자동 변환을 지원합니다.
색상 선택기	색상 속성 클릭 시 컬러 팔레트가 열리며, Named Color와 커스텀 색상을 선택할 수 있습니다.

속성 표시 순서

속성은 다음 그룹 순서로 정렬됩니다. 각 그룹 내에서는 정의된 display order에 따라 배치됩니다.

순서	그룹	대표 속성
1	Identity	item_type, dispunit, itemlayer
2	Net Name	net_name
3	Position	position, center, start, end, radius, angle
4	Values	text_value, direction, flip, port_type
5	Appearance	line_width, line_style, font_*
6	Colors	stroke/fill/font_color
7	Pin	pin_visible, pinname, pinnumber, elec, shape
8	Symbol	sym_type, library, name, reference, value
9	PCB Pad	pad_number, type, shape, drill

단위 변환

단위 입력 규칙

좌표/길이 필드는 현재 설계 단위로 값이 표시됩니다 (예: 100.0 mil).
다른 단위로 입력하면 자동 변환됩니다 (예: 2.54mm 입력 → 100.0 mil로 변환).
단위 없이 숫자만 입력하면 현재 설계 단위로 해석됩니다.

Symbol-Footprint Mapper

Symbol-Footprint Mapper는 심볼과 풋프린트 간의 매핑을 관리하는 다이얼로그입니다. 라이브러리의 각 심볼에 올바른 풋프린트를 연결하고, 핀-패드 매핑을 검증하여 설계 오류를 사전에 방지합니다.

매핑 관리

기능	설명
트리 구조 탐색	라이브러리 → 심볼 → 풋프린트 계층을 트리 노드로 탐색합니다. Arrow 클릭으로 노드를 확장/축소합니다.
심볼 테이블 (3컬럼)	각 심볼의 매핑 상태를 한눈에 파악할 수 있는 테이블입니다. Name — 심볼 이름 FP — 연결된 풋프린트 Status — 매핑 검증 상태 (Valid / Warning / Error)
더블클릭 FP 선택	심볼 행을 더블클릭하면 풋프린트 검색 다이얼로그가 열려 즉시 풋프린트를 선택할 수 있습니다.
핀-패드 검증	심볼의 핀 번호와 풋프린트의 패드 번호가 올바르게 대응하는지 자동 검증합니다.

컨텍스트 메뉴

심볼 또는 매핑 항목을 우클릭하면 컨텍스트 메뉴가 열립니다.

메뉴 항목	설명
FP 자동선택	심볼의 Footprint 필드 값 또는 패키지 정보를 기반으로 가장 적합한 풋프린트를 자동으로 선택합니다.
FP 검증	현재 매핑된 풋프린트와 심볼 간의 핀-패드 대응을 검증하고 결과를 Status 컬럼에 반영합니다.
FP 변경	풋프린트 검색 다이얼로그를 열어 다른 풋프린트로 변경합니다.
매핑 제거	현재 심볼의 풋프린트 매핑을 해제합니다.

검증 상태

상태	아이콘	설명
Valid	✔	모든 핀-패드 매핑이 올바르게 대응합니다.
Warning	⚠	일부 핀에 대응하는 패드가 없거나, 미사용 패드가 존재합니다.
Error	✘	풋프린트가 지정되지 않았거나, 핀-패드 불일치가 심각합니다.
Unmapped	—	풋프린트가 아직 연결되지 않은 상태입니다.

매핑 워크플로우

심볼 라이브러리(.imslib)를 열고 Mapper 다이얼로그를 실행합니다.
트리에서 매핑할 심볼을 선택합니다.
더블클릭 또는 컨텍스트 메뉴 → FP 변경으로 풋프린트를 선택합니다.
Status 컬럼에서 검증 결과를 확인합니다.
Warning/Error가 있으면 핀 번호를 수정하거나 다른 풋프린트를 선택합니다.
모든 매핑이 Valid 상태가 되면 라이브러리를 저장합니다.

FP 자동선택 동작 원리

심볼의 Footprint 필드에 값이 있으면 해당 이름으로 풋프린트를 검색합니다.
필드가 비어있으면 Package 필드 또는 심볼 이름에서 패키지 정보를 추출하여 매칭을 시도합니다.
자동선택 결과는 반드시 검증 단계를 거쳐 핀-패드 대응을 확인해야 합니다.