.TH "dcmp2pgm" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmp2pgm \- خواندن تصویر و حالت نمایش DICOM و رندر بیت‌مپ .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmp2pgm [options] dcmimage-in [bitmap-out] .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdcmp2pgm\fP یک تصویر تک‌رنگ DICOM را تحت کنترل یک شیء حالت نمایش رونوشت‌نرم مقیاس‌خاکستری (grayscale softcopy presentation state) به یک بیت‌مپ تک‌رنگ با ۸ بیت/پیکسل رندر می‌کند\&. این بیت‌مپ یا به‌صورت «Portable Gray Map» (PGM) یا به‌صورت یک شیء تصویری تصویربرداری ثانویه (secondary capture) DICOM ذخیره می‌شود\&. اگر هیچ حالت نمایشی از فایل خوانده نشود، یک حالت نمایش پیش‌فرض ایجاد می‌شود\&. این ابزار امکان خواندن فایل پیکربندی Softcopy Presentation State Viewer را در هنگام راه‌اندازی فراهم می‌کند\&. در این حالت، تنظیمات فایل پیکربندی که بر رندر حالت نمایش تأثیر می‌گذارند اعمال می‌شوند؛ برای مثال، در صورتی که منحنی مشخصه سامانه نمایش موجود بوده و در فایل پیکربندی تعریف شده باشد، می‌توان تصحیح محدوده مقیاس خاکستری را بر اساس مدل بارتن (Barten's model) (بخش ۱۴ DICOM) انجام داد\&. .SH "پارامترها (PARAMETERS)" .PP .PP .nf dcmimage-in تصویر DICOM ورودی ("-" برای stdin) bitmap-out تصویر DICOM یا بیت‌مپ PGM خروجی .fi .PP .SH "گزینه‌ها (OPTIONS)" .PP .SS "گزینه‌های عمومی (general options)" .PP .nf -h --help چاپ این متن راهنما و خروج --version چاپ اطلاعات نسخه و خروج --arguments چاپ آرگومان‌های بسط‌یافته خط فرمان -q --quiet حالت بی‌صدا، عدم چاپ هشدارها و خطاها -v --verbose حالت پرگو، چاپ جزئیات پردازش -d --debug حالت اشکال‌زدایی، چاپ اطلاعات اشکال‌زدایی -ll --log-level [l]evel: string constant (fatal, error, warn, info, debug, trace) استفاده از سطح l برای ثبت‌کننده گزارش -lc --log-config [f]ilename: string استفاده از فایل پیکربندی f برای ثبت‌کننده گزارش .fi .PP .SS "گزینه‌های پردازش (processing options)" .PP .nf -p --pstate [f]ilename: string پردازش با استفاده از فایل حالت نمایش -c --config [f]ilename: string پردازش با استفاده از تنظیمات فایل پیکربندی -f --frame [f]rame: integer پردازش با استفاده از فریم تصویر f (پیش‌فرض: 1) .fi .PP .SS "قالب خروجی (output format)" .PP .nf -D --pgm ذخیره تصویر به عنوان PGM (پیش‌فرض) +D --dicom ذخیره تصویر به عنوان تصویربرداری ثانویه DICOM .fi .PP .SS "گزینه‌های خروجی (output options)" .PP .nf +S --save-pstate [f]ilename: string ذخیره حالت نمایش در فایل .fi .PP .SH "نکات (NOTES)" .PP .SS "محدودیت‌ها (Limitations)" لطفاً توجه داشته باشید که ابزار \fBdcmp2pgm\fP تمام جنبه‌هایی را که توسط شیء Grayscale Softcopy Presentation State (GSPS) تعریف شده‌اند رندر نمی‌کند، بلکه تنها مواردی را که توسط کلاس‌های زیربنایی DCMTK پشتیبانی می‌شوند رندر می‌کند\&. به‌ویژه، حاشیه‌نویسی‌های متنی و گرافیکی در تصویر خروجی قابل مشاهده نخواهند بود\&. دلیل این امر این است که این جنبه‌های یک شیء GSPS معمولاً توسط DICOMscope رندر می‌شوند؛ واسط کاربری گرافیکی‌ای که روی کلاس‌های مرتبط DCMTK قرار گرفته و به زبان Java نوشته شده است\&. .PP همچنین مفاهیمی که پس از تعریف اولیه GSPS IOD معرفی شدند (نگاه کنید به Supplement 33) نادیده گرفته می‌شوند\&. این شامل Supplement 120 با قابلیت‌های توسعه‌یافته‌اش مانند Compound Graphics نیز می‌شود\&. .SH "گزارش‌گیری (LOGGING)" .PP میزان خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر مشخص شود\&. به‌طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند\&. با استفاده از گزینه \fI--verbose\fP پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند\&. گزینه \fI--debug\fP می‌تواند برای دریافت جزئیات بیشتر در مورد فعالیت‌های داخلی، برای نمونه جهت اهداف اشکال‌زدایی، استفاده شود\&. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینه \fI--log-level\fP انتخاب کرد\&. در حالت \fI--quiet\fP فقط خطاهای مهلک (fatal) گزارش می‌شوند\&. در چنین رخدادهای خطای بسیار شدیدی، برنامه معمولاً خاتمه می‌یابد\&. برای جزئیات بیشتر درباره سطوح مختلف گزارش‌گیری، به مستندات ماژول «oflog» مراجعه کنید\&. .PP در صورتی که خروجی گزارش‌گیری باید در فایل نوشته شود (اختیاراً همراه با چرخش فایل گزارش)، به syslog (در Unix) یا event log (در Windows) ارسال شود، می‌توان از گزینه \fI--log-config\fP استفاده کرد\&. این فایل پیکربندی همچنین امکان هدایت تنها پیام‌های خاصی را به یک جریان خروجی مشخص و فیلتر کردن برخی پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند، فراهم می‌کند\&. یک فایل پیکربندی نمونه در \fI/logger\&.cfg\fP ارائه شده است\&. .SH "خط فرمان (COMMAND LINE)" .PP تمام ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده می‌کنند: کروشه‌ها مقادیر اختیاری را در بر می‌گیرند (۰-۱)، سه نقطه متوالی نشان می‌دهد که چندین مقدار مجاز است (۱-n)، و ترکیبی از هر دو به معنای ۰ تا n مقدار است\&. .PP گزینه‌های خط فرمان به ترتیب با یک علامت «+» یا «-» در ابتدا، از پارامترها متمایز می‌شوند\&. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند)\&. با این حال، اگر گزینه‌ها مانعه‌الجمع باشند، آخرین رخداد از سمت راست استفاده می‌شود\&. این رفتار مطابق با قوانین ارزیابی استاندارد در شل‌های متداول Unix است\&. .PP علاوه بر این، یک یا چند فایل فرمان را می‌توان با استفاده از علامت «@» به عنوان پیشوند نام فایل مشخص کرد (به عنوان مثال \fI@command\&.txt\fP)\&. چنین آرگومان فرمانی قبل از هرگونه ارزیابی بیشتر، با محتوای فایل متنی مربوطه جایگزین می‌شود (فاصله‌های خالی متعدد به عنوان یک جداکننده منفرد در نظر گرفته می‌شوند مگر اینکه بین دو علامت نقل‌قول قرار گیرند)\&. لطفاً توجه داشته باشید که یک فایل فرمان نمی‌تواند شامل فایل فرمان دیگری باشد\&. این رویکرد ساده اما کارآمد امکان خلاصه‌سازی ترکیب‌های معمول گزینه‌ها/پارامترها را فراهم کرده و از خط فرمان‌های طولانی و گیج‌کننده جلوگیری می‌کند (یک مثال در فایل \fI/dumppat\&.txt\fP ارائه شده است)\&. .SH "محیط (ENVIRONMENT)" .PP ابزار \fBdcmp2pgm\fP تلاش خواهد کرد واژه‌نامه‌های داده DICOM مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به‌طور پیش‌فرض، یعنی اگر متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه واژه‌نامه درون برنامه ساخته شده باشد (پیش‌فرض برای Windows)\&. .PP رفتار پیش‌فرض ارجح است و متغیر محیطی \fIDCMDICTPATH\fP تنها زمانی باید استفاده شود که به واژه‌نامه‌های داده جایگزین نیاز باشد\&. متغیر محیطی \fIDCMDICTPATH\fP قالبی مشابه متغیر \fIPATH\fP شل Unix دارد به این صورت که علامت دونقطه (":") ورودی‌ها را جدا می‌کند\&. در سیستم‌های Windows، از نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود\&. کد واژه‌نامه داده سعی خواهد کرد هر فایل مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. در صورتی که هیچ واژه‌نامه داده‌ای بارگذاری نشود، یک خطا رخ خواهد داد\&. .SH "فایل‌ها (FILES)" .PP \fI/dcmpstat\&.cfg\fP \- فایل پیکربندی نمونه .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP Copyright (C) 1998-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.