نام (NAME)

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

خلاصه دستور (SYNOPSIS)

pamcat

{-leftright | -lr | -topbottom | -tb}

[-white|-black]

[-jtop|-jbottom|-jcenter] [-jleft|-jright|-jcenter]

[netpbmfile ... | -listfile={filename|-}]

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

توضیحات (DESCRIPTION)

این برنامه بخشی از Netpbm(1) است.

دستور pamcat یک یا چند تصویر Netpbm را به عنوان ورودی خوانده، آن‌ها را به صورت چپ به راست یا بالا به پایین به یکدیگر متصل کرده و یک تصویر Netpbm واحد را در خروجی تولید می‌کند.

گزینه‌های -leftright و -topbottom جهت اتصال و چسباندن تصاویر را تعیین می‌کنند.

تصاویر ورودی نیازی نیست که ابعاد یکسانی داشته باشند: می‌توانید تصاویر با عرض‌های متفاوت را به صورت بالا به پایین و تصاویر با ارتفاع‌های متفاوت را به صورت چپ به راست به هم متصل کنید. همچنین می‌توانید تصاویری با عمق‌های متفاوت (تعداد لایه‌ها) را به یکدیگر پیوند دهید؛ برای نمونه اتصال یک تصویر PBM به یک تصویر PPM و مواردی از این دست.

فرمت تصویر خروجی بالاترین فرمت در میان تصاویر ورودی بر اساس ترتیب PBM، PGM، PPM و PAM خواهد بود.

در خروجی PAM، اگر تمامی تصاویر ورودی نوع تاپل (tuple type) یکسانی داشته باشند (شامل انواع تاپل ضمنی تصاویر PNM)، خروجی نیز با همان نوع تاپل تولید می‌شود. اگر ورودی‌ها متفاوت باشند اما همگی از انواع بصری باشند، نوع تاپل خروجی پایه‌ای‌ترین نوعی خواهد بود که می‌تواند تمام ورودی‌ها را نمایش دهد. برای مثال، اگر ورودی‌ها GRAYSCALE و RGB باشند، خروجی RGB خواهد بود؛ و اگر ورودی‌ها GRAYSCALE_ALPHA و RGB باشند، خروجی RGB_ALPHA خواهد بود. چنانچه ورودی‌ها با هم تفاوت داشته و همگی بصری نباشند، نوع تاپل خروجی یک رشته تهی (null) خواهد بود.

هنگامی که خروجی PAM است، عمق آن برابر با بیشترین عمق در میان تصاویر ورودی (شامل عمق‌های ضمنی تصاویر PNM) خواهد بود، اما دست‌کم به اندازه‌ای است که بتواند نوع تاپل مشخص‌شده در بالا را نمایش دهد. در حالت خروجی PAM غیربصری، تصاویر ورودی با افزودن لایه‌های شماره بالاتر که همگی صفر هستند، تا رسیدن به این عمق خروجی پر (pad) می‌شوند.

در صورتی که تصاویر ورودی عرض‌های متفاوتی داشته باشند و آن‌ها را به صورت بالا به پایین متصل کنید، pamcat خروجی را به پهنای عریض‌ترین تصویر ورودی تولید کرده و تصاویر باریک‌تر را با فضای خالی پر می‌کند. تصاویر را می‌توان درون این کادر پرشده به سمت چپ، راست یا وسط تراز کرد. برای کنترل این رفتار از گزینه‌های -jleft، -jright و -jcenter استفاده کنید.

به طور مشابه، چنانچه تصاویر ورودی ارتفاع‌های متفاوتی داشته باشند و آن‌ها را از چپ به راست متصل کنید، pamcat خروجی را به بلندی بلندترین تصویر ورودی ایجاد کرده و تصاویر کوتاه‌تر را با فضای خالی پر می‌کند. تصاویر را می‌توان درون این محدوده به سمت بالا، پایین یا وسط تراز کرد. برای کنترل این چینش از گزینه‌های -jtop، -jbottom و -jcenter استفاده کنید.

شما می‌توانید رنگ این حاشیه پرکننده (padding) را سیاه یا سفید تعیین کنید یا اجازه دهید pamcat رنگ پس‌زمینه محتمل را تشخیص دهد، که ممکن است برای هر تصویر ورودی رنگ پرکننده متفاوتی انتخاب شود. این مورد با گزینه‌های -black و -white کنترل می‌شود.

