.TH "dcmdrle" 1 "Thu Jul 9 2026 18:43:40" "Version 3.7.0" "OFFIS DCMTK" \" -*- nroff -*-
.nh
.SH "نام (NAME)"
dcmdrle \- رمزگشایی فایل دایکام فشرده‌شده با الگوریتم RLE
.PP

.SH "خلاصه دستور (SYNOPSIS)"
.PP
.PP
.nf
dcmdrle [options] dcmfile-in dcmfile-out
.fi
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار \fBdcmdrle\fP یک تصویر دایکام فشرده‌شده با RLE را می‌خواند (\fIdcmfile-in\fP)، داده‌های تصویر را از حالت فشرده خارج می‌کند (یعنی تبدیل به یک نحو انتقال بومی دایکام) و تصویر تبدیل‌شده را در یک فایل خروجی می‌نویسد (\fIdcmfile-out\fP).
.SH "پارامترها (PARAMETERS)"
.PP
.PP
.nf
dcmfile-in   نام فایل ورودی دایکام برای تبدیل ("-" برای ورودی استاندارد)

dcmfile-out  نام فایل خروجی دایکام ("-" برای خروجی استاندارد)
.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
         خواندن مجموعه داده بدون اطلاعات متای فایل

  # این گزینه امکان بازگشایی اشیاء دایکام فشرده‌شده با RLE را که بدون
  # هدر متادیتا ذخیره شده‌اند فراهم می‌کند. چنین چیزی نباید وجود داشته باشد
  # زیرا بدون متادیتا نحو انتقال به طور قابل اعتماد قابل تشخیص نیست،
  # اما متأسفانه وجود دارد.
.fi
.PP
.SS "گزینه‌های پردازش (processing options)"
.PP
.nf
شناسه یکتای نمونه SOP:

  +ud  --uid-default
         نگه‌داشتن همان شناسه یکتای نمونه SOP (پیش‌فرض)

  +ua  --uid-always
         همیشه اختصاص دادن UID جدید

ترتیب بخش‌های بایت RLE:

  +bd  --byte-order-default
         ابتدا باارزش‌ترین بایت (پیش‌فرض)

  +br  --byte-order-reverse
         ابتدا کم‌ارزش‌ترین بایت

  # این گزینه امکان خارج کردن از فشردگی فایل‌های دایکام RLE را فراهم می‌کند
  # که در آن‌ها ترتیب قطعات بایت اشتباه کدگذاری شده است. این تنها بر روی
  # تصاویری با بیش از یک بایت در هر نمونه تأثیر می‌گذارد.
.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

نمایش مقادیر پس از ۱۹۹۳:

  +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
ابزار \fBdcmdrle\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
RLELosslessTransferSyntax                      1\&.2\&.840\&.10008\&.1\&.2\&.5
.fi
.PP

.PP
(*) در صورت فعال بودن پشتیبانی از zlib در زمان کامپایل

.PP
ابزار \fBdcmdrle\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
سطح خروجی ثبت وقایع ابزارهای مختلف خط فرمان و کتابخانه‌های زیربنایی می‌تواند توسط کاربر مشخص شود. به طور پیش‌فرض، تنها خطاها و هشدارها در خروجی استاندارد خطا نوشته می‌شوند. با استفاده از گزینه \fI--verbose\fP پیام‌های اطلاع‌رسانی مانند جزئیات پردازش نیز گزارش می‌شوند. گزینه \fI--debug\fP می‌تواند برای دریافت جزئیات بیشتر درباره فعالیت‌های داخلی، برای نمونه جهت اشکال‌زدایی، استفاده شود. سایر سطوح لاگ را می‌توان با گزینه \fI--log-level\fP انتخاب کرد. در حالت \fI--quiet\fP تنها خطاهای مهلک گزارش می‌شوند. در چنین رخدادهای خطای بسیار شدیدی، برنامه معمولاً خاتمه می‌یابد. برای جزئیات بیشتر درباره سطوح مختلف لاگ، به مستندات ماژول "oflog" مراجعه کنید.

