תוסף 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.
התקנת החבילה
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 מ״ש = 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.
// קפיצה אחידה דרך המאפיין הבסיסי…
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
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. | האסימון פג תוקף או שמעולם לא נפתח | פתח את המסמך שוב |
הערות מסגרת
בהשוואה לחבילות 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.
האם דף זה היה מועיל?