\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamrestack User Manual" 0 "" "netpbm documentation"

Updated:
.SH "نام (NAME)"
pamrestack \- بازآرایی سطرهای یک تصویر Netpbm

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBpamrestack\fP

[\fB-width=\fP\fIwidth\fP]

[\fB-trim=\fP{\fBfill\fP|\fBcrop\fP|\fBabort\fP}]

[\fB-verbose\fP]

[\fIpamfile\fP]
.PP
کوتاه‌ترین اختصارات یکتای گزینه‌ها پذیرفته می‌شوند. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسهٔ فاصله برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamrestack\fP پیکسل‌های یک تصویر Netpbm را در سطرهایی با اندازهٔ متفاوت بازآرایی می‌کند. برای نمونه، اگر تصویری ۱۰۰ پیکسل عرض و ۵۰ پیکسل ارتفاع داشته باشد، می‌توانید آن را به عرض ۱۲۵ و ارتفاع ۴۰ بازآرایی کنید. در این حالت، ۲۵ پیکسل از ابتدای سطر دوم ورودی به انتهای سطر اول ورودی منتقل می‌شود، ۵۰ پیکسل از سطر سوم به سطر دوم منتقل می‌گردد، و به همین ترتیب ادامه می‌یابد.
.PP
به بیان دیگر، \fBpamrestack\fP تمام سطرهای ورودی را در یک دنبالهٔ طولانی مرتب می‌کند و سطرهای خروجی را بر اساس خروج به ترتیب ورود (FIFO) از آن تولید می‌کند.
.PP
اگر فایل ورودی \fIpamfile\fP را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.
.PP
خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود.
.PP
دستور \fBpamrestack\fP روی یک جریان چندتصویری (multi-image stream) کار می‌کند. این برنامه هر تصویر موجود در جریان را به‌طور جداگانه برش می‌دهد و یک جریان چندتصویری در خروجی تولید می‌کند.


.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm
(به‌ویژه \fB-quiet\fP؛ ببینید 
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
\&)، دستور \fBpamrestack\fP گزینه‌های خط فرمان زیر را می‌شناسد:


.TP
\fB-width=\fP\fIwidth\fP
عرض خروجی. اگر این گزینه مشخص نشود، خروجی شامل یک سطر تک خواهد بود که پهنای آن برای در بر گرفتن تمام پیکسل‌های تصویر ورودی کافی است.

.TP
\fB-trim=\fP{\fBfill\fP|\fBcrop\fP|\fBabort\fP}
این گزینه مشخص می‌کند هنگامی که عرض جدید نتواند تعداد پیکسل‌های تصویر ورودی را به‌طور دقیق و بدون باقی‌مانده تقسیم کند، چه کاری انجام شود.


.TP
\fBfill\fP
  
(پیش‌فرض) سطر پایانی را در صورت نیاز با افزودن پیکسل‌های سیاه تکمیل می‌کند.

.TP
\fBcrop\fP
    
سطر ناقص پایانی را دور می‌ریزد. اگر این کار باعث شود هیچ چیزی برای خروجی نماند، برنامه با شکست پایان می‌یابد.

.TP
\fBabort\fP
  
برنامه را با خطا متوقف می‌کند.

  
.TP
\fB-verbose\fP
اطلاعات مربوط به پردازش را در خطای استاندارد (Standard Error) چاپ می‌کند.



.UN usage
.SH "نحوه استفاده (USAGE)"
.PP
دستور \fBpamrestack\fP یک ویرایشگر همه‌منظوره با کاربردهای بالقوه فراوان است.

.IP \(bu

    دستور \fBpamrestack\fP می‌تواند تصاویر تک‌بُعدی ایجاد شده توسط برنامه‌هایی مانند \fBppmhist\fP و \fBpamseq\fP را به مستطیل بازآرایی کند. این کار بررسی خروجی را با یک نمایشگر تصویر آسان‌تر می‌سازد. برعکس، می‌توان از \fBpamrestack\fP برای تبدیل یک تصویر مستطیلی معمولی به یک سطر عریض یا یک ستون بلند استفاده کرد؛ چنانچه این کار برای فشرده‌سازی، تبدیل یا تحلیل مورد نظر باشد.

.IP \(bu

    دستور \fBpamrestack\fP می‌تواند تصاویری را که به دلیل مقدار عرض نادرست در سرآیند خراب شده‌اند، بازسازی کند. تصاویری که از دستگاه framebuffer دریافت می‌شوند اغلب دچار این مشکل هستند.

.IP \(bu
دستور \fBpamrestack\fP می‌تواند به همراه \fBpamdice\fP، \fBpamundice\fP، \fBpamcat\fP و غیره برای تقسیم و ترکیب تصاویر در فرآیند درهم‌آمیزی (interlacing) به کار رود.
  


.UN examples
.SH "مثال‌ها (EXAMPLES)"


.IP \(bu
بازآرایی خروجی یک‌بُعدی \fBpamseq\fP به صورت یک مربع:

.nf
\f(CW
pamseq 3 255 | pamrestack -width=4096
\fP
.fi

.IP \(bu
ترکیب دو فایل که هر یک ۶۰۰ پیکسل عرض دارند، یکی شامل سطرهای فرد و دیگری شامل سطرهای زوج، برای ساختن یک تصویر درهم‌بافته:

.nf
\f(CW
pamcat -leftright oddrows.ppm evenrows.ppm | pamrestack -width=600
\fP
.fi


.IP \(bu
مشابه مورد بالا، اما با معکوس کردن افقی تمام پیکسل‌ها در سطرهای زوج از چپ به راست برای تولید درهم‌بافتگی مارپیچ (serpentine):

.nf
\f(CW
  pamflip -leftright evenrows.ppm |
    pamcat -leftright oddrows.ppm - |
      pamrestack -width 600
\fP
.fi



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamseq" (1)\c
\&،
.BR "ppmhist" (1)\c
\&،
.BR "pnmshear" (1)\c
\&،
.BR "pamscale" (1)\c
\&،
.BR "pamdeinterlace" (1)\c
\&،
.BR "pamdice" (1)\c
\&،
.BR "pamundice" (1)\c
\&،
.BR "pamcat" (1)\c
\&،
.BR "pam" (1)\c
\&


.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamrestack\fP در Netpbm 10.99 (ژوئن ۲۰۲۲) معرفی شد.


.UN author
.SH "نویسنده (AUTHOR)"

نوشته شده توسط Akira F. Urushibata. توسط نویسنده به مالکیت عمومی (public domain) واگذار شده است.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحهٔ راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamrestack.html
.PP