\
.\" 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 "راهنمای کاربر Pamslice" 1 "08 February 2010" "netpbm documentation"

.SH "نام (NAME)"
pamslice \- استخراج یک ردیف یا ستون از مقادیر پیکسل‌های تصویر Netpbm

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

\fBpamslice\fP
{\fB-row=\fP\fIrownumber\fP | \fB-column=\fP\fIcolumnnumber\fP}
[\fB-plane=\fP\fIplanenumber\fP]
[\fIimagefile\fP]

.SH "نحوه استفاده از گزینه‌ها (OPTION USAGE)"
.PP
تمام گزینه‌ها می‌توانند به کوتاه‌ترین پیشوند یکتای خود خلاصه شوند.
می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید
نام گزینه و مقدار آن را به جای علامت مساوی با فاصله از هم جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamslice\fP یک سطر از چندتایی‌ها (پیکسل‌ها) را از یک
تصویر Netpbm استخراج کرده و مقادیر آن‌ها را در یک جدول چاپ می‌کند. منظور از سطر، یک ردیف
یا یک ستون است. این برنامه یک برش مقطعی یک‌بعدی از یک تصویر
دوبعدی را به شما نمایش می‌دهد (با گزینه \fB-plane\fP می‌توان آن را
به عنوان یک برش مقطعی یک‌بعدی از یک تصویر سه‌بعدی در نظر گرفت).
.PP
این جدول برای هر چندتایی دارای یک خط است که شامل اعداد ده‌دهی ASCII جداشده با فاصله می‌باشد.
نخستین عدد، شماره ستون (در صورت تعیین برش ردیفی) یا شماره ردیف (در صورت تعیین
برش ستونی) است. سایر اعداد، مقادیر نمونه‌ها به ترتیب شماره صفحه (plane) هستند.
برای ورودی PBM یا PGM تنها یک صفحه وجود دارد. برای ورودی PPM،
صفحه ۰ قرمز، صفحه ۱ سبز و صفحه ۲ آبی است. برای جزئیات دقیق درباره مفهوم این اعداد،
به مشخصات قالب‌های تصویری مراجعه کنید.
.PP
اگر می‌خواهید کل ساختار رستر یک تصویر Netpbm را مشاهده کنید، از
\fBpamtable\fP استفاده کنید.

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

.TP
\fB-row=\fP\fIrownumber\fP
مشخص می‌کند که برش باید افقی باشد (یعنی یک ردیف از تصویر) و تعیین می‌کند کدام ردیف است.
ردیف‌ها از بالا و با شروع از ۰ شماره‌گذاری می‌شوند.
.sp
نمی‌توانید همزمان هر دو گزینه \fB-row\fP و \fB-column\fP را مشخص کنید.

.TP
\fB-column=\fP\fIcolnumber\fP
مشخص می‌کند که برش باید عمودی باشد (یعنی یک ستون از تصویر) و تعیین می‌کند کدام ستون است.
ستون‌ها از سمت چپ و با شروع از ۰ شماره‌گذاری می‌شوند.
.sp
نمی‌توانید همزمان هر دو گزینه \fB-row\fP و \fB-column\fP را مشخص کنید.

.TP
\fB-plane=\fP\fIplanenumber\fP
مشخص می‌کند که شما فقط به یک صفحه از تصویر علاقه‌مند هستید و کدام صفحه مد نظر است.
صفحات از ۰ شماره‌گذاری می‌شوند و بسته به نوع تصویر معانی متفاوتی دارند.
در تصویر PPM، صفحه ۰ قرمز، صفحه ۱ سبز و صفحه ۲ آبی است.
.sp
اگر \fB-plane\fP را مشخص نکنید، تمام صفحات را دریافت می‌کنید؛ هر خط خروجی علاوه بر
شماره ترتیب، شامل چندین عدد خواهد بود. اگر \fB-plane\fP را مشخص کنید، هر خط خروجی علاوه بر
شماره ترتیب، تنها شامل یک عدد خواهد بود.

.TP
\fB-xmgr\fP
این گزینه باعث می‌شود \fBpamslice\fP خروجی را به عنوان ورودی برای
\fBxmgr\fP قالب‌بندی کند تا بتوانید آن را ترسیم نمایید. تنها تفاوتی که این گزینه ایجاد می‌کند
این است که اطلاعات سرآیند را به ابتدای خروجی اضافه می‌کند.

.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamtable" (1)\c
\&
.BR "pamcut" (1)\c
\&
.BR "pamtopnm" (1)\c
\&
.BR "pamchannel" (1)\c
\&
.BR "pnm" (1)\c
\&

.UN history
.SH "تاریخچه (HISTORY)"
.PP
دستور \fBpamslice\fP در Netpbm 10.3 (ژوئن ۲۰۰۲) جایگزین \fBpgmslice\fP شد.
این دستور سازگار با نسخه‌های قبلی بود، اما بر روی تصاویر Netpbm غیر از PGM و
PBM نیز کار می‌کرد و گزینه‌های \fB-plane\fP و \fB-xmgr\fP را اضافه کرد.

.UN author
.SH "نویسنده (AUTHOR)"
.PP
Jos Dingjan <\fIjos@tuatha.org\fP> پس از نیافتن کد منبع برنامه Marco
Beijersbergen با همین نام، \fBpgmslice\fP را نوشت. Bryan Henderson آن را به
\fBpamslice\fP تبدیل کرد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است.
مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamslice.html
.PP