.PP
در صورتی که خروجی ثبت وقایع باید در فایل نوشته شود (اختیاراً همراه با چرخش فایل لاگ)، در syslog (یونیکس) یا گزارش رویدادها (ویندوز)، گزینه \fI--log-config\fP می‌تواند استفاده شود. این فایل پیکربندی همچنین امکان هدایت پیام‌های خاص به جریان خروجی مشخص و فیلتر کردن پیام‌ها بر اساس ماژول یا برنامه‌ای که در آن تولید شده‌اند را فراهم می‌کند. یک نمونه فایل پیکربندی در \fI<etcdir>/logger\&.cfg\fP ارائه شده است.
.SH "خط فرمان (COMMAND LINE)"
.PP
تمام ابزارهای خط فرمان از نشانه‌گذاری زیر برای پارامترها استفاده می‌کنند: براکت‌های مربعی مقادیر اختیاری را احاطه می‌کنند (0-1)، سه نقطه پایانی نشان می‌دهد که مقادیر متعدد مجاز است (1-n)، و ترکیبی از هر دو به معنی 0 تا n مقدار است.

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

.PP
علاوه بر این، یک یا چند فایل دستور را می‌توان با پیشوند '@' قبل از نام فایل تعیین کرد (مانند \fI@command\&.txt\fP). چنین آرگومان دستوری پیش از هرگونه ارزیابی بیشتر، با محتوای فایل متنی مربوطه جایگزین می‌شود (چندین فاصله سفید به عنوان یک جداکننده منفرد در نظر گرفته می‌شوند مگر اینکه بین دو گیومه باشند). لطفاً توجه داشته باشید که یک فایل دستور نمی‌تواند حاوی فایل دستور دیگری باشد. این رویکرد ساده اما مؤثر امکان خلاصه‌سازی ترکیب‌های متداول گزینه‌ها/پارامترها را می‌دهد و از خطوط فرمان طولانی و گیج‌کننده جلوگیری می‌کند (یک مثال در فایل \fI<datadir>/dumppat\&.txt\fP ارائه شده است).
.SH "متغیرهای محیطی (ENVIRONMENT)"
.PP
ابزار \fBdcmdrle\fP تلاش خواهد کرد فرهنگ‌های داده دایکام را که در متغیر محیطی \fIDCMDICTPATH\fP مشخص شده‌اند، بارگذاری کند. به طور پیش‌فرض، یعنی اگر متغیر محیطی \fIDCMDICTPATH\fP تنظیم نشده باشد، فایل \fI<datadir>/dicom\&.dic\fP بارگذاری خواهد شد مگر اینکه فرهنگ داده درون برنامه ساخته شده باشد (پیش‌فرض برای ویندوز).

.PP
رفتار پیش‌فرض ارجح است و متغیر محیطی \fIDCMDICTPATH\fP تنها زمانی باید استفاده شود که فرهنگ‌های داده جایگزین مورد نیاز باشد. متغیر محیطی \fIDCMDICTPATH\fP همان قالبی را دارد که متغیر \fIPATH\fP پوسته یونیکس دارد، به این صورت که علامت دونقطه (":") ورودی‌ها را جدا می‌کند. در سیستم‌های ویندوز، نقطه ویرگول (";") به عنوان جداکننده استفاده می‌شود. کد فرهنگ داده تلاش خواهد کرد هر فایل مشخص‌شده در متغیر محیطی \fIDCMDICTPATH\fP را بارگذاری کند. اگر هیچ فرهنگ داده‌ای بارگذاری نشود، یک خطا محسوب می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdcmcrle\fP(1)
.SH "حق نشر (COPYRIGHT)"
.PP
Copyright (C) 2002-2025 by OFFIS e\&.V\&., Escherweg 2, 26121 Oldenburg, Germany