.\" 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 "Pamcat User Manual" 0 "30 November 2022" "netpbm documentation"

.SH "نام (NAME)"

pamcat \- اتصال و الحاق تصاویر فرمت Netpbm (PAM/PNM) به صورت افقی یا عمودی

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

\fBpamcat\fP

{\fB-leftright\fP | \fB-lr\fP | \fB-topbottom\fP | \fB-tb\fP}

[\fB-white\fP|\fB-black\fP]

[\fB-jtop\fP|\fB-jbottom\fP|\fB-jcenter\fP]
[\fB-jleft\fP|\fB-jright\fP|\fB-jcenter\fP]

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

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

.PP
تصاویر ورودی نیازی نیست که ابعاد یکسانی داشته باشند: می‌توانید تصاویر با عرض‌های متفاوت را به صورت بالا به پایین و تصاویر با ارتفاع‌های متفاوت را به صورت چپ به راست به هم متصل کنید. همچنین می‌توانید تصاویری با عمق‌های متفاوت (تعداد لایه‌ها) را به یکدیگر پیوند دهید؛ برای نمونه اتصال یک تصویر PBM به یک تصویر PPM و مواردی از این دست.
.PP
فرمت تصویر خروجی بالاترین فرمت در میان تصاویر ورودی بر اساس ترتیب PBM، PGM، PPM و PAM خواهد بود.
.PP
در خروجی PAM، اگر تمامی تصاویر ورودی نوع تاپل (tuple type) یکسانی داشته باشند (شامل انواع تاپل ضمنی تصاویر PNM)، خروجی نیز با همان نوع تاپل تولید می‌شود. اگر ورودی‌ها متفاوت باشند اما همگی از انواع بصری باشند، نوع تاپل خروجی پایه‌ای‌ترین نوعی خواهد بود که می‌تواند تمام ورودی‌ها را نمایش دهد. برای مثال، اگر ورودی‌ها GRAYSCALE و RGB باشند، خروجی RGB خواهد بود؛ و اگر ورودی‌ها GRAYSCALE_ALPHA و RGB باشند، خروجی RGB_ALPHA خواهد بود. چنانچه ورودی‌ها با هم تفاوت داشته و همگی بصری نباشند، نوع تاپل خروجی یک رشته تهی (null) خواهد بود.
.PP
هنگامی که خروجی PAM است، عمق آن برابر با بیشترین عمق در میان تصاویر ورودی (شامل عمق‌های ضمنی تصاویر PNM) خواهد بود، اما دست‌کم به اندازه‌ای است که بتواند نوع تاپل مشخص‌شده در بالا را نمایش دهد. در حالت خروجی PAM غیربصری، تصاویر ورودی با افزودن لایه‌های شماره بالاتر که همگی صفر هستند، تا رسیدن به این عمق خروجی پر (pad) می‌شوند.
.PP
در صورتی که تصاویر ورودی عرض‌های متفاوتی داشته باشند و آن‌ها را به صورت بالا به پایین متصل کنید،
\fBpamcat\fP
خروجی را به پهنای عریض‌ترین تصویر ورودی تولید کرده و تصاویر باریک‌تر را با فضای خالی پر می‌کند. تصاویر را می‌توان درون این کادر پرشده به سمت چپ، راست یا وسط تراز کرد. برای کنترل این رفتار از گزینه‌های
\fB-jleft\fP،
\fB-jright\fP
و
\fB-jcenter\fP
استفاده کنید.
.PP
به طور مشابه، چنانچه تصاویر ورودی ارتفاع‌های متفاوتی داشته باشند و آن‌ها را از چپ به راست متصل کنید،
\fBpamcat\fP
خروجی را به بلندی بلندترین تصویر ورودی ایجاد کرده و تصاویر کوتاه‌تر را با فضای خالی پر می‌کند. تصاویر را می‌توان درون این محدوده به سمت بالا، پایین یا وسط تراز کرد. برای کنترل این چینش از گزینه‌های
\fB-jtop\fP،
\fB-jbottom\fP
و
\fB-jcenter\fP
استفاده کنید.
.PP
شما می‌توانید رنگ این حاشیه پرکننده (padding) را سیاه یا سفید تعیین کنید یا اجازه دهید
\fBpamcat\fP
رنگ پس‌زمینه محتمل را تشخیص دهد، که ممکن است برای هر تصویر ورودی رنگ پرکننده متفاوتی انتخاب شود. این مورد با گزینه‌های
\fB-black\fP
و
\fB-white\fP
کنترل می‌شود.
.PP
در صورتی که تصویر خروجی شامل اطلاعات شفافیت (کانال آلفا) باشد (به این دلیل که حداقل یکی از تصاویر ورودی دارای شفافیت است)، بخش‌های پرکننده به صورت کدر (opaque) خواهند بود. (این رفتار با نتیجه تصویر خروجی بدون اطلاعات شفافیت سازگار است، زیرا چنین تصویری به طور پیش‌فرض کدر تعریف می‌شود).

