نام (NAME)

dcmpsprt - خواندن تصاویر و وضعیت‌های نمایش DICOM و رندر کار چاپ

خلاصه دستور (SYNOPSIS)

dcmpsprt [options] dcmfile-in...

توضیحات (DESCRIPTION)

ابزار dcmpsprt یک یا چند تصویر و وضعیت نمایش (presentation state) در استاندارد DICOM را خوانده و یک کار چاپ (print job) ایجاد می‌کند. کار چاپ از یک شیء Stored Print و یک یا چند تصویر Hardcopy Grayscale تشکیل شده و در پایگاه داده‌ای که در فایل پیکربندی مشخص شده است، نوشته می‌شود. کار چاپ را می‌توان به‌صورت اختیاری به صف چاپگر (spool) فرستاد. در این حالت، dcmpsprt برنامهٔ dcmprscu را فراخوانی می‌کند که وظیفهٔ برقراری ارتباط با چاپگر را بر عهده دارد.

پارامترها (PARAMETERS)

dcmfile-in  فایل(های) تصویر DICOM برای چاپ ("-" برای ورودی استاندارد stdin)

گزینه‌ها (OPTIONS)

-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 برای ثبت وقایع

+p   --pstate  [p]state file: string
       رندر تصویر بعدی با وضعیت نمایش p
       (این گزینه می‌تواند چندین بار مشخص شود)
-c   --config  [f]ilename: string
       پردازش با استفاده از تنظیمات فایل پیکربندی f
-p   --printer  [n]ame: string (پیش‌فرض: نخستین چاپگر در فایل cfg)
       انتخاب چاپگر با شناسهٔ n از فایل cfg

-s   --spool
       ارسال کار چاپ به صف چاپگر DICOM
     --nospool
       عدم ارسال کار چاپ به صف چاپگر DICOM (پیش‌فرض)

--portrait
  تنظیم جهت عمودی (portrait)
--landscape
  تنظیم جهت افقی (landscape)
--default-orientation
  استفاده از پیش‌فرض چاپگر (پیش‌فرض)

--trim
  فعال کردن حاشیه‌بندی (trim on)
--no-trim
  غیرفعال کردن حاشیه‌بندی (trim off)
--default-trim
  استفاده از پیش‌فرض چاپگر (پیش‌فرض)

--request-decimate
  درخواست کاهش مقیاس (decimate)
--request-crop
  درخواست برش (crop)
--request-fail
  درخواست عدم انجام و اعلام خطا (failure)
--default-request
  استفاده از پیش‌فرض چاپگر (پیش‌فرض)

--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)

--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

     --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
       عدم درج مقادیر روشنایی در ابتدای حاشیه‌نویسی

+O   --overlay  [f]ilename: string, [x] [y]: integer
       بارگذاری داده‌های overlay از فایل PBM به نام f و نمایش در موقعیت (x,y)
+Og  --ovl-graylevel  [v]alue: integer (0..4095)
       استفاده از سطح خاکستری v برای overlay (پیش‌فرض: 4095 = سفید)

-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

گزارش‌گیری (LOGGING)

سطح خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر تعیین شود. به‌طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد نوشته می‌شوند. با استفاده از گزینهٔ --verbose پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند. گزینهٔ --debug می‌تواند برای دریافت جزئیات بیشتر دربارهٔ فعالیت‌های درونی، مثلاً به منظور اشکال‌زدایی، استفاده شود. سایر سطوح گزارش‌گیری را می‌توان با استفاده از گزینهٔ --log-level انتخاب کرد. در حالت --quiet فقط خطاهای مهلک گزارش می‌شوند. در چنین رویدادهای خطای بسیار شدیدی، برنامه معمولاً بی‌درنگ خاتمه می‌یابد. برای جزئیات بیشتر دربارهٔ سطوح مختلف گزارش‌گیری، به مستندات ماژول "oflog" مراجعه کنید.

