ปลั๊กอิน DICOM

ดูภาพทางการแพทย์ด้วย DicomPlugin

ปลั๊กอิน DICOM เพิ่มการดูภาพทางการแพทย์ให้กับ Doconut: ไฟล์ DICOM แบบหลายเฟรมจะแสดงเป็นภาพรวมแบบเคลื่อนไหว, เฟรมเดี่ยว, หรือทั้งสองอย่าง. DICOM เป็น รูปแบบเฉพาะปลั๊กอิน — หากไม่มีปลั๊กอินนี้ (และความสามารถด้านลิขสิทธิ์ของมัน), ไฟล์ .dcm ไม่สามารถเปิดได้เลย.

ส่วนใช้เมื่อ
Viewer กับ DicomConfig (C#)คุณเปิดไฟล์ DICOM บนเซิร์ฟเวอร์และเลือกวิธีการนำเสนอเฟรมของมัน
ตัวดู (docViewer)คุณแสดงการศึกษาในหน้าของคุณ: การเคลื่อนไหวและเฟรม

ปลั๊กอินนี้ไม่มีวิดเจ็ตของตนเอง: ไฟล์ DICOM จะเปิดในตัวดูปกติ. พร้อมกับการลงทะเบียน ปลั๊กอินแปลงรูปแบบ ด้วย, ไฟล์ .dcm และ .ima สามารถแปลงเป็น Pdf, Png, Jpeg, Bmp, Tiff หรือ Gif; การแปลงนี้ต้องการความสามารถ Dicom ด้วย.

ติดตั้งแพ็กเกจ

bash
dotnet add package Doconut.NETStandard.Dicom

คำสั่งที่ไม่มีเวอร์ชันจะติดตั้งรุ่นเสถียรล่าสุด. เพื่อระบุปลั๊กอินให้ตรงกับรุ่นที่เอกสารนี้อธิบาย, ให้ส่งเวอร์ชันแยกต่างหาก:

bash
dotnet add package Doconut.NETStandard.Dicom --version 26.10.0

รักษาแพ็กเกจ DICOM ให้เป็นเวอร์ชันเดียวกับ Doconut.NETStandard. ID ของแพ็กเกจคือ Doconut.NETStandard.Dicom; .<version> ปรากฏเฉพาะในชื่อไฟล์ที่ดาวน์โหลด .nupkg.

ไฟล์ลิขสิทธิ์ของปลั๊กอิน, Doconut.Viewer.Dicom.lic, อยู่ในโฟลเดอร์เดียวกับ Doconut.Viewer.lic; มันจะถูกอ่านพร้อมกับลิขสิทธิ์ของตัวดู.

ลงทะเบียนปลั๊กอิน

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

ปลั๊กอิน (Name: "Doconut DICOM Viewer") ลงทะเบียนตัวดูสำหรับส่วนขยาย .dcm และ .ima, ซึ่งจำกัดโดยความสามารถ Dicom. หากไม่มีลิขสิทธิ์ที่ให้สิทธิ์นี้, AddDoconut() จะโยน InvalidOperationException ในขณะเริ่มต้น, ก่อนแอปจะให้บริการคำขอ:

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.

มันจะโยนเมื่อไม่มีลิขสิทธิ์, ไฟล์ legacy TRIAL, ลิขสิทธิ์ที่ไม่มี Dicom, และลิขสิทธิ์ที่ชำระแล้วใช้เกินช่วงเวอร์ชัน. ลิขสิทธิ์ชั่วคราว (Demo/NFR) จะได้รับการยอมรับ. ดู การตั้งค่าลิขสิทธิ์ เพื่อทราบวิธีการโหลดลิขสิทธิ์.

เนื่องจากไม่มีตัวดูในตัวที่จัดการรูปแบบเหล่านี้, ประตูรันไทม์จะล้มเหลวอย่างรุนแรงหากความสามารถนั้นในภายหลังไม่พร้อมใช้งาน:

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

การให้ลิขสิทธิ์และลายน้ำ

สถานะลิขสิทธิ์การเริ่มต้นผลลัพธ์ DICOM
ลิขสิทธิ์ที่ชำระเงินให้สิทธิ์ Dicom, ภายในช่วงเวอร์ชันของมันเริ่มแสดงผลภายใต้กฎลายน้ำหน้าปกติ
ลิขสิทธิ์ชั่วคราวที่ใช้งานอยู่ (Demo/NFR)เริ่มแสดงผลพร้อมลายน้ำการประเมิน
ไม่มีลิขสิทธิ์, ไฟล์ legacy TRIAL, ลิขสิทธิ์ที่ไม่มี Dicom, หรือ ลิขสิทธิ์ที่ชำระเงินเกินช่วงเวอร์ชันAddDoconut() โยน—

การตัดสินใจลายน้ำหน้าปกติยังใช้กับผลลัพธ์ DICOM ด้วย. สำหรับผลลัพธ์แบบเคลื่อนไหว, แต่ละเฟรม GIF จะถูกประทับลายน้ำเพื่อให้เครื่องหมายมองเห็นตลอดการเล่น. DocOptions.Watermark แบบกำหนดเองจะใช้เฉพาะเมื่อเส้นทางลิขสิทธิ์อนุญาตให้ใช้ลายน้ำแบบกำหนดเอง; มันไม่สามารถแทนที่ลายน้ำการประเมินได้.

การใช้จาก C#

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

Viewer.GetDicomMetadataAsync(token) มีอยู่ในแพ็กเกจนี้, แต่จะคืนค่า null สำหรับเซสชัน DICOM: ดู บันทึกกรอบงาน.

โหมดการแสดงผล, ความละเอียดและเมตาดาต้า

โหมดการแสดงผล

ไฟล์ DICOM แบบหลายเฟรมสามารถแสดงได้สามวิธี (DicomDisplayMode):

โหมดหน้าที่สร้างใช้สำหรับ
AnimationOnlyหน้า 1 = GIF แบบเคลื่อนไหววนซ้ำทุกเฟรมการตรวจสอบแบบภาพยนตร์อย่างรวดเร็ว
FramesOnlyหน้า 1..N = PNG คงที่หนึ่งภาพต่อเฟรมการนำทางวินิจฉัยเฟรมต่อเฟรม
AnimationAndFrames (default)หน้า 1 = GIF แบบเคลื่อนไหว, หน้า 2..N+1 = PNG คงที่หนึ่งภาพต่อเฟรม (N = จำนวนเฟรม)ภาพรวม + รายละเอียดในเอกสารเดียว

การควบคุมเวลาการเคลื่อนไหวทำโดย AnimationFrameDelayMs (ค่าเริ่มต้น 100 ms = 10 FPS; ความละเอียดของ GIF มีหน่วย 10 ms) และ LoopCount (0 = เล่นวนซ้ำตลอด)

ความละเอียด

DicomConfig เรนเดอร์ที่ 100 DPI ต่อแกนโดยค่าเริ่มต้น. คุณสมบัติความละเอียดมีลำดับสำรองที่ควรรู้: หากคุณไม่ได้ตั้งค่า HorizontalResolution/VerticalResolution อย่างชัดเจน, พวกมันจะตาม BaseConfig.ImageResolution เมื่อมีการกำหนดค่า, แล้วจึงย้อนกลับไปที่ 100.

csharp
// การเพิ่มความบิดแบบสม่ำเสมอผ่านคุณสมบัติ base…
new DicomConfig { ImageResolution = 150 };

// …หรือการควบคุมตามแกน
new DicomConfig { HorizontalResolution = 200, VerticalResolution = 150 };

ข้อมูลเมตา

DicomMetadata มีเพียงแท็กทางเทคนิคและการถ่ายภาพ — จำนวนเฟรม, มิติ, ความลึกบิต, การตีความโฟโตเมตริก, ซินแทกซ์การถ่ายโอน, โหมดและระดับหน้าต่างเริ่มต้น. ไม่มีข้อมูลที่ระบุตัวผู้ป่วย. รายการเต็มอยู่ใน อ้างอิง API. ในแพ็กเกจนี้ข้อมูลเมตาไม่พร้อมใช้งาน; ดู บันทึก Framework.

ในตัวดู

ตัวดูไม่ต้องการการตั้งค่าเฉพาะ DICOM. เมื่อเอกสารที่เปิดเป็นไฟล์ DICOM, มันจะร้องขอข้อมูลเมตา (?token=<token>&meta=1) และเพิ่มปุ่ม DICOM ที่เปิดพาเนลคุณสมบัติเทคนิค. หากการร้องขอนั้นล้มเหลว, พาเนลจะซ่อนอยู่และเอกสารยังคงเรนเดอร์. ในแพ็กเกจนี้การร้องขอให้ตอบกลับ 501, ดังนั้นพาเนลจะไม่ปรากฏเลย.

สร้างส่วนหน้าเอง

ข้อมูลเมตาพร้อมใช้งานผ่าน HTTP ภายใต้เส้นทางที่ UseDoconut() ถูกเมานท์ (โดยปกติ /doconut), สำหรับโทเค็นเอกสารที่เปิดใด ๆ:

เส้นทางวัตถุประสงค์การตอบสนองสำเร็จ
GET ?token=<token>&meta=1อ่านข้อมูลเมตาเทคนิคของเอกสาร DICOM ที่เปิดอยู่200 — DicomMetadata เป็น JSON, พร้อมชื่อคุณสมบัติจากอ้างอิง API (Width, Height, NumberOfFrames, …)
สถานะเมื่อเนื้อหา
404เอกสารไม่ใช่ไฟล์ DICOMเฉพาะสถานะ
501เอกสารเป็นไฟล์ DICOM, แต่แพ็กเกจนี้ไม่สามารถอ่านแท็กได้{ "error": "dicom_metadata_unsupported", "message": "DICOM technical metadata is not supported on this package: the underlying medical-imaging engine has no build for this target framework. On this package it always returns null; use the .NET 8 package if you need it. DICOM rendering is unaffected." }
500การอ่านข้อมูลเมตาล้มเหลว{ "error": "metadata failed" }

ภาพหน้า, รวมถึงหน้าที่เคลื่อนไหวเป็นหน้าแรก, ใช้เส้นทางภาพของตัวดูมาตรฐาน.

ในการผลิต

การศึกษาแบบหลายเฟรมสามารถสร้างทั้งแอนิเมชันและหน้าคงที่หนึ่งหน้าต่อเฟรม. AnimationAndFrames ให้การนำทางที่สมบูรณ์ที่สุดแต่มีค่าเรนเดอร์และแคชสูงสุด. สำหรับการศึกษาขนาดใหญ่:

  • ใช้ FramesOnly เมื่อการตรวจสอบเฟรมสำคัญกว่าการเล่นแบบภาพยนตร์;
  • หลีกเลี่ยงการเพิ่มแกนความละเอียดทั้งสองโดยไม่ได้วัดหน่วยความจำ;
  • ปิดเซสชันอย่างชัดเจนเมื่อการศึกษาไม่เปิดอยู่แล้ว;
  • เปิดใช้งาน CachePages เฉพาะเมื่อประโยชน์จากการเข้าถึงซ้ำเกินกว่าภาพที่เก็บไว้.

วาง Doconut.Viewer.Dicom.lic ข้าง Doconut.Viewer.lic บนเซิร์ฟเวอร์ทุกเครื่อง.

อ้างอิง API

DicomConfig, DicomDisplayMode และ DicomMetadata อยู่ในเนมสเปซ Doconut. DicomPlugin อยู่ใน Doconut.Plugins.Dicom. ตารางคุณสมบัติ DicomConfig ฉบับเต็มอยู่ใน การกำหนดรูปแบบ.

DicomConfig

csharp
public sealed class DicomConfig : BaseConfig
{
    public int HorizontalResolution { get; set; }   // ค่าเริ่มต้น: ImageResolution เมื่อกำหนด, มิฉะนั้น 100
    public int VerticalResolution { get; set; }     // ค่าเริ่มต้น: 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 เมื่อเอกสารไม่ใช่ไฟล์ DICOM และจะคืนค่า null เสมอในแพ็กเกจนี้ จะโยนข้อผิดพลาด InvalidOperationException เมื่อโทเคนไม่รู้จักหรือหมดอายุ

DicomMetadata

csharp
public sealed class DicomMetadata
{
    public int Width { get; init; }
    public int Height { get; init; }
    public int NumberOfFrames { get; init; }
    public int BitsAllocated { get; init; }
    public int BitsStored { get; init; }
    public int SamplesPerPixel { get; init; }
    public string? PhotometricInterpretation { get; init; }
    public string? PixelRepresentation { get; init; }   // "Unsigned" หรือ "Signed"
    public string? PlanarConfiguration { get; init; }
    public string? TransferSyntax { get; init; }
    public string? Modality { get; init; }              // null เมื่อไม่ได้เปิดเผย
    public double? WindowCenter { get; init; }
    public double? WindowWidth { get; init; }
    public bool IsColor { get; init; }
}

การแก้ไขปัญหา

อาการสาเหตุวิธีแก้
AddDoconut() ขว้างข้อผิดพลาด 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 ยังไม่ได้ลงทะเบียน หรือแพ็กเกจของมันยังไม่ได้ปรับใช้เพิ่ม AddPlugin<DicomPlugin>() ภายใน AddDoconut() แล้วปรับใช้แพ็กเกจ
การเปิดไฟล์ .dcm ขว้างข้อผิดพลาด LicenseException: This document type requires the 'Dicom' plugin license.ใบอนุญาตที่โหลดแล้วไม่ให้สิทธิ Dicom อีกต่อไปติดตั้งใบอนุญาตที่ให้สิทธิ Dicom
ปรากฏเพียงหน้าหนึ่งแหล่งข้อมูลเป็นเฟรมเดียว, หรือ DisplayMode เป็น AnimationOnlyใช้ FramesOnly หรือ AnimationAndFrames สำหรับแหล่งข้อมูลหลายเฟรม
การเคลื่อนไหวเร็วหรือช้าเกินไปAnimationFrameDelayMs ปิด; การจับเวลา GIF ที่มีประสิทธิภาพใช้หน่วย 10 มิลลิวินาทีปรับ AnimationFrameDelayMs
หน่วยความจำเพิ่มขึ้นเมื่อไฟล์หลายเฟรมขนาดใหญ่โหมดการแสดง, ความละเอียดและแคชหน้าทั้งหมดเพิ่มภาพที่คงไว้ดู ในสภาพการผลิต; ปิดเซสชันอย่างชัดเจน
Metadata เป็น nullเอกสารไม่ใช่ไฟล์ DICOMตรวจสอบประเภทไฟล์ก่อนขอ metadata
Metadata เป็น null สำหรับไฟล์ DICOM, หรือ &meta คืนค่า 501เป็นข้อจำกัดที่คาดหวังของแพ็กเกจนี้; การเรนเดอร์ไม่ถูกกระทบใช้แพ็กเกจ .NET 8 เมื่อคุณต้องการแท็ก
GetDicomMetadataAsync ขว้างข้อผิดพลาด Document session not found. Please re-open document.โทเคนหมดอายุหรือไม่เคยเปิดเปิดเอกสารใหม่อีกครั้ง

บันทึกของเฟรมเวิร์ก

  • ไม่มี metadata DICOM. การเรนเดอร์หน้า DICOM, เฟรมแยก, การเคลื่อนไหว, การแปลง, และการใส่น้ำลายน้ำได้รับการสนับสนุน. Metadata แท็กทางเทคนิคไม่พร้อมใช้งานในแพ็กเกจ .NET Standard เนื่องจากตัวอ่าน metadata มีเฉพาะรุ่น .NET 8. Viewer.GetDicomMetadataAsync(token) จึงคืนค่า null สำหรับเซสชัน DICOM และบันทึกคำเตือนหนึ่งครั้ง. คำขอ ?token=…&meta=1 ที่สอดคล้องกันคืนค่า HTTP 501 Not Implemented พร้อมรหัสข้อผิดพลาดคงที่ dicom_metadata_unsupported. ใช้แพ็กเกจ .NET 8 เมื่อ metadata DICOM ทางเทคนิคเป็นความต้องการ.
  • เฉพาะ Windows, เช่นเดียวกับส่วนที่เหลือของแพ็กเกจ .NET Standard.

หน้านี้เป็นประโยชน์หรือไม่?