DICOM 플러그인
DicomPlugin으로 의료 이미지를 보기
DICOM 플러그인은 Doconut에 의료 이미지 보기 기능을 추가합니다: 다중 프레임 DICOM 파일은 애니메이션 개요, 개별 프레임, 또는 두 가지 모두로 렌더링됩니다. DICOM은 플러그인 전용 포맷이며 — 이 플러그인(및 라이선스 기능)이 없으면 .dcm 파일을 전혀 열 수 없습니다.
.NET Framework 4.7.2에서 DICOM 파일은 페이지, 프레임 및 애니메이션까지 완전히 렌더링됩니다 — 하지만 기술 메타데이터(DICOM 태그)는 사용할 수 없습니다.
Viewer.GetDicomMetadataAsync는 항상null를 반환하고, 뷰어의 메타데이터 요청(?token=…&meta=1onDocImage.axd)은404로 응답하므로 뷰어에 DICOM 속성 패널이 표시되지 않습니다. 태그가 필요하면Doconut.NET8를 사용하십시오.
| 구성 요소 | 사용 시점 |
|---|---|
Viewer with DicomConfig (C#) | 서버에서 DICOM 파일을 열고 프레임이 어떻게 표시될지 선택합니다 |
뷰어(docViewer) on DocImage.axd | 페이지에 연구를 표시합니다: 애니메이션 및 프레임 |
플러그인 자체 위젯은 없습니다: DICOM 파일은 일반 뷰어에서 열립니다. 컨버터 플러그인도 등록하면, .dcm 및 .ima 파일을 Pdf, Png, Jpeg, Bmp, Tiff 또는 Gif 로 변환할 수 있습니다; 이 변환에는 Dicom 기능도 필요합니다.
패키지 설치
Install-Package Doconut.NETFramework.Dicom이 문서에서 설명하는 릴리스에 플러그인을 고정하려면:
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0Doconut.NETFramework와 동일한 버전으로 DICOM 패키지를 유지하십시오.
플러그인의 라이선스 파일인 Doconut.Viewer.Dicom.lic는 뷰어 라이선스와 함께 읽히도록 Doconut.Viewer.lic와 같은 폴더에 넣어야 합니다.
플러그인 등록
Doconut.DoconutHost.Initialize(options =>
{
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});플러그인(Name: "Doconut DICOM Viewer")은 .dcm 및 .ima 확장자를 위한 뷰어를 등록하며, 이는 Dicom 기능에 의해 제한됩니다. 라이선스가 이를 부여하지 않으면, DoconutHost.Initialize가 Application_Start에서 예외를 발생시킵니다:
The Dicom plugin is registered via AddPlugin but no active license grants Dicom. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Dicom.System.Web에서는 모든 요청이 빈 500로 응답한다는 의미이며, 이유는 Windows 이벤트 로그(소스 ASP.NET)에만 기록됩니다. 라이선스가 없거나, 레거시 TRIAL 파일이 있거나, Dicom가 없는 라이선스이거나, 버전 기간 외에 사용된 유료 라이선스인 경우 예외가 발생합니다. 임시 Demo/NFR 라이선스도 허용됩니다. 라이선스 설정을 참조하십시오.
내장 뷰어가 이러한 형식을 처리하지 못하기 때문에, 해당 기능이 나중에 사용할 수 없게 되면 파일을 여는 것이 즉시 실패합니다:
LicenseException: This document type requires the 'Dicom' plugin license.라이선스 및 워터마크
| 라이선스 상태 | 시작 시점 | DICOM 출력 |
|---|---|---|
버전 기간 내에 Dicom를 부여하는 유료 라이선스 | 시작 | 일반 페이지 워터마크 규칙에 따라 렌더링됩니다 |
| 활성 임시(Demo/NFR) 라이선스 | 시작 | 평가 워터마크와 함께 렌더링됩니다 |
라이선스 없음, 레거시 TRIAL 파일, Dicom가 없는 라이선스, 또는 버전 기간 외의 유료 라이선스 | Application_Start가 예외를 발생시키고; 모든 요청이 빈 500로 응답합니다 | — |
일반 페이지 워터마크 결정은 DICOM 출력에도 적용됩니다. 애니메이션 출력의 경우 각 GIF 프레임에 워터마크가 찍히므로 재생 전체에 걸쳐 표시됩니다. 맞춤형 DocOptions.Watermark은 라이선스가 맞춤 워터마크를 허용할 때만 사용되며, 평가 워터마크를 대체할 수 없습니다.
C#에서 사용하기
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
DisplayMode = DicomDisplayMode.AnimationAndFrames
});var metadata = await viewer.GetDicomMetadataAsync(token);
// .NET Framework에서는 이것이 항상 null이며, DICOM 메타데이터 리더를 사용할 수 없습니다.
// target. 페이지, 프레임 및 애니메이션이 정상적으로 렌더링됩니다.이 메서드는 .NET 8 패키지와 공유되는 코드가 컴파일되도록 이 패키지에 존재하지만, DICOM 태그를 읽으려면 .NET Framework 빌드가 없는 구성 요소가 필요합니다. 결과가 null인 경우와 같이 메타데이터 패널을 숨기는 등 사용자 인터페이스를 계획하십시오.
디스플레이 모드 및 해상도
디스플레이 모드
멀티프레임 DICOM 파일은 세 가지 방법으로 표시될 수 있습니다 (DicomDisplayMode):
| 모드 | 생성된 페이지 | 용도 |
|---|---|---|
AnimationOnly | 페이지 1 = 모든 프레임을 순환하는 애니메이션 GIF | 빠른 시네마틱 검토 |
FramesOnly | 페이지 1..N = 프레임당 하나의 정적 PNG | 프레임별 진단 탐색 |
AnimationAndFrames (기본) | 페이지 1 = 애니메이션 GIF, 페이지 2..N+1 = 프레임당 하나의 정적 PNG (N = 프레임 수) | 하나의 문서에 개요와 세부 정보 |
애니메이션 타이밍은 AnimationFrameDelayMs (기본값 100 ms = 10 FPS; GIF 타이밍은 10 ms 단위 사용)와 LoopCount (0 = 무한 반복)으로 제어됩니다.
뷰어는 페이지 1이 애니메이션인지 확인하기 위해 해당 페이지에 대해 HEAD 요청을 보냅니다. 따라서 DocImage.axd 핸들러는 HEAD을 Web.config에서 받아들여야 합니다 (verb="GET,HEAD,POST", 설치); 이것이 없으면 IIS가 Doconut이 실행되기 전에 404으로 응답하고 애니메이션 감지가 작동하지 않습니다.
해상도
DicomConfig는 기본적으로 축당 100 DPI로 렌더링됩니다. HorizontalResolution/VerticalResolution를 명시적으로 설정하지 않으면, 해당 값이 설정된 경우 BaseConfig.ImageResolution를 따르고, 그 이후에 100으로 되돌아갑니다.
// 기본 속성을 통한 균일 버프…
new DicomConfig { ImageResolution = 150 };
// …또는 축별 제어
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };자체 프론트엔드 구축
페이지 이미지(애니메이션 첫 페이지 포함)는 표준 DocImage.axd 이미지 경로를 사용합니다. 메타데이터 요청인 GET /DocImage.axd?token=<token>&meta=1는 메타데이터 리더를 사용할 수 없기 때문에 이 패키지의 모든 문서( DICOM 파일 포함) 에 대해 404로 응답합니다.
프로덕션 환경에서
멀티프레임 연구는 애니메이션과 프레임당 하나의 정적 페이지를 모두 생성할 수 있습니다. AnimationAndFrames는 가장 풍부한 탐색을 제공하지만 렌더링 및 메모리 비용도 가장 높으며, 단일 서버에서는 해당 메모리가 IIS 워커 프로세스에 속합니다. 대규모 연구의 경우:
- 프레임 검사가 재생보다 중요할 때
FramesOnly를 사용하십시오; - 메모리를 측정하지 않고 해상도 축을 모두 높이는 것을 피하십시오;
- 연구가 더 이상 열려 있지 않을 때 세션을 명시적으로 닫으십시오;
- 반복 접근이 보존된 이미지의 가치를 가질 때만
CachePages를 켜 두십시오.
모든 서버에서 Doconut.Viewer.Dicom.lic를 Doconut.Viewer.lic 옆에 배치하고, 핸들러의 verb 목록에 HEAD를 유지하십시오.
API 레퍼런스
DicomConfig, DicomDisplayMode 및 DicomMetadata는 Doconut 네임스페이스에 있습니다. DicomPlugin는 Doconut.Plugins.Dicom에 있습니다. 전체 DicomConfig 속성 표는 포맷 구성에 있습니다.
DicomConfig
public sealed class DicomConfig : BaseConfig
{
public int HorizontalResolution { get; set; } // default: ImageResolution이 설정된 경우, 그렇지 않으면 100
public int VerticalResolution { get; set; } // default: ImageResolution이 설정된 경우, 그렇지 않으면 100
public int AnimationFrameDelayMs { get; set; } = 100;
public ushort LoopCount { get; set; } = 0; // 0 = 무한 반복
public DicomDisplayMode DisplayMode { get; set; } = DicomDisplayMode.AnimationAndFrames;
}DicomDisplayMode
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }Viewer.GetDicomMetadataAsync
public Task<DicomMetadata?> GetDicomMetadataAsync(string token, CancellationToken ct = default);이 패키지에서는 항상 null을 반환합니다. 토큰이 알 수 없거나 만료된 경우 InvalidOperationException을 발생시킵니다. DicomMetadata은 .NET 8 패키지와 공유되는 코드가 컴파일되도록 정의되었습니다.
문제 해결
| 증상 | 원인 | 해결책 |
|---|---|---|
플러그인을 추가한 후 모든 요청이 빈 500을 반환합니다; Windows 이벤트 로그(소스 ASP.NET)에는 The Dicom plugin is registered via AddPlugin but no active license grants Dicom.가 표시됩니다. | 라이선스가 없거나, TRIAL 파일이 있거나, Dicom이 없는 라이선스이거나, 버전 기간을 초과한 유료 라이선스입니다. | Dicom을 부여하는 라이선스를 설치하거나, AddPlugin<DicomPlugin>()을 제거하십시오. |
.dcm 파일을 열 때 Document format '.dcm' is not supported.이 발생합니다. | DicomPlugin이 등록되지 않았거나, 해당 패키지가 배포되지 않았습니다. | DoconutHost.Initialize에 AddPlugin<DicomPlugin>()을 추가하고 패키지를 배포하십시오. |
.dcm 파일을 열 때 LicenseException: This document type requires the 'Dicom' plugin license.이 발생합니다. | 로드된 라이선스가 더 이상 Dicom을 부여하지 않습니다. | Dicom을 부여하는 라이선스를 설치하십시오. |
| 한 페이지만 표시됩니다. | 소스가 단일 프레임이거나, DisplayMode이 AnimationOnly입니다. | 다중 프레임 소스의 경우 FramesOnly 또는 AnimationAndFrames을 사용하십시오. |
| 페이지 1이 애니메이션되지 않습니다. | Web.config의 핸들러가 HEAD을 허용하지 않습니다. | verb="GET,HEAD,POST"을 사용하십시오. |
| 애니메이션이 너무 빠르거나 느립니다. | AnimationFrameDelayMs이 꺼져 있습니다; GIF 타이밍은 10 ms 단위를 사용합니다. | AnimationFrameDelayMs을 조정하십시오. |
| 대형 다중 프레임 파일에서 메모리가 증가합니다. | 디스플레이 모드, 해상도 및 페이지 캐시가 모두 보존된 이미지를 추가합니다. | 보려면 프로덕션에서; 세션을 명시적으로 종료하십시오. |
메타데이터가 항상 null입니다. | 이 패키지에서는 예상되는 동작입니다. | 태그가 필요할 때는 .NET 8 패키지를 사용하십시오. |
GetDicomMetadataAsync이 Document session not found. Please re-open document.을 발생시킵니다. | 토큰이 만료되었거나 열리지 않았습니다. | 문서를 다시 열어보십시오. |
프레임워크 참고
ASP.NET Core 패키지와 비교할 때, 이 패키지는 호스팅 및 DICOM 메타데이터에서 차이가 있습니다:
- 등록은
Application_Start에 있으며,DoconutHost.Initialize를 통해 이루어지고,builder.Services.AddDoconut대신 사용됩니다. - 시작 실패는 모든 요청에서 빈
500로 나타나며, 이유는 Windows 이벤트 로그에 기록됩니다. - 애니메이션 감지에는
DocImage.axd핸들러의verb목록에HEAD가 필요합니다. - DICOM 메타데이터 없음.
Viewer.GetDicomMetadataAsync은 항상null을 반환하고 DICOM 세션에 대해 한 번만 경고를 기록합니다;DocImage.axd메타데이터 요청은404을 반환하며, .NET 6 및 .NET Standard 패키지의501와는 다릅니다. - Windows 전용이며, .NET Framework 패키지의 나머지와 동일합니다.
이 페이지가 도움이 되었나요?