\
.\" 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 "راهنمای کاربری Pamfile" 0 "04 July 2020" "مستندات netpbm"

.SH "نام (NAME)"
pamfile \- نمایش مشخصات ابعاد و ویژگی‌های تصویر در قالب Netpbm

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

\fBpamfile\fP

[\fB-allimages\fP]
[\fB-comments\fP]
[\fB-count\fP]
[\fB-machine\fP]
[\fB-size\fP]

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

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

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


.TP
\fB-allimages\fP
این گزینه باعث می‌شود
\fBpamfile\fP
تمام تصاویر موجود در هر فایل ورودی را توصیف کند. بدون این گزینه،
\fBpamfile\fP
فقط اولین تصویر در هر فایل ورودی را توصیف می‌کند.
.sp
این گزینه همچنین باعث می‌شود
\fBpamfile\fP
تمام تصاویر را از جریان ورودی بخواند، در حالی که بدون آن،
\fBpamfile\fP
فقط سربرگ اولین تصویر را می‌خواند. اگر جریان ورودی از یک لوله (pipe) باشد، فرآیندی که داده‌ها را به لوله تزریق می‌کند ممکن است نیاز داشته باشد کل جریان مصرف شود. در این صورت، حتی اگر جریان تنها شامل یک تصویر باشد از این گزینه استفاده کنید.
.sp
در صورت تعیین گزینه
\fB-count\fP\c
، این گزینه هیچ تأثیری ندارد.
.sp
توجه داشته باشید که پیش از ژوئیه ۲۰۰۰، یک فایل نمی‌توانست شامل بیش از یک تصویر باشد و بسیاری از برنامه‌ها همه تصاویر به‌جز اولین تصویر را نادیده می‌گیرند.
.sp
این گزینه در Netpbm 9.5 (ژوئیه ۲۰۰۰) معرفی شد.

.TP
\fB-comments\fP
این گزینه باعث می‌شود
\fBpamfile\fP
برای هر تصویر PAM گزارشی از توضیحات (کامنت‌های) سربرگ تصویر را ارائه دهد.
.sp
برای تصاویر PBM، PGM یا PPM، دستور
\fBpamfile\fP
گزارش می‌دهد که هیچ توضیحی وجود ندارد، حتی اگر وجود داشته باشد.
.sp
این گزینه در Netpbm 10.35 (اوت ۲۰۰۶) معرفی شد.

.TP
\fB-count\fP
این گزینه باعث می‌شود
\fBpamfile\fP
تنها تعداد تصاویر موجود در هر فایل ورودی را نمایش دهد.
.sp
همانند
\fB-allimages\fP\c
، این گزینه باعث می‌شود
\fBpamfile\fP
تمام تصاویر را بخواند.
.sp
می‌توانید حداکثر یکی از گزینه‌های
\fB-count\fP\c
،
\fB-machine\fP
و
\fB-size\fP
را مشخص کنید.
.sp
این گزینه در Netpbm 10.31 (دسامبر ۲۰۰۵) معرفی شد.

.TP
\fB-machine\fP
این گزینه خروجی را برای پردازش ماشینی مناسب‌تر و برای خواندن انسان کمتر مناسب می‌کند.
\fBpamfile\fP
همان اطلاعات حالت بدون گزینه را گزارش می‌دهد.
.sp
خروجی شامل یک خط متن ASCII به ازای هر تصویر است. هر خط از نام فایل، به دنبال آن دونقطه، یک فاصله و سپس نشانه‌های زیر تشکیل می‌شود که با فاصله از یکدیگر جدا شده‌اند:


.IP \(bu
قالب (Format): مقادیر 'PAM'، 'PBM'، 'PGM' یا 'PPM'
.IP \(bu
زیرقالب (Subformat): مقادیر 'PLAIN' یا 'RAW'
.IP \(bu
عرض (Width): بر حسب پیکسل، در مبنای ده‌دهی
.IP \(bu
ارتفاع (Height): بر حسب پیکسل، در مبنای ده‌دهی
.IP \(bu
عمق (Depth): در مبنای ده‌دهی
.IP \(bu
حداکثر مقدار (Maxval): در مبنای ده‌دهی (اگر تصویر PBM باشد برابر ۱ است)
.IP \(bu
نوع چندتایی (Tuple type): شبیه‌سازی‌شده در صورتی که تصویر PAM نباشد

.sp
می‌توانید حداکثر یکی از گزینه‌های
\fB-count\fP\c
،
\fB-machine\fP
و
\fB-size\fP
را مشخص کنید.
.sp
این گزینه در Netpbm 10.86 (مارس ۲۰۱۹) معرفی شد.

.TP
\fB-size\fP
این گزینه باعث می‌شود خروجی تنها شامل عرض و ارتفاع تصویر باشد، در قالبی که برای پردازش ماشینی مناسب است.
.sp
یک خط خروجی به ازای هر تصویر تولید می‌شود که از دو نشانه جداشده با فاصله تشکیل شده است:


.IP \(bu
عرض: بر حسب پیکسل، در مبنای ده‌دهی
.IP \(bu
ارتفاع: بر حسب پیکسل، در مبنای ده‌دهی

.sp
توجه داشته باشید که اگر چندین فایل ورودی با چندین تصویر داشته باشید، راهی برای تشخیص اینکه کدام تصویر در کدام فایل است وجود ندارد. در این صورت، از
\fB-machine\fP
استفاده کنید.
.sp
می‌توانید حداکثر یکی از گزینه‌های
\fB-count\fP\c
،
\fB-machine\fP
و
\fB-size\fP
را مشخص کنید.
.sp
این گزینه در Netpbm 10.86 (مارس ۲۰۱۹) معرفی شد.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pam" (1)\c
\&,
.BR "ppmhist" (1)\c
\&,
\fBfile\fP

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

حق نشر \(co ۱۹۹۱ توسط Jef Poskanzer.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' متعلق به Netpbm از منبع HTML ایجاد شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamfile.html
.PP