.TH "dcmdspfn" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmdspfn \- برون‌ریزی منحنی‌های استاندارد نمایش به یک فایل متنی .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmdspfn [options] .fi .PP .SH "توضیحات (DESCRIPTION)" .PP این برنامهٔ خط فرمانی، فایل مشخصات مانیتور / دوربین / چاپگر / اسکنر DCMTK را به یک فایل متنی با ستون‌بندی تب (tabbed) تبدیل می‌کند که منحنی مشخصه (CC)، تابع نمایش و منحنی پس‌استانداردسازی (PSC) را برای یک نمایشگر ۸ بیتی شرح می‌دهد\&. ۲۵۶ مقدار هر منحنی را می‌توان با یک برنامهٔ معمول صفحه گسترده مصورسازی کرد\&. علاوه‌بر این، منحنی نمایش (بدون CC و PSC) را می‌توان برای یک محدودهٔ مشخص درخشندگی/OD (حداقل/حداکثر) و تعداد معینی از سطوح محرک دیجیتال (DDL) نیز محاسبه کرد\&. .SH "پارامترها (PARAMETERS)" .PP .PP .nf dcmfile-in نام فایل DICOM ورودی جهت تخلیه .fi .PP .SH "گزینه‌ها (OPTIONS)" .PP .SS "گزینه‌های عمومی" .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 "گزینه‌های ورودی (مانعةالجمع)" .PP .nf +Im --monitor-file [f]ilename: string فایل متنی توصیف‌کنندهٔ مشخصات مانیتور +Ic --camera-file [f]ilename: string فایل متنی توصیف‌کنندهٔ مشخصات دوربین +Ip --printer-file [f]ilename: string فایل متنی توصیف‌کنندهٔ مشخصات چاپگر +Is --scanner-file [f]ilename: string فایل متنی توصیف‌کنندهٔ مشخصات اسکنر +Il --lum-range [m]in max: float حداقل و حداکثر درخشندگی (cd/m^2) +Io --od-range [m]in max: float حداقل و حداکثر چگالی نوری (OD)، تبدیل خودکار به درخشندگی .fi .PP .SS "گزینه‌های ایجاد" .PP .nf +Ca --ambient-light [a]mbient light: float مقدار نور محیط (cd/m^2، پیش‌فرض: فایل f) +Ci --illumination [i]llumination: float مقدار روشنایی (cd/m^2، پیش‌فرض: فایل f) +Dn --min-density [m]inimum optical density: float مقدار Dmin (پیش‌فرض: غیرفعال، فقط با +Ip و +Io) +Dx --max-density [m]aximum optical density: float مقدار Dmax (پیش‌فرض: غیرفعال، فقط با +Ip و +Io) +Cd --ddl-count [n]umber of DDLs: integer تعداد سطوح محرک دیجیتال (DDL) (پیش‌فرض: 256، فقط با --lum/od-range) +Cf --curve-fitting [n]umber: integer استفاده از الگوریتم برازش منحنی چندجمله‌ای با مرتبهٔ n (0\&.\&.99، پیش‌فرض: تنظیم فایل یا cubic spline) .fi .PP .SS "گزینه‌های خروجی" .PP .nf +Og --gsdf [f]ilename: string نوشتن داده‌های منحنی GSDF در فایل f +Oc --cielab [f]ilename: string نوشتن داده‌های منحنی CIELAB در فایل f .fi .PP .SH "نکات (NOTES)" .PP فایل خروجی که CC، GSDF یا CIELAB و PSC را برای یک سامانهٔ نمایش ۸ بیتی (مانیتور، دوربین، چاپگر یا اسکنر) توصیف می‌کند، یک فایل متنی ساده است\&. خطوطی که با «#» شروع می‌شوند به‌عنوان توضیح در نظر گرفته شده و در نتیجه، به همراه خطوط خالی نادیده گرفته می‌شوند\&. یک فایل ورودی می‌تواند به‌عنوان نمونه توسط ابزار خط فرمانی \fBdconvlum\fP ایجاد شود\&. .PP مقدار نور محیطی که احتمالاً در فایل مشخصات تعریف شده است نیز برای محاسبات استفاده می‌شود\&. در این حالت این مقدار، و همچنین تعداد مقادیر DDL (سطح محرک دیجیتال)، محدودهٔ مطلق درخشندگی (اندازه‌گیری‌شده بر حسب کاندلا بر متر مربع) و در صورت استفاده از GSDF محدودهٔ شاخص JND (کمترین تفاوت محسوس)، بخشی از سرآیند توضیحات فایل خواهند بود\&. از سوی دیگر، مقدار نور محیط می‌تواند به‌صورت یک گزینهٔ خط فرمان مشخص شود\&. هنگام تنظیم دو مقدار درخشندگی به‌جای خواندن یک فایل مشخصات مانیتور به‌عنوان ورودی، محدودهٔ درخشندگی به‌صورت خطی بر تعداد DDLها تقسیم می‌شود\&. .PP برای چاپگرها و اسکنرها، علاوه بر نور محیطی بازتاب‌شده، روشنایی (illumination) را نیز می‌توان تعیین کرد (هم در فایل مشخصات و هم در خط فرمان)\&. سرآیند فایل خروجی به‌جای محدودهٔ درخشندگی، شامل حداقل و حداکثر چگالی نوری (OD) است\&. لطفاً توجه داشته باشید که مقادیر OD در فایل ورودی باید به ترتیب نزولی مرتب شده باشند (برخلاف مقادیر درخشندگی که برای مانیتورها و دوربین‌ها استفاده می‌شوند)\&. مقدار DDL برابر با 0 همواره به معنای سیاه (تاریک‌ترین مقدار) و حداکثر مقدار DDL به معنای سفید (روشن‌ترین مقدار، فیلم شفاف) است\&. .PP پوشهٔ \fIdata\fP حاوی فایل‌های مشخصات نمونه برای مانیتورها، دوربین‌ها، چاپگرها و اسکنرها است\&. برای جزئیات بیشتر دربارهٔ کالیبراسیون صفحهٔ نمایش و مدل بارتن (از جمله GSDF)، به بخش ۱۴ استاندارد DICOM مراجعه کنید\&. .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 تمامی ابزارهای خط فرمان از نمادگذاری زیر برای پارامترها استفاده می‌کنند: براکت‌ها مقادیر اختیاری را مشخص می‌کنند (0-1)، سه نقطهٔ متوالی نشان‌دهندهٔ مجاز بودن چندین مقدار است (1-n)، و ترکیبی از هر دو به معنای 0 تا n مقدار است\&. .PP گزینه‌های خط فرمان به ترتیب با علامت پیشوند «+» یا «-» از پارامترها متمایز می‌شوند\&. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند)\&. با این حال، اگر گزینه‌ها مانعةالجمع باشند، آخرین مقدار درج‌شده (راست‌ترین وقوع) اعمال می‌شود\&. این رفتار مطابق با قواعد استاندارد ارزیابی در پوسته‌های رایج یونیکس است\&. .PP علاوه‌بر این، می‌توان یک یا چند فایل فرمان را با استفاده از نماد «@» به‌عنوان پیشوند نام فایل مشخص کرد (مانند \fI@command\&.txt\fP)\&. چنین آرگومان فرمانی، پیش از هرگونه ارزیابی بیشتر، با محتوای فایل متنی مربوطه جایگزین می‌شود (فاصله‌های متوالی به‌عنوان یک جداکنندهٔ واحد در نظر گرفته می‌شوند مگر اینکه میان دو علامت نقل‌قول قرار گرفته باشند)\&. لطفاً توجه داشته باشید که یک فایل فرمان نمی‌تواند حاوی فایل فرمان دیگری باشد\&. این رویکرد ساده اما کارآمد امکان خلاصه‌سازی ترکیب‌های معمول گزینه‌ها/پارامترها را فراهم کرده و از خطوط فرمان طولانی و سردرگم‌کننده جلوگیری می‌کند (یک نمونه در فایل \fI/dumppat\&.txt\fP ارائه شده است)\&. .SH "فایل‌ها (FILES)" .PP \fI/camera\&.lut\fP \- فایل مشخصات نمونه برای یک دوربین .br \fI/monitor\&.lut\fP \- فایل مشخصات نمونه برای یک مانیتور .br \fI/printer\&.lut\fP \- فایل مشخصات نمونه برای یک چاپگر .br \fI/scanner\&.lut\fP \- فایل مشخصات نمونه برای یک اسکنر .SH "همچنین ببینید (SEE ALSO)" .PP \fBdconvlum\fP(1), \fBdcod2lum\fP(1) .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP Copyright (C) 1999-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.