\
.\" 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 "Pamstack User Manual" 0 "18 May 2023" "netpbm documentation"

.SH "نام (NAME)"
pamstack \- روی هم چیدن صفحه‌های چند تصویر PAM در یک تصویر PAM

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

\fBpamstack\fP
[\fB-tupletype \fP\fItupletype\fP]
[\fB-firstmaxval\fP,\fB-lcmmaxval\fP]
[\fIinputfilespec\fP ...]
.PP
همه گزینه‌ها را می‌توان به کوتاه‌ترین پیشوند یکتای آن‌ها مخفف کرد. می‌توانید به جای یک خط تیره از دو خط تیره استفاده کنید. همچنین می‌توانید یک گزینه را با فاصله به جای \fB=\fP از مقدارش جدا کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
برنامه \fBpamstack\fP چند تصویر PAM یا PNM را به عنوان ورودی می‌خواند و یک تصویر PAM را به عنوان خروجی تولید می‌کند که شامل تمام صفحه‌ها (کانال‌های) ورودی‌ها است که به ترتیبِ مشخص‌شده روی هم چیده شده‌اند.
.PP
همچنین می‌تواند صرفاً نوع تاپل (tuple type) یک تصویر PAM منفرد را تغییر دهد.
  
.PP
برای هر یک (و نه بیش از یکی) از فایل‌های ورودی، می‌توانید "-" را به معنای ورودی استاندارد مشخص کنید. اگر هیچ آرگومانی مشخص نکنید، ورودی یک فایل خواهد بود: ورودی استاندارد.
.PP
ابعاد خروجی همانند ورودی‌ها است، با این تفاوت که عمق (depth) برابر با مجموع عمق‌های ورودی‌ها خواهد بود. اگر تمام ورودی‌ها یکسان باشند، مقدار maxval نیز همانند ورودی‌ها خواهد بود، و در غیر این صورت توسط \fB-firstmaxval\fP و \fB-lcmmaxval\fP کنترل می‌شود. نوع تاپل یک رشته تهی است مگر اینکه گزینه \fB-tupletype\fP را مشخص کنید.
  
.PP
اگر ورودی‌ها همگی عرض و ارتفاع یکسانی نداشته باشند، \fBpamstack\fP با شکست مواجه می‌شود. همچنین اگر همه آن‌ها maxval یکسانی نداشته باشند، با شکست مواجه می‌شود، مگر اینکه \fB-firstmaxval\fP یا \fB-lcmmaxval\fP را مشخص کنید.
.PP
برنامه \fBpamstack\fP با جریان‌های چندتصویری (multi-image streams) کار می‌کند. این برنامه اولین تصویر در تمام جریان‌ها را در یک تصویر خروجی (اولین تصویر در جریان خروجی) روی هم می‌چیند، سپس دومین تصویر در تمام جریان‌ها را در دومین تصویر در جریان خروجی روی هم می‌چیند، و به همین ترتیب ادامه می‌دهد تا زمانی که یکی از جریان‌ها به پایان برسد. این فرآیند شبیه به یک عمل ماتریسی است.
.PP
پیش از Netpbm نسخه 10.32 (فوریه ۲۰۰۶)، \fBpamstack\fP تمام تصاویر به‌جز اولین تصویر در هر جریان ورودی را نادیده می‌گرفت.
.PP
دستور \fBpamchannel\fP عکسِ کارِ \fBpamstack\fP را انجام می‌دهد: این دستور صفحه‌های مجزا را از یک PAM منفرد استخراج می‌کند.
.PP
از
.BR "pamtopnm" (1)\c
\& برای تبدیل یک تصویر PAM مناسب به یک تصویر سنتی‌تر PNM (شامل PBM، PGM، یا PPM) استفاده کنید. (البته نیازی به انجام این کار نیست اگر می‌خواهید آن را به یک برنامه مدرن Netpbm بدهید -- همه آن‌ها ورودی PAM مناسب را مستقیماً می‌پذیرند).
.PP
یک مثال از استفاده از \fBpamstack\fP این است که برخی از برنامه‌های Netpbm یک PAM را به عنوان ورودی می‌پذیرند که تصویر گرافیکی را با اطلاعات شفافیت (transparency) نشان می‌دهد. به عنوان مثال در یک تصویر رنگی، این یک PAM با نوع تاپل "RGB_ALPHA" خواهد بود. در Netpbm، چنین تصاویری به طور سنتی در قالب دو تصویر نمایش داده می‌شدند - یک PPM برای رنگ و یک PGM برای شفافیت. برای تبدیل یک جفت PPM/PGM به ورودی PAM(RGB_ALPHA) که برنامه‌های جدیدتر به آن نیاز دارند، کاری شبیه به این انجام دهید:

.nf
\f(CW
$ pamstack -tupletype=RGB_ALPHA myimage.ppm myalpha.pgm | \e
      pamtouil >myimage.uil
\fP
.fi

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



.TP
\fB-tupletype \fP\fItupletype\fP
این گزینه نام نوع تاپل (tuple type name) را که باید در خروجی ثبت شود مشخص می‌کند. می‌توانید از هر رشته‌ای تا ۲۵۵ نویسه استفاده کنید. برخی برنامه‌ها نام‌های خاصی را می‌شناسند. اگر این گزینه را نادیده بگیرید، نام پیش‌فرض نوع تاپل تهی (null) خواهد بود.

.TP
\fB-firstmaxval\fP
این گزینه مشخص می‌کند که maxval خروجی برابر با maxval اولین تصویر ورودی قرار گیرد؛ برنامه در صورت لزوم مقادیر نمونه‌های (sample values) سایر تصاویر را مقیاس‌بندی می‌کند.
.sp
به‌طور پیش‌فرض، \fBpamstack\fP نیازمند آن است که همه تصاویر ورودی maxval یکسانی داشته باشند. اگر این‌گونه نباشد، برنامه با شکست مواجه می‌شود.
.sp
نمی‌توانید این گزینه را همراه با \fB-lcmmaxval\fP مشخص کنید.
.sp
این گزینه در Netpbm نسخه 11.03 (ژوئن ۲۰۲۳) اضافه شده است.
  
.TP
\fB-lcmmaxval\fP
این گزینه مشخص می‌کند که maxval خروجی برابر با کوچک‌ترین مضرب مشترک (ک.م.م / LCM) مقادیر maxval تصاویر ورودی باشد، که در صورت فراتر رفتن LCM از ۶۵۵۳۵، به ۶۵۵۳۵ محدود می‌شود؛ برنامه در صورت لزوم مقادیر نمونه‌های سایر تصاویر را مقیاس‌بندی می‌کند.
.sp
به‌طور پیش‌فرض، \fBpamstack\fP نیازمند آن است که همه تصاویر ورودی maxval یکسانی داشته باشند. اگر این‌گونه نباشد، برنامه با شکست مواجه می‌شود.
.sp
نمی‌توانید این گزینه را همراه با \fB-firstmaxval\fP مشخص کنید.
.sp
این گزینه در Netpbm نسخه 11.03 (ژوئن ۲۰۲۳) اضافه شده است.



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

.UN history
.SH "تاریخچه (HISTORY)"
.PP
\fBpamstack\fP در Netpbm نسخه 10.0 (ژوئن ۲۰۰۲) معرفی شد.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm به نام 'makeman' از منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamstack.html
.PP