.TH "dcmdjpls" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmdjpls \- رمزگشایی فایل DICOM فشرده‌شده با JPEG-LS .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmdjpls [options] dcmfile-in dcmfile-out .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdcmdjpls\fP یک تصویر دایکام فشرده‌شده با JPEG-LS (\fIdcmfile-in\fP) را می‌خواند، داده‌های JPEG-LS را از حالت فشرده خارج می‌کند (یعنی تبدیل به نحو انتقال بومی دایکام) و تصویر تبدیل‌شده را در یک فایل خروجی (\fIdcmfile-out\fP) می‌نویسد\&. .SH "پارامترها (PARAMETERS)" .PP .PP .nf dcmfile-in نام فایل ورودی DICOM برای تبدیل ("-" برای ورودی استاندارد stdin) dcmfile-out نام فایل خروجی DICOM ("-" برای خروجی استاندارد stdout) .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 "گزینه‌های ورودی (input options)" .PP .nf قالب فایل ورودی: +f --read-file خواندن قالب فایل یا مجموعه داده (پیش‌فرض) +fo --read-file-only فقط خواندن قالب فایل -f --read-dataset خواندن مجموعه داده بدون متاداده‌های فایل # این گزینه امکان باز کردن اشیای DICOM فشرده‌شده با JPEG-LS را که به عنوان # مجموعه داده بدون هدر ذخیره شده‌اند فراهم می‌کند. .fi .PP .SS "گزینه‌های پردازش (processing options)" .PP .nf پیکربندی سطوح رنگی (planar configuration): +pr --planar-restore بازیابی پیکربندی سطحی اصلی (پیش‌فرض) # اگر تصویر فشرده‌شده یک تصویر رنگی باشد، پیکربندی سطحی را همان‌طور # که در ویژگی Planar Configuration توصیف شده بازیابی می‌کند. +pa --planar-auto تعیین خودکار پیکربندی سطحی از روی کلاس SOP و فضای رنگی # اگر تصویر رنگی باشد، در صورت نیاز کلاس SOP و تفسیر نورسنجی، # آن را با پیکربندی color-by-plane ذخیره می‌کند. +px --color-by-pixel ذخیره همیشگی به صورت رنگ به ازای هر پیکسل (color-by-pixel) +pl --color-by-plane ذخیره همیشگی به صورت رنگ به ازای هر صفحه (color-by-plane) شناسه نمونه SOP (SOP Instance UID): +ud --uid-default حفظ همان شناسه نمونه SOP (پیش‌فرض) +ua --uid-always همیشه شناسه جدید تخصیص داده شود گزینه‌های اصلاحی برای انکودینگ‌های نادرست JPEG-LS: +wi --workaround-incpl فعال‌سازی راهکار اصلاحی برای داده‌های ناقص JPEG-LS سایر گزینه‌های پردازش: +io --ignore-offsettable نادیده گرفتن جدول آفست هنگام خروج از فشرده‌سازی .fi .PP .SS "گزینه‌های خروجی (output options)" .PP .nf قالب فایل خروجی: +F --write-file نوشتن در قالب فایل (پیش‌فرض) -F --write-dataset نوشتن مجموعه داده بدون متاداده‌های فایل نحو انتقال خروجی: +te --write-xfer-little نوشتن با نحو صریح VR و ترتیب بایت little endian (پیش‌فرض) +tb --write-xfer-big نوشتن با نحو صریح VR و ترتیب بایت big endian +ti --write-xfer-implicit نوشتن با نحو ضمنی VR و ترتیب بایت little endian نمایش مقادیر بعد از سال ۱۹۹۳ (VR): +u --enable-new-vr فعال‌سازی پشتیبانی از VRهای جدید (UN/UT) (پیش‌فرض) -u --disable-new-vr غیرفعال کردن پشتیبانی از VRهای جدید، تبدیل به OB کدگذاری طول گروه: +g= --group-length-recalc محاسبه مجدد طول گروه‌ها در صورت وجود (پیش‌فرض) +g --group-length-create همیشه با عناصر طول گروه نوشته شود -g --group-length-remove همیشه بدون عناصر طول گروه نوشته شود کدگذاری طول در توالی‌ها و آیتم‌ها: +e --length-explicit نوشتن با طول‌های صریح (پیش‌فرض) -e --length-undefined نوشتن با طول‌های تعریف‌نشده پدینگ انتهای مجموعه داده (نه با --write-dataset): -p= --padding-retain عدم تغییر پدینگ (پیش‌فرض بدون --write-dataset) -p --padding-off بدون پدینگ (ضمنی در صورت استفاده از --write-dataset) +p --padding-create [f]ile-pad [i]tem-pad: integer تراز کردن فایل مضربی از f بایت و آیتم‌ها مضربی از i بایت .fi .PP .SH "نحوهای انتقال (TRANSFER SYNTAXES)" .PP ابزار \fBdcmdjpls\fP از نحوهای انتقال زیر برای ورودی (\fIdcmfile-in\fP) پشتیبانی می‌کند: .PP .PP .nf LittleEndianImplicitTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2 LittleEndianExplicitTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.1 DeflatedExplicitVRLittleEndianTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.1\&.99 (*) BigEndianExplicitTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.2 JPEGLSLosslessTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.4\&.80 JPEGLSLossyTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.4\&.81 .fi .PP .PP (*) در صورت کامپایل با پشتیبانی از zlib .PP ابزار \fBdcmdjpls\fP از نحوهای انتقال زیر برای خروجی (\fIdcmfile-out\fP) پشتیبانی می‌کند: .PP .PP .nf LittleEndianImplicitTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2 LittleEndianExplicitTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.1 BigEndianExplicitTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.2 .fi .PP .SH "گزارش‌گیری (LOGGING)" .PP سطح خروجی گزارش‌گیری ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر تعیین شود\&. به طور پیش‌فرض، فقط خطاها و هشدارها در جریان خطای استاندارد (stderr) نوشته می‌شوند\&. با استفاده از گزینه \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 گزینه‌های خط فرمان با علامت '+' یا '-' در ابتدا از پارامترها متمایز می‌شوند\&. معمولاً ترتیب و مکان گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند)\&. با این حال، اگر گزینه‌ها ناسازگار با یکدیگر باشند، آخرین مورد سمت راست اعمال می‌شود\&. این رفتار مطابق با قواعد استاندارد پوسته‌های متداول یونیکس است\&. .PP علاوه بر این، یک یا چند فایل حاوی دستور می‌توانند با استفاده از پیشوند '@' در ابتدای نام فایل مشخص شوند (مانند \fI@command\&.txt\fP)\&. چنین آرگومانی پیش از هرگونه بررسی بیشتر با محتوای فایل متنی مربوطه جایگزین می‌شود (فاصله‌های متوالی به عنوان یک جداکننده تلقی می‌شوند مگر اینکه درون علامت نقل‌قول باشند)\&. توجه داشته باشید که یک فایل دستور نمی‌تواند شامل فایل دستور دیگری باشد\&. این روش ساده امکان خلاصه‌سازی ترکیب‌های معمول گزینه‌ها/پارامترها را فراهم کرده و از خط فرمان‌های طولانی جلوگیری می‌کند (نمونه‌ای در فایل \fI/dumppat\&.txt\fP آورده شده است)\&. .SH "متغیرهای محیطی (ENVIRONMENT)" .PP ابزار \fBdcmdjpls\fP تلاش خواهد کرد تا واژه‌نامه‌های داده دایکام مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به طور پیش‌فرض، یعنی اگر متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری می‌شود مگر اینکه واژه‌نامه درون برنامه تعبیه شده باشد (پیش‌فرض در ویندوز)\&. .PP رفتار پیش‌فرض ترجیح داده می‌شود و متغیر محیطی \fIDCMDICTPATH\fP تنها زمانی باید استفاده شود که واژه‌نامه‌های جایگزین مورد نیاز باشند\&. متغیر محیطی \fIDCMDICTPATH\fP قالبی مشابه با متغیر \fIPATH\fP شل یونیکس دارد و دونقطه (":") ورودی‌ها را جدا می‌کند\&. در سیستم‌های ویندوز از نقطه‌ویرگول (";") به عنوان جداکننده استفاده می‌شود\&. کد واژه‌نامه داده تلاش خواهد کرد تا هر فایل مشخص‌شده در متغیر \fIDCMDICTPATH\fP را بارگذاری کند\&. در صورت عدم امکان بارگذاری هیچ واژه‌نامه‌ای، خطا رخ خواهد داد\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBdcmcjpls\fP(1) .SH "حق نشر (COPYRIGHT)" .PP Copyright (C) 2009-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.