نام (NAME)

pamtopnm - تبدیل تصویر با فرمت PAM به فرمت‌های معادل PNM (PBM، PGM یا PPM)

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

pamtopnm

[-assume]

[pnmfile]

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

توضیحات (DESCRIPTION)

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

برنامه pamtopnm یک تصویر با فرمت PAM را به عنوان ورودی می‌خواند و تصویر معادل مناسب‌تر را با فرمت PBM، PGM یا PPM (یعنی PNM) به عنوان خروجی تولید می‌کند.

برنامه pamtopnm فرض می‌کند که تصویر PAM داده‌های لازم برای یک تصویر PBM، PGM یا PPM را دارد اگر مقدار tuple type آن برابر با "BLACKANDWHITE"، "GRAYSCALE" یا "RGB" بوده و عمق (depth) و مقدار بیشینه (maxval) آن مناسب باشد. در غیر این صورت، اجرای pamtopnm با خطا مواجه می‌شود.

با این حال، می‌توانید الزام بررسی نوع چندتایی (tuple type) را با استفاده از گزینه -assume نادیده بگیرید.

برنامه pamtopnm در صورتی که عمق PAM ورودی ۳ یا ۴ باشد یک تصویر PPM تولید می‌کند؛ اگر عمق تصویر ۱ یا ۲ باشد تصویر خروجی PGM یا PBM خواهد بود. انتخاب میان PGM یا PBM به مقدار maxval بستگی دارد: برای مقدار ۱ خروجی PBM و برای مقادیر بالاتر PGM خواهد بود. نوع چندتایی (tuple type) نقشی در تعیین نوع خروجی ندارد. می‌توانید از برنامه‌های Netpbm مانند pgmtopgm برای تولید خروجی PNM متفاوت استفاده کنید، اما به یاد داشته باشید برنامه‌ای از Netpbm که ورودی PGM می‌پذیرد ورودی PBM را نیز پردازش خواهد کرد.

توجه داشته باشید که ممکن است تصویری که رسماً رنگی است در عمل فقط شامل طیف‌های خاکستری باشد، یا تصویری که رسماً خاکستری است فقط شامل سیاه و سفید باشد. این برنامه به این موضوع توجهی نمی‌کند؛ یک تصویر ورودی RGB خروجی PPM تولید خواهد کرد حتی اگر تمام پیکسل‌های آن خاکستری باشند. اما می‌توانید از ppmtopgm برای تبدیل تصویری از نوع PPM که می‌دانید خاکستری است به PGM معادل استفاده کنید، و می‌توانید از pamthreshold برای تبدیل تصویر PGM که می‌دانید سیاه و سفید است به تصویر PAM سیاه و سفید استفاده نمایید و سپس از pamtopnm برای تبدیل آن به PBM بهره ببرید.

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

گزینه‌ها (OPTIONS)

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

-assume

هنگامی که گزینه -assume را مشخص می‌کنید، به pamtopnm می‌گویید که شخصاً صحت این موضوع را تضمین می‌کنید که چندتایی‌ها (tuples) حاوی همان داده‌هایی هستند که به کانال‌های یک فایل PBM، PGM یا PPM تعلق دارند، صرف‌نظر از این‌که مقدار tuple type چه باشد. با این حال عمق تصویر همچنان باید مطابقت داشته باشد، بنابراین برای اجبار واقعی به تبدیل، ممکن است لازم باشد ابتدا ورودی را از طریق pamchannel پردازش کنید. اما در استفاده از -assume احتیاط کنید؛ فرض نابجا ممکن است به نتایج نادرست منجر شود.

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

pbmtopgm(1)، pamditherbw(1)، pgmtoppm(1)، ppmtopgm(1)، pamthreshold(1)، pam(1)، pnm(1)، pbm(1)، pgm(1)، ppm(1)

تاریخچه (HISTORY)

برنامه pamtopnm به همراه فرمت PAM در نسخه 9.7 از Netpbm (اوت ۲۰۰۰) معرفی شد.

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

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

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