\
.\" 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 "Pamsplit User Manual" 0 "11 August 2011" "netpbm documentation"

.SH "نام (NAME)"

pamsplit \- تفکیک یک فایل چندتصویری Netpbm به فایل‌های تک‌تصویری

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

\fBpamsplit\fP

[\fInetpbmfile\fP

[\fI output_file_pattern\fP]]

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


.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamsplit\fP یک جریان PNM یا PAM را به عنوان ورودی می‌خواند. این برنامه هر تصویر
موجود در ورودی را در یک فایل جداگانه و با همان قالب کپی می‌کند.
.PP
شناسه \fInetpbmfile\fP نام فایل ورودی است، یا
\fB-\fP برای مشخص کردن ورودی استاندارد (Standard Input). پیش‌فرض ورودی استاندارد است.
.PP
الگوی \fIoutput_file_pattern\fP نحوه نام‌گذاری فایل‌های خروجی را مشخص می‌کند. این
همان نام فایل خروجی است، با این تفاوت که نخستین
تکرار "%d" در آن با شماره ترتیبی تصویر به صورت ده‌دهی ASCII بدون صفر پرکننده
جایگزین می‌شود، به طوری که شماره‌گذاری از 0 شروع می‌شود. اگر
هیچ "%d" در الگو وجود نداشته باشد، اجرای \fBpamsplit\fP با شکست مواجه می‌شود.
.PP
الگوی پیش‌فرض فایل خروجی "image%d" است.
.PP
گزینه \fB-padname\fP مشخص می‌کند که می‌خواهید شماره ترتیبی تصویر در نام فایل خروجی با چند نویسه
صفر پر شود (پد شود). دستور \fBpamsplit\fP
در صورت نیاز، صفرهای ابتدایی را به شماره ترتیبی تصویر اضافه می‌کند تا دست‌کم به
آن تعداد نویسه برسد. این مقدار صرفاً تعداد نویسه‌ها در بخش شماره ترتیبیِ نام است.
برای مثال، \f(CWpamsplit - outputfile%d.ppm -padname=3\fP نام‌های خروجی
\fBoutputfile000.ppm\fP، \fBoutputfile001.ppm\fP و غیره را تولید می‌کند.
.PP
توجه داشته باشید که برای انجام عملیات معکوس (ترکیب چند فایل
تک‌تصویری Netpbm در یک فایل چندتصویری)، برنامه خاصی در Netpbm وجود ندارد.
تنها از دستور \fBcat\fP استفاده کنید.
.PP
اگر فقط می‌خواهید اطلاعات اولیه‌ای درباره تصاویر موجود در یک
جریان به دست آورید، می‌توانید از \fBpamfile\fP بر روی آن جریان استفاده کنید.
.PP
برای استخراج تصاویر از یک جریان و تولید یک جریان واحد شامل
آن‌ها، از \fBpampick\fP استفاده کنید.
.PP
برای اجرای یک برنامه روی هر تصویر در یک جریان بدون دردسرهای فایل‌های
موقت، از \fBpamexec\fP استفاده کنید.


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


.TP
\fB-padname=\fP\fIn\fP
عرض (یعنی تعداد ارقام) فیلد شماره ترتیبی تصویر را در نام‌های
فایل‌های خروجی مشخص می‌کند. شماره ترتیبی تصویر با صفرهای ابتدایی پر
می‌شود تا به عرض تعیین‌شده برسد.
.sp
پیش‌فرض بدون پرکننده است (معادل \fB-padname=0\fP).
.sp
گزینه \fB-padname\fP در Netpbm 10.23 (ژوئیه ۲۰۰۴) جدید بود.
پیش از آن، هرگز هیچ پرکننده‌ای وجود نداشت.



.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamsplit\fP در Netpbm 9.5 (ژوئیه ۲۰۰۰) و با نام \fBpnmsplit\fP عرضه شد. در
Netpbm 10.31 (دسامبر ۲۰۰۵)، توانایی تقسیم فایل‌های PAM را به دست آورد و
تغییر نام داد.
                 
.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamfile" (1)\c
\&,
.BR "pampick" (1)\c
\&,
.BR "pamexec" (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/pamsplit.html
.PP