.TH "dcmpsprt" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmpsprt \- خواندن تصاویر و وضعیت‌های نمایش DICOM و رندر کار چاپ .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmpsprt [options] dcmfile-in\&.\&.\&. .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdcmpsprt\fP یک یا چند تصویر و وضعیت نمایش (presentation state) در استاندارد DICOM را خوانده و یک کار چاپ (print job) ایجاد می‌کند\&. کار چاپ از یک شیء Stored Print و یک یا چند تصویر Hardcopy Grayscale تشکیل شده و در پایگاه داده‌ای که در فایل پیکربندی مشخص شده است، نوشته می‌شود\&. کار چاپ را می‌توان به‌صورت اختیاری به صف چاپگر (spool) فرستاد\&. در این حالت، \fBdcmpsprt\fP برنامهٔ \fBdcmprscu\fP را فراخوانی می‌کند که وظیفهٔ برقراری ارتباط با چاپگر را بر عهده دارد\&. .SH "پارامترها (PARAMETERS)" .PP .PP .nf dcmfile-in فایل(های) تصویر DICOM برای چاپ ("-" برای ورودی استاندارد stdin) .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 [p]state file: string رندر تصویر بعدی با وضعیت نمایش p (این گزینه می‌تواند چندین بار مشخص شود) -c --config [f]ilename: string پردازش با استفاده از تنظیمات فایل پیکربندی f -p --printer [n]ame: string (پیش‌فرض: نخستین چاپگر در فایل cfg) انتخاب چاپگر با شناسهٔ n از فایل cfg .fi .PP .SS "گزینه‌های صف چاپ (spooling options)" .PP .nf -s --spool ارسال کار چاپ به صف چاپگر DICOM --nospool عدم ارسال کار چاپ به صف چاپگر DICOM (پیش‌فرض) .fi .PP .SS "گزینه‌های جهت فیلم (film orientation options)" .PP .nf --portrait تنظیم جهت عمودی (portrait) --landscape تنظیم جهت افقی (landscape) --default-orientation استفاده از پیش‌فرض چاپگر (پیش‌فرض) .fi .PP .SS "گزینه‌های حاشیه/کادر (trim (border) options)" .PP .nf --trim فعال کردن حاشیه‌بندی (trim on) --no-trim غیرفعال کردن حاشیه‌بندی (trim off) --default-trim استفاده از پیش‌فرض چاپگر (پیش‌فرض) .fi .PP .SS "گزینه‌های رفتار درخواستی برش/کاهش مقیاس (requested decimate/crop behavior options)" .PP .nf --request-decimate درخواست کاهش مقیاس (decimate) --request-crop درخواست برش (crop) --request-fail درخواست عدم انجام و اعلام خطا (failure) --default-request استفاده از پیش‌فرض چاپگر (پیش‌فرض) .fi .PP .SS "گزینه‌های جدول تطبیق نمایش چاپ (print presentation LUT options)" .PP .nf --default-plut عدم ایجاد presentation LUT (پیش‌فرض) --identity تنظیم شکل presentation LUT به صورت IDENTITY --plut [l]ut identifier: string افزودن LUT با شناسهٔ l به کار چاپ --inverse-plut رندر معکوس presentation LUT در بیت‌مپِ تصویر مقیاس خاکستریِ سخت‌کپی (hardcopy grayscale) --illumination [v]alue: integer (0\&.\&.65535) تنظیم روشنایی به مقدار v (برحسب cd/m^2) --reflection [v]alue: integer (0\&.\&.65535) تنظیم نور محیطی بازتاب‌شده به مقدار v (برحسب cd/m^2) .fi .PP .SS "گزینه‌های جلسهٔ اصلی فیلم (basic film session options - فقط با --spool)" .PP .nf --copies [v]alue: integer (1\&.\&.100, پیش‌فرض: 1) تنظیم تعداد رونوشت‌ها بر روی v --medium-type [v]alue: string تنظیم نوع رسانه به v --destination [v]alue: string تنظیم مقصد فیلم به v --label [v]alue: string تنظیم برچسب جلسهٔ فیلم به v --priority [v]alue: string تنظیم اولویت چاپ به v --owner [v]alue: string تنظیم شناسهٔ مالک جلسهٔ فیلم به v .fi .PP .SS "گزینه‌های حاشیه‌نویسی (annotation options)" .PP .nf --no-annotation عدم ایجاد حاشیه‌نویسی (پیش‌فرض) -a --annotation [t]ext: string ایجاد حاشیه‌نویسی با متن t +pd --print-date درج تاریخ/زمان در ابتدای حاشیه‌نویسی (پیش‌فرض) -pd --print-no-date عدم درج تاریخ/زمان در ابتدای حاشیه‌نویسی +pn --print-name درج نام چاپگر در ابتدای حاشیه‌نویسی (پیش‌فرض) -pn --print-no-name عدم درج نام چاپگر در ابتدای حاشیه‌نویسی +pl --print-lighting درج مقادیر روشنایی در ابتدای حاشیه‌نویسی (پیش‌فرض) -pl --print-no-lighting عدم درج مقادیر روشنایی در ابتدای حاشیه‌نویسی .fi .PP .SS "گزینه‌های لایه رویی (overlay options)" .PP .nf +O --overlay [f]ilename: string, [x] [y]: integer بارگذاری داده‌های overlay از فایل PBM به نام f و نمایش در موقعیت (x,y) +Og --ovl-graylevel [v]alue: integer (0\&.\&.4095) استفاده از سطح خاکستری v برای overlay (پیش‌فرض: 4095 = سفید) .fi .PP .SS "سایر گزینه‌های چاپ (other print options)" .PP .nf -l --layout [c]olumns [r]ows: integer (پیش‌فرض: 1 1) استفاده از قالب نمایش تصویر 'STANDARD\\c,r' --filmsize [v]alue: string تنظیم شناسهٔ اندازهٔ فیلم به v --magnification [v]alue: string تنظیم نوع بزرگ‌نمایی به v --smoothing [v]alue: string تنظیم نوع هموارسازی به v --configinfo [v]alue: string تنظیم اطلاعات پیکربندی به v --resolution [v]alue: string تنظیم شناسهٔ تفکیک‌پذیری درخواستی به v --border [v]alue: string تنظیم تراکم کادر به v --empty-image [v]alue: string تنظیم تراکم تصویر خالی به v --max-density [v]alue: string تنظیم حداکثر تراکم به v --min-density [v]alue: string تنظیم حداقل تراکم به v --img-polarity [v]alue: string تنظیم قطبیت جعبهٔ تصویر به v (مقادیر NORMAL یا REVERSE) --img-request-size [v]alue: string تنظیم اندازهٔ درخواستی تصویر به v (عرض به میلی‌متر) --img-magnification [v]alue: string تنظیم نوع بزرگ‌نمایی جعبهٔ تصویر به v --img-smoothing [v]alue: string تنظیم نوع هموارسازی جعبهٔ تصویر به v --img-configinfo [v]alue: string تنظیم اطلاعات پیکربندی جعبهٔ تصویر به v .fi .PP .SH "گزارش‌گیری (LOGGING)" .PP سطح خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر تعیین شود\&. به‌طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند\&. با استفاده از گزینهٔ \fI--verbose\fP پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند\&. گزینهٔ \fI--debug\fP می‌تواند برای دریافت جزئیات بیشتر دربارهٔ فعالیت‌های درونی، مثلاً به منظور اشکال‌زدایی، استفاده شود\&. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینهٔ \fI--log-level\fP انتخاب کرد\&. در حالت \fI--quiet\fP فقط خطاهای مهلک گزارش می‌شوند\&. در چنین رویدادهای خطای بسیار شدیدی، برنامه معمولاً بی‌درنگ خاتمه می‌یابد\&. برای جزئیات بیشتر دربارهٔ سطوح مختلف گزارش‌گیری، به مستندات ماژول "oflog" مراجعه کنید\&. .PP در صورتی که خروجی گزارش‌گیری باید در فایل ذخیره شود (اختیاراً همراه با چرخش فایل لاگ)، به syslog (در یونیکس) یا event log (در ویندوز) ارسال گردد، می‌توان از گزینهٔ \fI--log-config\fP استفاده کرد\&. این فایل پیکربندی همچنین امکان هدایت پیام‌های مشخصی به یک جریان خروجی معین و فیلتر کردن پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن ایجاد شده‌اند را فراهم می‌سازد\&. یک نمونه فایل پیکربندی در مسیر \fI/logger\&.cfg\fP ارائه شده است\&. .SH "خط فرمان (COMMAND LINE)" .PP تمام ابزارهای خط فرمان از شیوهٔ نمادگذاری زیر برای پارامترها استفاده می‌کنند: براکت‌ها مقادیر اختیاری را در بر می‌گیرند (۰-۱)، سه نقطهٔ متوالی نشان‌دهندهٔ مجاز بودن چندین مقدار است (۱-n)، و ترکیب هر دو به معنای ۰ تا n مقدار است\&. .PP گزینه‌های خط فرمان به ترتیب با علامت پیشوند '+' یا '-' از پارامترها متمایز می‌شوند\&. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند)\&. با این حال، اگر گزینه‌ها ناسازگار با یکدیگر (mutually exclusive) باشند، آخرین نمونه در سمت راست اعمال خواهد شد\&. این رفتار با قواعد استاندارد پردازش در پوسته‌های معمول یونیکس مطابقت دارد\&. .PP علاوه بر این، می‌توان یک یا چند فایل فرمان را با قرار دادن علامت '@' به عنوان پیشوند نام فایل مشخص کرد (مانند \fI@command\&.txt\fP)\&. چنین آرگومان فرمانی قبل از هرگونه پردازش بیشتر، با محتوای فایل متنی متناظر جایگزین می‌شود (فاصله‌های خالی متعدد به عنوان یک جداکننده تلقی می‌شوند مگر آنکه میان دو علامت نقل‌قول قرار گرفته باشند)\&. لطفاً توجه داشته باشید که یک فایل فرمان نمی‌تواند حاوی فایل فرمان دیگری باشد\&. این رویکرد ساده اما کارآمد به فرد اجازه می‌دهد ترکیب‌های متداول گزینه‌ها/پارامترها را خلاصه کند و از نوشتن خط فرمان‌های طولانی و گیج‌کننده جلوگیری نماید (یک نمونه در فایل \fI/dumppat\&.txt\fP ارائه شده است)\&. .SH "محیط (ENVIRONMENT)" .PP ابزار \fBdcmpsprt\fP تلاش خواهد کرد دیکشنری‌های داده‌های DICOM مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به‌طور پیش‌فرض، یعنی اگر متغیر محیطی \fIDCMDICTPATH\fP مقداردهی نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه دیکشنری به صورت درونی در برنامه ساخته شده باشد (پیش‌فرض برای ویندوز)\&. .PP رفتار پیش‌فرض ارجح است و متغیر محیطی \fIDCMDICTPATH\fP تنها زمانی باید استفاده شود که به دیکشنری‌های دادهٔ جایگزین نیاز باشد\&. متغیر محیطی \fIDCMDICTPATH\fP ساختاری مشابه متغیر \fIPATH\fP در پوستهٔ یونیکس دارد که در آن دونقطه (":") ورودی‌ها را جدا می‌کند\&. در سیستم‌های ویندوز، از نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود\&. کد دیکشنری داده تلاش خواهد کرد هر فایلی را که در متغیر محیطی \fIDCMDICTPATH\fP مشخص شده بارگذاری نماید\&. بارگذاری نشدن دیکشنری داده یک خطا محسوب می‌شود\&. .SH "فایل‌ها (FILES)" .PP \fI/dcmpstat\&.cfg\fP، \fI/printers\&.cfg\fP \- فایل‌های نمونهٔ پیکربندی .SH "همچنین ببینید (SEE ALSO)" .PP \fBdcmprscu\fP(1) .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP Copyright (C) 1999-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.