🔬 PACS Viewer — 사용 가이드
대상 Dr. Portal 이용 의료진
버전 1.0 · eGHIS
URL eghislab.com/pacs-viewer.html
1. 개요
PACS Viewer는 로컬 DICOM 파일과 일반 이미지(JPG/PNG)를 브라우저에서 바로 열람·판독할 수 있는 웹 뷰어입니다.
별도 프로그램 설치 없이 Chrome / Edge에서 작동하며, 외부 서버로 파일이 전송되지 않습니다 (AI 판독 시 API 호출 제외).
- ✅ DICOM (.dcm / .dicom / 확장자 없음) 로컬 뷰어 — Cornerstone Legacy 기반
- ✅ JPG / PNG / WebP / BMP 로드 + DICOM Secondary Capture로 변환
- ✅ W/L · Pan · Zoom · 거리·각도·ROI 측정
- ✅ 1 / 2 / 4매 레이아웃 · 멀티 셀 개별 조작
- ✅ AI 판독 — Gemini / OpenAI / Claude (BYOK) · 모달리티별 전용 프롬프트
- ✅ 판독지 PDF 저장 · 클립보드 복사
- ✅ 태그 오버레이 ON/OFF — 개인정보 보호 게이트
- ✅ 4가지 색상 테마 · 글자 크기 ±7% 조절
2. 시작하기 — 파일 불러오기
영상을 여는 방법은 3가지입니다:
- 📂 파일 열기 — 좌측 상단 버튼 또는 툴바의 "파일 열기" 클릭 → 다중 선택 가능
- 📁 폴더 열기 — 폴더 전체 선택. 하위 DICOM·이미지 자동 인식
- 드래그 & 드롭 — 파일을 좌측 패널(또는 화면 어디든) 끌어놓기
- Ctrl + V (붙여넣기) — 스크린샷·클립보드 이미지 즉시 로드
📥 인식 규칙
· .dcm · .dicom · 확장자 없는 파일 → DICOM
· .jpg · .jpeg · .png · .webp · .bmp → 일반 이미지 (DICOM 변환 가능)
로드된 파일은 좌측 썸네일 리스트에 표시됩니다. DICOM은 🔬 아이콘, 일반 이미지는 IMG 뱃지로 구분됩니다. 썸네일 클릭으로 활성 셀에 표시, ✕로 개별 제거, 비우기 버튼으로 전체 초기화.
우측 뷰어 상단 툴바에서 조작합니다. 각 도구는 좌클릭 드래그로 작동하며, 항상 우클릭=Zoom · 휠클릭=Pan이 보조로 활성됩니다.
| 도구 | 기능 | 단축키 |
|---|
| W/L | Window / Level 조절 (명암) | W |
| Pan | 영상 이동 (드래그) | P |
| 🔍＋ / 🔍－ | 단계적 확대 / 축소 (25%) | + / − |
| 거리 | 두 점 사이 거리 측정 (mm, DICOM pixelSpacing 반영) | — |
| 각도 | 3점 각도 측정 | — |
| ROI | 직사각형 관심영역 — 평균·표준편차·면적 | — |
| Invert | 명암 반전 | I |
| Rotate | 시계방향 90° 회전 | R |
| Reset | W/L · Zoom · 회전 모두 초기화 | 0 |
| Fit | 셀 크기에 맞춰 자동 조정 | F |
| 측정지우기 | 현재 셀의 거리·각도·ROI 모두 삭제 | — |
💡 팁
W/L 중에도 우클릭 드래그로 바로 Zoom, 휠클릭 드래그로 Pan을 즉시 쓸 수 있습니다.
4. 레이아웃 · 셀 전환
툴바 우측의 ▢ ▢▢ ▣ 버튼으로 1매 / 2매(좌우) / 4매(2×2) 분할을 바꿉니다.
- 셀을 클릭해 활성화 (주황색 테두리) — 도구는 활성 셀에만 적용
- ← → 키로 같은 셀에서 다음/이전 영상 순차 탐색
- 좌측 썸네일 클릭 시 활성 셀에 해당 영상이 로드됨
5. 태그 오버레이 ON/OFF
DICOM 영상은 4코너에 환자·검사 정보가 자동 표시됩니다:
- 좌상단 (TL) · 환자명 · ID · 성별/나이
- 우상단 (TR) · 기관 · 검사일시 · 모달리티/부위/View · Study/Series 설명
- 좌하단 (BL) · 영상 해상도 (W × H)
- 우하단 (BR) · 제조사 · 모델 · Station 이름
한국 PACS가 자주 쓰는 euc-kr / IR 149 인코딩 한글도 자동으로 복원됩니다.
🏷 태그 ON/OFF 버튼 (단축키 T)
뷰어 툴바 오른쪽의 토글 버튼으로 태그 표시를 제어합니다.
AI 판독은 태그 OFF 상태에서만 실행됩니다 — 개인정보 보호를 위한 필수 절차입니다.
6. 전체보기 모드
툴바의 ⛶ 전체보기 버튼 또는 F11 키로 진입합니다. 전체보기에서는 헤더·툴바·좌측 리스트가 숨겨지고 뷰어만 100%로 확대됩니다. Esc 또는 ⤢ 버튼으로 복귀.
7. JPG/PNG → DICOM 변환
일반 이미지를 DICOM 표준 파일로 변환하여 다운로드할 수 있습니다 (Secondary Capture Image Storage SOP).
- JPG/PNG 이미지를 로드 (드래그 / 클립보드 붙여넣기 / 파일 열기)
- 좌측 썸네일의 🧾 DICOM 버튼 클릭
- 태그 입력 모달에서 환자·검사 정보 입력
- 환자명·ID·성별·생년월일
- 검사일(YYYYMMDD)·검사시각·모달리티(OT/SC/CR/DX/MG/US/CT/MR/XA/ES)
- Accession No.·부위·View·기관·Study Desc·Series Desc
- 💾 DICOM 생성·다운로드 클릭 →
.dcm 파일 즉시 저장
| DICOM 규격 | 값 |
|---|
| SOP Class UID | 1.2.840.10008.5.1.4.1.1.7 (Secondary Capture) |
| Transfer Syntax | 1.2.840.10008.1.2.1 (Explicit VR Little Endian) |
| Photometric Interpretation | RGB · 8bit 비압축 |
| Character Set | ISO_IR 192 (UTF-8 · 한글 안전) |
| UID 생성 | Study · Series · SOPInstance 모두 자동 발급 |
| 파일명 | SC_<환자명>_<검사일>_<id>.dcm |
💡 활용 예시
외부 카메라 촬영본·스크린샷·스캔본을 PACS에 영상 자료로 등록할 때 유용합니다. 대부분의 PACS가 Secondary Capture를 수용합니다.
8. AI 판독 (Gemini · OpenAI · Claude)
현재 셀의 영상을 3대 AI provider 중 하나로 전송하여 자동 판독지를 생성합니다. BYOK(Bring Your Own Key) 방식으로 각자 API 키를 사용합니다.
1 최초 1회 설정
- 뷰어 툴바의 🤖 AI 판독 버튼 클릭
- 제공자 선택 (Claude / OpenAI / Gemini)
- 각 provider의 API 키 입력 → 💾 저장 (보안 정책상 외부 공급자 대시보드 링크는 제공하지 않음)
- 키는 브라우저 sessionStorage에만 저장되며 외부 전송되지 않습니다. 탭 종료·페이지 이탈·로그아웃 시 자동 삭제됩니다.
2 판독 실행
- 영상 선택 후 태그 OFF로 전환 (T 또는 🏷 버튼)
- 🤖 AI 판독 버튼 (또는 Ctrl+Alt+A)
- 판독 유형 확인 — 기본 자동 감지 (모달리티/부위 태그 기반). 필요 시 14종 중 수동 선택
- 🔬 AI 판독 생성 클릭 → 수 초 내 결과 표시
3 지원 판독 유형 (14종)
| 유형 | 특징 |
|---|
| 흉부 X선 (PA/측면) | 심장음영·폐야·CP angle·늑골 구조적 판독 |
| 유방촬영 (Mammo) | BI-RADS 카테고리 · 유선조직 밀도 |
| 복부 초음파 | 간·담낭·췌장·비장·신장 장기별 |
| 유방 초음파 | BI-RADS · 시계방향 위치·도플러 |
| 갑상선 초음파 | K-TIRADS 카테고리 · FNA 기준 |
| 위 내시경 (EGD) | 식도·LA grade·위체·유문·십이지장 |
| 대장 내시경 | Paris 분류·JNET/NICE·재검 간격 |
| 골·관절 X선 | 골절·관절·정렬·연부조직 |
| CT / MRI | 장기별 체계 기술 |
| 심전도 (ECG) | Rate·Rhythm·Axis·ST-T |
| 피부 병변 | ABCDE 기준 · 전문의 대면 권고 |
| 일반 의료영상 | 기본 구조 판독 |
4 결과 편집 · 재생성
생성된 판독지는 자유롭게 편집할 수 있습니다. 수정 후 PDF/복사 가능. 🔄 재생성 버튼으로 같은 조건 재호출.
9. 판독지 저장 — PDF · 클립보드
📄 PDF 저장
- 구성: 제목 → 생성일·모델 → 면책 경고 → 환자·검사 정보 → 영상 이미지 → 판독지 본문 → 하단 면책 고지
- 파일명:
AI판독_<환자명>_<검사일>.pdf
- A4 세로 · 해상도 2× 스케일
📋 클립보드 복사
- 판독지 본문의 상단·하단에 면책 고지가 자동 삽입된 상태로 복사됨
- EMR/카톡/메모장 등 어디에 붙여넣더라도 경고문이 함께 따라감
10. 개인정보 보호 · 면책 사항
🛑 AI 판독 — 태그 OFF 필수
태그 ON 상태에서는 AI 판독이 구조적으로 차단됩니다. 환자명·ID·생년월일 등 PHI(보호 대상 건강정보)가 화면에 표시된 상태에서 외부 AI로 영상을 전송하는 것을 방지합니다.
⚠ AI 판독 결과 사용 제한
본 AI 판독은 보조 참고 자료이며 최종 진단·판독의 법적·의료적 책임은 담당 의료진 본인에게 있습니다. 결과를 수정 없이 공식 진료기록·진단서·판독지로 사용·기재·제출할 수 없습니다. 반드시 직접 영상을 재확인하고 임상 상관을 통해 독립적으로 판단·서명하십시오.
📁 데이터 흐름
· DICOM/이미지 파일 — 사용자 브라우저 내에서만 처리 (외부 전송 없음)
· AI 판독 — 영상 캡처본이 선택한 provider(Gemini/OpenAI/Claude) 서버로 전송됨 (태그는 제외)
· API 키 — 브라우저 localStorage에만 저장, 서버 전송 없음
11. 단축키 모음
| 키 | 기능 |
|---|
| W | W/L 도구 |
| P | Pan 도구 |
| I | 명암 반전 |
| R | 90° 회전 |
| F | Fit (창에 맞춤) |
| 0 | Reset (초기화) |
| + / − | 영상 확대 / 축소 |
| ← / → | 전 / 다음 영상 |
| T | 태그 오버레이 ON/OFF |
| F11 | 전체보기 토글 |
| Esc | 전체보기 복귀 · 모달 닫기 |
| Ctrl+V | 클립보드 이미지 붙여넣기 |
| Ctrl+Alt+A | AI 판독 모달 열기 |
| Ctrl+ + / − / 0 | 글자 크기 조절 / 초기화 |
| Ctrl+Alt+ 1~4 | 테마 전환 |
12. 자주 묻는 질문
Q1. 파일을 끌어놓았는데 인식이 안 됩니다.
DICOM 파일의 경우 확장자가 숨겨진 경우가 많습니다. 좌측 로더가 자동으로 확장자 없음/`.dcm`/`.dicom` 파일을 모두 받으니, 여전히 인식되지 않으면 파일 크기가 132바이트 미만인 손상 파일일 가능성이 큽니다.
Q2. 한글 환자명이 깨져 보입니다.
한국 PACS의 일부 장비는 SpecificCharacterSet을 잘못 선언합니다. 본 뷰어는 IR 149 / euc-kr 폴백을 시도하므로 대부분 자동 복원됩니다. 그래도 깨지면 원본 DICOM의 태그 자체가 비어있는 경우입니다.
Q3. AI 판독 버튼이 비활성화됩니다.
태그 오버레이가 ON 상태입니다. 툴바의 🏷 태그 ON 버튼을 클릭(또는 T 키)해 OFF로 전환하면 활성화됩니다.
Q4. AI 판독 응답이 느리거나 실패합니다.
- API 키 오타 · 잔액 부족 · 모델 접근권한 확인
- Gemini 무료: 분당 15회 / 일 1,500회 제한
- 네트워크 오류 시 재생성 버튼 사용
Q5. 변환한 DICOM을 다시 확인하려면?
다운로드한 .dcm 파일을 뷰어에 다시 드래그하면 원본과 동일하게 로드됩니다. 태그가 올바르게 기록되었는지 4코너 오버레이로 검증 가능합니다.
Q6. 전체보기에서 모니터 간 이동이 안 됩니다.
브라우저 전체화면 API는 단일 모니터로 제한됩니다. 듀얼 모니터 활용은 판독열람 → 외부 DICOM 뷰어 팝업 기능을 사용하세요.