.TH "dcmcrle" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*- .nh .SH "نام (NAME)" dcmcrle \- کدگذاری فایل DICOM به سینتکس انتقال RLE .PP .SH "خلاصه دستور (SYNOPSIS)" .PP .PP .nf dcmcrle [options] dcmfile-in dcmfile-out .fi .PP .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBdcmcrle\fP یک تصویر غیرفشرده DICOM (\fIdcmfile-in\fP) را می‌خواند، فشرده‌سازی RLE (یعنی تبدیل به یک سینتکس انتقال کپسوله‌شده DICOM) را انجام می‌دهد و تصویر تبدیل‌شده را در یک فایل خروجی (\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 خواندن مجموعه داده بدون اطلاعات فراداده‌ای فایل سینتکس انتقال ورودی: -t= --read-xfer-auto استفاده از تشخیص TS (پیش‌فرض) -td --read-xfer-detect نادیده گرفتن TS مشخص‌شده در سرآیند متای فایل -te --read-xfer-little خواندن با TS دارای VR صریح و little endian -tb --read-xfer-big خواندن با TS دارای VR صریح و big endian -ti --read-xfer-implicit خواندن با TS دارای VR ضمنی و little endian .fi .PP .SS "گزینه‌های کدگذاری داده‌های پیکسلی کپسوله‌شده (encapsulated pixel data encoding options)" .PP .nf قطعه‌بندی داده‌های پیکسلی: +ff --fragment-per-frame کدگذاری هر فریم به عنوان یک قطعه (پیش‌فرض) +fs --fragment-size [s]ize: integer محدود کردن اندازه قطعه به s کیلوبایت (غیر استاندارد) کدگذاری جدول آفست پایه: +ot --offset-table-create ایجاد جدول آفست (پیش‌فرض) -ot --offset-table-empty خالی گذاشتن جدول آفست SOP Class UID: +cd --class-default حفظ SOP Class UID (پیش‌فرض) +cs --class-sc تبدیل به Secondary Capture Image (مستلزم --uid-always) SOP Instance UID: +un --uid-never هرگز UID جدید تخصیص داده نشود (پیش‌فرض) +ua --uid-always همیشه UID جدید تخصیص داده شود .fi .PP .SS "گزینه‌های خروجی (output options)" .PP .nf بازنمودهای مقدار پس از ۱۹۹۳ (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 نوشتن با طول‌های تعریف‌نشده فاصله‌گذاری انتهایی مجموعه داده (padding): -p= --padding-retain تغییر ندادن فاصله‌گذاری (پیش‌فرض) -p --padding-off بدون فاصله‌گذاری +p --padding-create [f]ile-pad [i]tem-pad: integer تراز کردن فایل روی مضربی از f بایت و آیتم‌ها روی مضربی از i بایت .fi .PP .SH "نکات (NOTES)" .PP ابزار \fBdcmcrle\fP تصاویر DICOM مربوط به تمام کلاس‌های SOP را فشرده می‌کند\&. این ابزار تمام عناصر Pixel Data (7fe0,0010) را در مجموعه داده پردازش می‌کند، یعنی فشرده‌سازی روی تصویر آیکون (icon image) نیز انجام می‌شود\&. .PP لطفاً توجه داشته باشید که استاندارد DICOM ذخیره‌سازی داده‌های پیکسلی را با چندین قطعه در هر فریم (هنگام استفاده از فشرده‌سازی RLE) مجاز نمی‌داند\&. بنابراین محدود کردن اندازه قطعه با گزینه \fI--fragment-size\fP (یا \fI+fs\fP) ممکن است منجر به ایجاد یک تصویر DICOM ناسازگار با استاندارد شود\&. .SH "سینتکس‌های انتقال (TRANSFER SYNTAXES)" .PP \fBdcmcrle\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 .fi .PP .PP (*) در صورتی که با فعال بودن پشتیبانی از zlib کامپایل شده باشد .PP \fBdcmcrle\fP از سینتکس‌های انتقال زیر برای خروجی (\fIdcmfile-out\fP) پشتیبانی می‌کند: .PP .PP .nf RLELosslessTransferSyntax 1\&.2\&.840\&.10008\&.1\&.2\&.5 .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 گزینه‌های خط فرمان به ترتیب با یک علامت پیشوند «+» یا «-» از پارامترها متمایز می‌شوند\&. معمولاً ترتیب و موقعیت گزینه‌های خط فرمان اختیاری است (یعنی می‌توانند در هر جایی ظاهر شوند)\&. با این حال، اگر گزینه‌ها مانعة‌الجمع باشند، راست‌ترین گزینه اعمال می‌شود\&. این رفتار مطابق با قواعد ارزیابی استاندارد در شل‌های رایج یونیکس است\&. .PP علاوه بر این، یک یا چند فایل دستور را می‌توان با استفاده از علامت «@» به عنوان پیشوند نام فایل مشخص کرد (مانند \fI@command\&.txt\fP)\&. چنین آرگومان دستوری قبل از هرگونه ارزیابی بیشتر، با محتوای فایل متنی مربوطه جایگزین می‌شود (چندین نویسه فاصله‌گذاری سفید به عنوان یک جداکننده واحد در نظر گرفته می‌شوند مگر اینکه بین دو علامت نقل‌قول قرار گیرند)\&. لطفاً توجه داشته باشید که یک فایل دستور نمی‌تواند حاوی فایل دستور دیگری باشد\&. این رویکرد ساده اما مؤثر اجازه می‌دهد تا ترکیب‌های رایج گزینه‌ها/پارامترها خلاصه شده و از خطوط فرمان طولانی و گیج‌کننده جلوگیری شود (یک نمونه در فایل \fI/dumppat\&.txt\fP ارائه شده است)\&. .SH "محیط (ENVIRONMENT)" .PP ابزار \fBdcmcrle\fP تلاش خواهد کرد دیکشنری‌های داده DICOM مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. به طور پیش‌فرض، یعنی اگر متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه دیکشنری درون خود برنامه تعبیه شده باشد (پیش‌فرض برای ویندوز)\&. .PP رفتار پیش‌فرض باید ترجیح داده شود و متغیر محیطی \fIDCMDICTPATH\fP تنها زمانی استفاده شود که دیکشنری‌های داده جایگزین مورد نیاز باشند\&. متغیر محیطی \fIDCMDICTPATH\fP قالبی مشابه متغیر \fIPATH\fP شل یونیکس دارد که در آن دونقطه (":") مدخل‌ها را از هم جدا می‌کند\&. در سیستم‌های ویندوز، از نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود\&. کد دیکشنری داده تلاش خواهد کرد تا هر فایل مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند\&. در صورتی که هیچ دیکشنری داده‌ای بارگذاری نشود، یک خطا محسوب می‌شود\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBdcmdrle\fP(1) .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .PP کپی‌رایت (C) 2002-2025 توسط OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany\&.