DICOM 플러그인

DicomPlugin으로 의료 이미지를 보기

DICOM 플러그인은 Doconut에 의료 이미지 보기 기능을 추가합니다: 다중 프레임 DICOM 파일은 애니메이션 개요, 개별 프레임, 또는 두 가지 모두로 렌더링됩니다. DICOM은 플러그인 전용 포맷이며 — 이 플러그인(및 라이선스 기능)이 없으면 .dcm 파일을 전혀 열 수 없습니다.

.NET Framework 4.7.2에서 DICOM 파일은 페이지, 프레임 및 애니메이션까지 완전히 렌더링됩니다 — 하지만 기술 메타데이터(DICOM 태그)는 사용할 수 없습니다. Viewer.GetDicomMetadataAsync는 항상 null를 반환하고, 뷰어의 메타데이터 요청(?token=…&meta=1 on DocImage.axd)은 404로 응답하므로 뷰어에 DICOM 속성 패널이 표시되지 않습니다. 태그가 필요하면 Doconut.NET8를 사용하십시오.

구성 요소사용 시점
Viewer with DicomConfig (C#)서버에서 DICOM 파일을 열고 프레임이 어떻게 표시될지 선택합니다
뷰어(docViewer) on DocImage.axd페이지에 연구를 표시합니다: 애니메이션 및 프레임

플러그인 자체 위젯은 없습니다: DICOM 파일은 일반 뷰어에서 열립니다. 컨버터 플러그인도 등록하면, .dcm 및 .ima 파일을 Pdf, Png, Jpeg, Bmp, Tiff 또는 Gif 로 변환할 수 있습니다; 이 변환에는 Dicom 기능도 필요합니다.

패키지 설치

powershell
Install-Package Doconut.NETFramework.Dicom

이 문서에서 설명하는 릴리스에 플러그인을 고정하려면:

powershell
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0

Doconut.NETFramework와 동일한 버전으로 DICOM 패키지를 유지하십시오.

플러그인의 라이선스 파일인 Doconut.Viewer.Dicom.lic는 뷰어 라이선스와 함께 읽히도록 Doconut.Viewer.lic와 같은 폴더에 넣어야 합니다.

플러그인 등록

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

플러그인(Name: "Doconut DICOM Viewer")은 .dcm 및 .ima 확장자를 위한 뷰어를 등록하며, 이는 Dicom 기능에 의해 제한됩니다. 라이선스가 이를 부여하지 않으면, DoconutHost.Initialize가 Application_Start에서 예외를 발생시킵니다:

text
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 라이선스도 허용됩니다. 라이선스 설정을 참조하십시오.

내장 뷰어가 이러한 형식을 처리하지 못하기 때문에, 해당 기능이 나중에 사용할 수 없게 되면 파일을 여는 것이 즉시 실패합니다:

text
LicenseException: This document type requires the 'Dicom' plugin license.

라이선스 및 워터마크

라이선스 상태시작 시점DICOM 출력
버전 기간 내에 Dicom를 부여하는 유료 라이선스시작일반 페이지 워터마크 규칙에 따라 렌더링됩니다
활성 임시(Demo/NFR) 라이선스시작평가 워터마크와 함께 렌더링됩니다
라이선스 없음, 레거시 TRIAL 파일, Dicom가 없는 라이선스, 또는 버전 기간 외의 유료 라이선스Application_Start가 예외를 발생시키고; 모든 요청이 빈 500로 응답합니다—

일반 페이지 워터마크 결정은 DICOM 출력에도 적용됩니다. 애니메이션 출력의 경우 각 GIF 프레임에 워터마크가 찍히므로 재생 전체에 걸쳐 표시됩니다. 맞춤형 DocOptions.Watermark은 라이선스가 맞춤 워터마크를 허용할 때만 사용되며, 평가 워터마크를 대체할 수 없습니다.

C#에서 사용하기

csharp
var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});
csharp
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으로 되돌아갑니다.

csharp
// 기본 속성을 통한 균일 버프…
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

csharp
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

csharp
public enum DicomDisplayMode { AnimationOnly, FramesOnly, AnimationAndFrames }

Viewer.GetDicomMetadataAsync

csharp
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 패키지의 나머지와 동일합니다.

이 페이지가 도움이 되었나요?