\
.\" 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 "Pamexec User Manual" 0 "21 December 2021" "netpbm documentation"

.SH "نام (NAME)"
pamexec \- اجرای یک دستور شل روی هر تصویر در یک جریان تصویر Netpbm

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

\fBpamexec\fP

["\fIcommand\fP"]

[\fInetpbmfile\fP]

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


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamexec\fP یک جریان تصویر Netpbm را به‌عنوان ورودی می‌خواند. برای هر تصویر، یک دستور شل مشخص‌شده را اجرا می‌کند و تصویر را از طریق Standard Input (با یک pipe) به آن تحویل می‌دهد.
.PP
آرگومان \fInetpbmfile\fP نام فایل ورودی، یا \fB-\fP برای مشخص کردن Standard Input است. پیش‌فرض Standard Input می‌باشد.
.PP
بسیاری از برنامه‌های Netpbm خودشان جریان‌های چندتصویری Netpbm را درک می‌کنند، بنابراین نیازی نیست از \fBpamexec\fP برای اجرای برنامه روی تصاویر موجود در جریان استفاده کنید. در حالت ایده‌آل، تمام برنامه‌های Netpbm باید چنین قابلیتی داشته باشند، اما جریان‌های چندتصویری نوآوری نسبتاً جدیدی هستند، بنابراین برنامه‌های قدیمی‌تر Netpbm فقط اولین تصویر را در جریان پردازش کرده و متوقف می‌شوند. حتی بسیاری از برنامه‌های جدید Netpbm نیز به همین شیوه کار می‌کنند، زیرا نویسندگان آن‌ها از امکان چندتصویری آگاه نبوده‌اند.
.PP
روش دیگر برای پردازش یک جریان چندتصویری، استفاده از \fBpamsplit\fP برای تفکیک آن به چندین فایل (یک تصویر در هر فایل) است. سپس می‌توانید آن فایل‌ها را پردازش کنید.
.PP
برای اجرای دستور خود روی زیرمجموعه‌ای از تصاویر موجود در جریان، از \fBpampick\fP برای انتخاب تصاویر مورد نظر از جریان ورودی و هدایت (pipe) نتیجه به \fBpamexec\fP استفاده کنید.


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


.TP
\fB-check\fP
در صورتی که دستور با یک وضعیت خروج غیر صفر پایان یابد، این گزینه باعث می‌شود \fBpamexec\fP بدون پردازش هیچ تصویر دیگری خارج شود.



.UN applications
.SH "کاربردها (APPLICATIONS)"

برای ساخت یک پویانمایی GIF:

.nf
\f(CW
    pamexec pamtogif myvideo.ppm | gifsicle --multifile >myvideo.gif
\fP
.fi

.UN limitations
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
دستور \fBpamexec\fP فرض می‌کند تمام دستورها کل Standard Input را مصرف می‌کنند. اگر دستور شما این‌گونه عمل نمی‌کند (برای مثال، به محض دریافت مقدار کافی داده خارج می‌شود)، می‌توانید با استفاده از یک فایل موقت مانند زیر داده‌ها را بافر کنید، که ۳ سطر اول هر تصویر (هدر PPM) را در Standard Output کپی می‌کند:

.nf
\f(CW
    pamexec "cat >/tmp/x; head --lines=3 x" myvideo.ppm  
\fP
.fi

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamexec\fP در Netpbm 10.56 (سپتامبر ۲۰۱۱) معرفی شد.
.PP
این برنامه توسط Michael Pot با الهام و الگوبرداری از \fBpamsplit\fP نوشته شده است.


.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamfile" (1)\c
\&،
.BR "pampick" (1)\c
\&،
.BR "pamsplit" (1)\c
\&،
.BR "pnm" (1)\c
\&،
.BR "pam" (1)\c
\&،
صفحه راهنمای \fBcat\fP
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از روی منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamexec.html
.PP