.PP
آرگومان‌ها نام فایل‌های ورودی هستند. هر یک از این‌ها (اما نه بیش از یکی) می‌تواند "-" باشد تا نشان‌دهنده ورودی استاندارد (Standard Input) باشد. اگر هیچ آرگومانی ارائه ندهید (و گزینه
\fB-listfile\fP
را نیز مشخص نکنید)، به معنای یک تصویر ورودی تکی از ورودی استاندارد است (که بی‌معنی و بی‌فایده است - خروجی دقیقاً همانند ورودی خواهد بود). می‌توانید نام فایل‌ها را به جای آرگومان، درون یک فایل قرار داده و با گزینه
\fB-listfile\fP
مشخص کنید.
.PP
صرف‌نظر از نحوه مشخص کردن فایل‌های ورودی، نمی‌توانید تعداد فایل‌هایی بیش از محدودیت سیستم در باز کردن هم‌زمان فایل‌ها توسط یک فرایند را متصل کنید. معمولاً عدد ۱۶ یک مقدار متداول برای این محدودیت است.
.PP
برای کنار هم چیدن شبکه‌ای و منظم تصاویر، می‌توانید از
\fBpamundice\fP
استفاده کنید.
.PP
برای انجام عمل معکوس، می‌توانید از
\fBpamdice\fP
جهت تقسیم یک تصویر به تصاویر کوچک‌تر هم‌اندازه، یا از
\fBpamcut\fP
جهت بریدن بخشی از تصویر یا استخراج قسمتی از آن استفاده نمایید.
.PP
دستور
\fBpnmtile\fP
یک تصویر ورودی واحد را بارها و پشت سر هم در کنار خود تکرار و متصل می‌کند.


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

.UN direction
.SS "جهت (Direction)"


.TP
\fB-topbottom\fP, \fB-tb\fP
ترکیب تصاویر به صورت عمودی، از بالا به پایین.

.TP
\fB-leftright\fP, \fB-lr\fP
ترکیب تصاویر به صورت افقی، از چپ به راست.
.sp
شما باید جهت را با مشخص کردن یکی از گزینه‌های بالا تعیین کنید. نمی‌توانید هر دو را مشخص نمایید.



.UN justification
.SS "تراز (Justification)"


.TP
\fB-jleft\fP

چپ‌چین کردن تصاویر در اتصال بالا به پایین.
.sp
نمی‌توانید این گزینه را همراه با
\fB-jright\fP
مشخص کنید.
.sp
این گزینه در اتصال چپ به راست نامعتبر است.

.TP
\fB-jright\fP

راست‌چین کردن تصاویر در اتصال بالا به پایین.
.sp
نمی‌توانید این گزینه را همراه با
\fB-jleft\fP
مشخص کنید.
.sp
این گزینه در اتصال چپ به راست نامعتبر است.

.TP
\fB-jtop\fP

بالاچین کردن تصاویر در اتصال چپ به راست.
.sp
نمی‌توانید این گزینه را همراه با
\fB-jbottom\fP
مشخص کنید.
.sp
این گزینه در اتصال بالا به پایین نامعتبر است.

.TP
\fB-jbottom\fP

پایین‌چین کردن تصاویر در اتصال چپ به راست.
.sp
نمی‌توانید این گزینه را همراه با
\fB-jtop\fP
مشخص کنید.
.sp
این گزینه در اتصال بالا به پایین نامعتبر است.

.TP
\fB-jcenter\fP

وسط‌چین کردن تصاویر (معتبر برای هر دو حالت اتصال چپ به راست و بالا به پایین).
این حالت پیش‌فرض است.


.PP
به طور پیش‌فرض،
\fBpamcat\fP
تصاویر کوچک‌تر را در مرکز تراز می‌کند. از
\fB-jleft\fP
و
\fB-jbottom\fP
برای بازنویسی این رفتار استفاده کنید. ترکیب
\fB-topbottom -jleft\fP
تصاویر را روی یکدیگر چیده و لبه چپ آن‌ها را تراز می‌کند. ترکیب
\fB-leftright -jbottom\fP
تصاویر را از چپ به راست چیده و لبه‌های پایینی آن‌ها را طوری هم‌تراز می‌کند که گویی روی یک میز قرار گرفته‌اند.


