Plugin DICOM

Plugin DICOM thêm khả năng xem hình ảnh y tế vào Doconut: các tệp DICOM đa khung được hiển thị dưới dạng tổng quan hoạt hình, các khung riêng lẻ, hoặc cả hai. DICOM là một định dạng chỉ dành cho plugin — nếu không có plugin này (và khả năng cấp phép của nó), các tệp .dcm không thể mở được.

Cài đặt gói

dotnet add package Doconut.NET6.Dicom

Lệnh không chỉ định phiên bản sẽ cài đặt bản phát hành ổn định mới nhất. Để cố định plugin ở bản phát hành 26.7.0 hiện tại, truyền phiên bản riêng biệt:

dotnet add package Doconut.NET6.Dicom --version 26.7.0

Giữ gói DICOM ở cùng phiên bản với Doconut.NET6. ID gói là Doconut.NET6.Dicom; .26.7.0 chỉ xuất hiện trong tên tệp .nupkg đã tải về.

Đăng ký plugin

builder.Services.AddDoconut(options =>
{
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

Plugin (Name: "Doconut DICOM Viewer") đăng ký các trình xem cho các phần mở rộng .dcm và .ima, được kiểm soát bởi khả năng Dicom. Một quyền không tạm thời bị thiếu hoặc không đủ thường sẽ gây lỗi trong AddDoconut(). Vì không có trình xem tích hợp nào xử lý các định dạng này, cổng runtime cũng sẽ thất bại nghiêm trọng nếu khả năng này sau này không khả dụng:

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

Mở tệp DICOM

var token = await viewer.OpenDocumentAsync(path, new DicomConfig
{
    DisplayMode = DicomDisplayMode.AnimationAndFrames
});

Chế độ hiển thị

Các tệp DICOM đa khung có thể được trình bày theo ba cách (DicomDisplayMode):

Thời gian hoạt hình được điều khiển bởi AnimationFrameDelayMs (mặc định 100 ms = 10 FPS; độ chi tiết GIF là đơn vị 10 ms) và LoopCount (0 = lặp vô hạn).

Độ phân giải

DicomConfig render với 100 DPI mỗi trục theo mặc định. Các thuộc tính độ phân giải có một chuỗi dự phòng đáng biết: nếu bạn không đặt HorizontalResolution/VerticalResolution một cách rõ ràng, chúng sẽ theo BaseConfig.ImageResolution khi được cấu hình, và chỉ sau đó mới quay lại 100.

// Uniform bump via the base property…
new DicomConfig { ImageResolution = 150 };

// …or per-axis control
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

Khả năng truy cập siêu dữ liệu DICOM trên .NET 6

Việc render trang DICOM, các khung riêng lẻ, hoạt hình, biến đổi và đánh dấu nước đều được hỗ trợ. Siêu dữ liệu thẻ kỹ thuật không có trong gói .NET 6 vì trình đọc siêu dữ liệu không có bản dựng cho .NET 6.

Do đó Viewer.GetDicomMetadataAsync(token) trả về null cho một phiên DICOM và ghi một cảnh báo một lần. Yêu cầu middleware ?token=…&meta tương ứng trả về HTTP 501 Not Implemented với mã lỗi ổn định dicom_metadata_unsupported. Hãy dùng gói .NET 8 khi siêu dữ liệu DICOM kỹ thuật là yêu cầu.

Tham chiếu cấu hình đầy đủ

Bảng thuộc tính DicomConfig đầy đủ nằm trong Tham chiếu API → Cấu hình Định dạng. Một ví dụ thực tế từ ứng dụng tham chiếu cho chuyển đổi theo phần mở rộng:

".DCM" or ".IMA" => new DicomConfig { DisplayMode = DicomDisplayMode.AnimationAndFrames },

Đánh dấu nước và hành vi bộ nhớ

Quyết định đánh dấu nước trên trang bình thường cũng áp dụng cho đầu ra DICOM. Đối với đầu ra hoạt hình, mỗi khung GIF được dán dấu để dấu vẫn hiển thị trong suốt quá trình phát. DocOptions.Watermark tùy chỉnh chỉ được sử dụng khi đường cấp phép cho phép đánh dấu tùy chỉnh; nó không thể thay thế dấu nước đánh giá.

Các nghiên cứu đa khung có thể tạo cả hoạt hình và một trang tĩnh cho mỗi khung. AnimationAndFrames cung cấp khả năng điều hướng phong phú nhất nhưng cũng có chi phí render và bộ nhớ đệm cao nhất. Đối với các nghiên cứu lớn:

• sử dụng FramesOnly khi việc kiểm tra khung quan trọng hơn việc phát lại kiểu điện ảnh;
• tránh tăng cả hai trục độ phân giải mà không đo lường bộ nhớ;
• đóng phiên làm việc một cách rõ ràng khi nghiên cứu không còn mở;
• giữ CachePages bật chỉ khi lợi ích của việc truy cập lại vượt quá các hình ảnh được giữ lại.

Khắc phục sự cố