תוסף 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 עם 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 מ״ש = 10 FPS; זמן ה‑GIF משתמש ביחידות של 10 מ״ש) ו‑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 נמצאים במרחב השמות 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.האסימון פג תוקף או שמעולם לא נפתחפתח את המסמך שוב

הערות מסגרת

בהשוואה לחבילות 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.

האם דף זה היה מועיל?