در صورتی که تصویر خروجی شامل اطلاعات شفافیت (کانال آلفا) باشد (به این دلیل که حداقل یکی از تصاویر ورودی دارای شفافیت است)، بخش‌های پرکننده به صورت کدر (opaque) خواهند بود. (این رفتار با نتیجه تصویر خروجی بدون اطلاعات شفافیت سازگار است، زیرا چنین تصویری به طور پیش‌فرض کدر تعریف می‌شود).

آرگومان‌ها نام فایل‌های ورودی هستند. هر یک از این‌ها (اما نه بیش از یکی) می‌تواند "-" باشد تا نشان‌دهنده ورودی استاندارد (Standard Input) باشد. اگر هیچ آرگومانی ارائه ندهید (و گزینه -listfile را نیز مشخص نکنید)، به معنای یک تصویر ورودی تکی از ورودی استاندارد است (که بی‌معنی و بی‌فایده است - خروجی دقیقاً همانند ورودی خواهد بود). می‌توانید نام فایل‌ها را به جای آرگومان، درون یک فایل قرار داده و با گزینه -listfile مشخص کنید.

صرف‌نظر از نحوه مشخص کردن فایل‌های ورودی، نمی‌توانید تعداد فایل‌هایی بیش از محدودیت سیستم در باز کردن هم‌زمان فایل‌ها توسط یک فرایند را متصل کنید. معمولاً عدد ۱۶ یک مقدار متداول برای این محدودیت است.

برای کنار هم چیدن شبکه‌ای و منظم تصاویر، می‌توانید از pamundice استفاده کنید.

برای انجام عمل معکوس، می‌توانید از pamdice جهت تقسیم یک تصویر به تصاویر کوچک‌تر هم‌اندازه، یا از pamcut جهت بریدن بخشی از تصویر یا استخراج قسمتی از آن استفاده نمایید.

دستور pnmtile یک تصویر ورودی واحد را بارها و پشت سر هم در کنار خود تکرار و متصل می‌کند.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به ویژه -quiet، بخش گزینه‌های عمومی را ببینید)، pamcat گزینه‌های خط فرمان زیر را می‌شناسد:

همچنین ببینید (SEE ALSO)

pamundice(1), pamdice(1), pnmtile(1), pamcut(1), pnm(1), pam(1)

تاریخچه (HISTORY)

برنامه pamcat در Netpbm 11.00 (سپتامبر ۲۰۲۲) معرفی شد؛ در نسخه‌های قدیمی‌تر، pnmcat بیشتر همین کارها را انجام می‌داد.

نسخه اولیه Netpbm/Pbmplus شامل ابزارهای اتصال تصاویر بود، اما دو ابزار وجود داشت: pbmcatlr برای اتصال چپ به راست تصاویر PBM و pbmcattb برای اتصال بالا به پایین. هنگامی که فرمت‌های PGM و PPM اضافه شدند، این برنامه‌ها با یکدیگر ترکیب و گسترش یافتند تا هر سه فرمت را تحت عنوان pnmcat پشتیبانی کنند. تمام این کارها توسط نویسنده Pbmplus، جف پوزکانزر (Jef Poskanzer) انجام شد.

در Netpbm 10.44 (سپتامبر ۲۰۰۸)، آکیرا اف. اوروشیباتا (Akira F Urushibata) پردازش سریع ویژه‌ای را برای تصاویر خام PBM اضافه کرد که از قابلیت‌های پردازش رشته بیتی در CPU بهره می‌برد.

برنامه pnmcat یکی از ضروری‌ترین برنامه‌ها در Netpbm بود، اما تنها چیزی که نمی‌توانست متصل کند تصاویر PAM دارای شفافیت بود. بنابراین در Netpbm 11.00 (سپتامبر ۲۰۲۲)، برایان هندرسون (Bryan Henderson) برنامه pamcat را برای جایگزینی آن نوشت. این برنامه از کد مسیر سریع تصاویر خام PBM از pnmcat تقریباً کلمه به کلمه مجدداً استفاده کرد.

منبع مستندات (DOCUMENT SOURCE)

این صفحه راهنما توسط ابزار Netpbm با نام 'makeman' از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:

http://netpbm.sourceforge.net/doc/pamcat.html