در صورتی که خروجی گزارش‌گیری باید در فایل ذخیره شود (اختیاراً همراه با چرخش فایل لاگ)، به syslog (در یونیکس) یا event log (در ویندوز) ارسال گردد، می‌توان از گزینهٔ --log-config استفاده کرد. این فایل پیکربندی همچنین امکان هدایت پیام‌های مشخصی به یک جریان خروجی معین و فیلتر کردن پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن ایجاد شده‌اند را فراهم می‌سازد. یک نمونه فایل پیکربندی در مسیر <etcdir>/logger.cfg ارائه شده است.

خط فرمان (COMMAND LINE)

تمام ابزارهای خط فرمان از شیوهٔ نمادگذاری زیر برای پارامترها استفاده می‌کنند: براکت‌ها مقادیر اختیاری را در بر می‌گیرند (۰-۱)، سه نقطهٔ متوالی نشان‌دهندهٔ مجاز بودن چندین مقدار است (۱-n)، و ترکیب هر دو به معنای ۰ تا n مقدار است.

گزینه‌های خط فرمان به ترتیب با علامت پیشوند '+' یا '-' از پارامترها متمایز می‌شوند. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند). با این حال، اگر گزینه‌ها ناسازگار با یکدیگر (mutually exclusive) باشند، آخرین نمونه در سمت راست اعمال خواهد شد. این رفتار با قواعد استاندارد پردازش در پوسته‌های معمول یونیکس مطابقت دارد.

علاوه بر این، می‌توان یک یا چند فایل فرمان را با قرار دادن علامت '@' به عنوان پیشوند نام فایل مشخص کرد (مانند @command.txt). چنین آرگومان فرمانی قبل از هرگونه پردازش بیشتر، با محتوای فایل متنی متناظر جایگزین می‌شود (فاصله‌های خالی متعدد به عنوان یک جداکننده تلقی می‌شوند مگر آنکه میان دو علامت نقل‌قول قرار گرفته باشند). لطفاً توجه داشته باشید که یک فایل فرمان نمی‌تواند حاوی فایل فرمان دیگری باشد. این رویکرد ساده اما کارآمد به فرد اجازه می‌دهد ترکیب‌های متداول گزینه‌ها/پارامترها را خلاصه کند و از نوشتن خط فرمان‌های طولانی و گیج‌کننده جلوگیری نماید (یک نمونه در فایل <datadir>/dumppat.txt ارائه شده است).

محیط (ENVIRONMENT)

ابزار dcmpsprt تلاش خواهد کرد دیکشنری‌های داده‌های DICOM مشخص‌شده در متغیر محیطی DCMDICTPATH را بارگذاری کند. به‌طور پیش‌فرض، یعنی اگر متغیر محیطی DCMDICTPATH مقداردهی نشده باشد، فایل <datadir>/dicom.dic بارگذاری خواهد شد مگر اینکه دیکشنری به صورت درونی در برنامه ساخته شده باشد (پیش‌فرض برای ویندوز).

رفتار پیش‌فرض ارجح است و متغیر محیطی DCMDICTPATH تنها زمانی باید استفاده شود که به دیکشنری‌های دادهٔ جایگزین نیاز باشد. متغیر محیطی DCMDICTPATH ساختاری مشابه متغیر PATH در پوستهٔ یونیکس دارد که در آن دونقطه (":") ورودی‌ها را جدا می‌کند. در سیستم‌های ویندوز، از نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود. کد دیکشنری داده تلاش خواهد کرد هر فایلی را که در متغیر محیطی DCMDICTPATH مشخص شده بارگذاری نماید. بارگذاری نشدن دیکشنری داده یک خطا محسوب می‌شود.

فایل‌ها (FILES)

<etcdir>/dcmpstat.cfg، <etcdir>/printers.cfg - فایل‌های نمونهٔ پیکربندی

همچنین ببینید (SEE ALSO)

dcmprscu(1)

کپی‌رایت و تکثیر (COPYRIGHT)

Copyright (C) 1999-2025 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.