.UN paddingcolor
.SS "رنگ حاشیه پرکننده (Padding Color)"
این گزینه‌ها مشخص می‌کنند که چه رنگی برای پر کردن فضای اضافی هنگام انجام تراز استفاده شود. اگر هیچ‌کدام مشخص نشود،
\fBpamcat\fP
رنگی را که برای تصاویر مناسب‌تر به نظر می‌رسد انتخاب می‌کند و این رنگ ممکن است برای هر تصویر متفاوت باشد.

.TP
\fB-white\fP
تمامی حاشیه‌های پرکننده را سفید می‌کند.
.sp
نمی‌توانید این گزینه را همراه با
\fB-black\fP
مشخص کنید.
.TP
\fB-black\fP
تمامی حاشیه‌های پرکننده را سیاه می‌کند.
.sp
نمی‌توانید این گزینه را همراه با
\fB-white\fP
مشخص کنید.



.UN miscellaneousopt
.SS "متفرقه (Miscellaneous)"


.TP
\fB-listfile=\fP{\fIfilename\fP|\fB-\fP}
این گزینه نام فایلی را مشخص می‌کند که شامل فهرست فایل‌های ورودی است. مقدار
\fB-\fP
به این معناست که فهرست از ورودی استاندارد خوانده می‌شود.
.sp
فایل شامل یک نام فایل در هر خط (جدا شده با خط جدید) با هر انکودینگی است که سرویس
\fBfopen\fP
سیستم انتظار دارد. می‌توانید خط جدید را در آخرین خط نادیده بگیرید (حذف کنید). خطوط خالی نادیده گرفته می‌شوند. هیچ سازوکاری برای درج توضیحات (کامنت) در فهرست وجود ندارد (بنابراین اگر می‌خواهید فهرستی حاوی توضیحات داشته باشید، پیش از ارسال آن به
\fBpamcat\fP
آن را پیش‌پردازش کرده و توضیحات را حذف کنید).
.sp
نمی‌توانید نام فایل‌ها را به عنوان آرگومان خط فرمان همراه با
\fB-listfile\fP
مشخص کنید.
.sp
شما مجاز نیستید فایل‌های بیشتری نسبت به محدودیت سیستم در تعداد فایل‌های باز هم‌زمان توسط یک فرایند فهرست کنید. عدد ۱۶ یک مقدار متداول برای آن است.
.sp
این گزینه در Netpbm 11.01 (دسامبر ۲۰۲۲) اضافه شده است.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "pamundice" (1)\c
\&,
.BR "pamdice" (1)\c
\&,
.BR "pnmtile" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "pnm" (1)\c
\&,
.BR "pam" (1)\c
\&


.UN history
.SH "تاریخچه (HISTORY)"
.PP
برنامه
\fBpamcat\fP
در Netpbm 11.00 (سپتامبر ۲۰۲۲) معرفی شد؛ در نسخه‌های قدیمی‌تر،
\fBpnmcat\fP
بیشتر همین کارها را انجام می‌داد.
.PP
نسخه اولیه Netpbm/Pbmplus شامل ابزارهای اتصال تصاویر بود، اما دو ابزار وجود داشت:
\fBpbmcatlr\fP
برای اتصال چپ به راست تصاویر PBM و
\fBpbmcattb\fP
برای اتصال بالا به پایین. هنگامی که فرمت‌های PGM و PPM اضافه شدند، این برنامه‌ها با یکدیگر ترکیب و گسترش یافتند تا هر سه فرمت را تحت عنوان
\fBpnmcat\fP
پشتیبانی کنند. تمام این کارها توسط نویسنده Pbmplus، جف پوزکانزر (Jef Poskanzer) انجام شد.
.PP
در Netpbm 10.44 (سپتامبر ۲۰۰۸)، آکیرا اف. اوروشیباتا (Akira F Urushibata) پردازش سریع ویژه‌ای را برای تصاویر خام PBM اضافه کرد که از قابلیت‌های پردازش رشته بیتی در CPU بهره می‌برد.
.PP
برنامه
\fBpnmcat\fP
یکی از ضروری‌ترین برنامه‌ها در Netpbm بود، اما تنها چیزی که نمی‌توانست متصل کند تصاویر PAM دارای شفافیت بود. بنابراین در Netpbm 11.00 (سپتامبر ۲۰۲۲)، برایان هندرسون (Bryan Henderson) برنامه
\fBpamcat\fP
را برای جایگزینی آن نوشت. این برنامه از کد مسیر سریع تصاویر خام PBM از
\fBpnmcat\fP
تقریباً کلمه به کلمه مجدداً استفاده کرد.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamcat.html
.PP