ปลั๊กอิน 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 ด้วย.
ติดตั้งแพคเกจ
Install-Package Doconut.NETFramework.Dicomเพื่อผูกปลั๊กอินกับรุ่นที่เอกสารนี้อธิบาย:
Install-Package Doconut.NETFramework.Dicom -Version 26.10.0รักษาแพคเกจ DICOM ให้เป็นเวอร์ชันเดียวกับ Doconut.NETFramework.
ไฟล์ใบอนุญาตของปลั๊กอิน, 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 (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.
// การบัมแบบสม่ำเสมอผ่านคุณสมบัติฐาน…
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
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
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 ไม่ได้ลงทะเบียน, หรือแพ็กเกจของมันไม่ได้ถูกปรับใช้ | เพิ่ม 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.
หน้านี้เป็นประโยชน์หรือไม่?