ปลั๊กอิน DICOM

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

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

บน .NET Framework 4.7.2, ไฟล์ DICOM จะเรนเดอร์เต็มรูปแบบ — หน้า, เฟรม, และการเคลื่อนไหว — แต่เมตาดาต้าเชิงเทคนิค (แท็ก DICOM) ไม่พร้อมใช้งาน. Viewer.GetDicomMetadataAsync จะคืนค่า null เสมอ, และการร้องขอเมตาดาต้าของตัวดู (?token=…&meta=1 บน DocImage.axd) จะตอบกลับด้วย 404, ดังนั้นตัวดูจะแสดงแผงคุณสมบัติ DICOM ไม่ปรากฏ. ใช้ Doconut.NET8 หากแอปพลิเคชันของคุณต้องการแท็กเหล่านั้น.

พื้นผิวใช้เมื่อ
Viewer with DicomConfig (C#)คุณเปิดไฟล์ DICOM บนเซิร์ฟเวอร์และเลือกวิธีการนำเสนอเฟรมของมัน
ตัวดู (docViewer) บน 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

รักษาแพคเกจ DICOM ให้เป็นเวอร์ชันเดียวกับ Doconut.NETFramework.

ไฟล์ใบอนุญาตของปลั๊กอิน, 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 (default)หน้า 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 จะตอบกลับ 404 ก่อนที่ Doconut จะทำงานและการตรวจจับแอนิเมชันจะไม่ทำงานเลย.

ความละเอียด

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, ตอบกลับด้วย 404 ในแพคเกจนี้สำหรับทุกเอกสาร, รวมถึงไฟล์ DICOM, เนื่องจากตัวอ่านเมตาดาต้าไม่พร้อมใช้งาน.

ในการผลิต

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

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

วาง Doconut.Viewer.Dicom.lic ข้างๆ Doconut.Viewer.lic บนทุกเซิร์ฟเวอร์, และเก็บ HEAD ในรายการ verb ของตัวจัดการ.

เอกสารอ้างอิง API

DicomConfig, DicomDisplayMode และ DicomMetadata อยู่ใน namespace 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 เสมอในแพ็กเกจนี้. จะโยน 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 ไม่ได้ลงทะเบียน, หรือแพ็กเกจของมันไม่ได้ถูกปรับใช้เพิ่ม AddPlugin<DicomPlugin>() ใน DoconutHost.Initialize แล้วปรับใช้แพ็กเกจ
การเปิดไฟล์ .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 มิลลิวินาทีปรับ AnimationFrameDelayMs
หน่วยความจำเพิ่มขึ้นเมื่อไฟล์หลายเฟรมขนาดใหญ่โหมดการแสดงผล, ความละเอียดและแคชหน้าต่างทั้งหมดเพิ่มภาพที่เก็บไว้ดูที่ ในสภาพการผลิต; ปิดเซสชันอย่างชัดเจน
เมตาดาต้าเป็น null เสมอคาดหวังในแพ็กเกจนี้ใช้แพ็กเกจ .NET 8 เมื่อคุณต้องการแท็ก
GetDicomMetadataAsync ทำให้เกิดข้อผิดพลาด Document session not found. Please re-open document.โทเคนหมดอายุหรือไม่เคยเปิดเปิดเอกสารใหม่อีกครั้ง

บันทึกของ Framework

เมื่อเทียบกับแพ็กเกจ ASP.NET Core, แพ็กเกจนี้แตกต่างในด้านการโฮสต์และเมตาดาต้า DICOM:

  • การลงทะเบียน อยู่ใน Application_Start, ผ่าน DoconutHost.Initialize, แทน builder.Services.AddDoconut.
  • ความล้มเหลวในการเริ่มต้น ปรากฏเป็น 500 ว่างในทุกคำขอ, พร้อมเหตุผลในบันทึกเหตุการณ์ของ Windows.
  • การตรวจจับการเคลื่อนไหว ต้องการ HEAD ในรายการ verb ของตัวจัดการ DocImage.axd.
  • ไม่มีเมตาดาต้า DICOM. Viewer.GetDicomMetadataAsync จะคืนค่า null เสมอและบันทึกคำเตือนครั้งเดียวสำหรับเซสชัน DICOM; คำขอเมตาดาต้า DocImage.axd จะตอบกลับเป็น 404, ไม่ใช่ 501 ของแพ็กเกจ .NET 6 และ .NET Standard.
  • เฉพาะ Windows เช่นเดียวกับส่วนที่เหลือของแพ็กเกจ .NET Framework.

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