راهنمای کاربری Pamfile(0) راهنمای کاربری Pamfile(0)

pamfile - نمایش مشخصات ابعاد و ویژگی‌های تصویر در قالب Netpbm

pamfile

[-allimages] [-comments] [-count] [-machine] [-size]

[فایل ...]

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

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

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

به‌طور پیش‌فرض، pamfile فقط سربرگ فایل ورودی را می‌خواند. اگر فایل یک لوله (pipe) باشد، ممکن است برای فرآیندی که داده‌ها را به لوله تزریق می‌کند مشکلاتی ایجاد کند. در این صورت، گزینه -allimages را ببینید.

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

این گزینه باعث می‌شود pamfile تمام تصاویر موجود در هر فایل ورودی را توصیف کند. بدون این گزینه، pamfile فقط اولین تصویر در هر فایل ورودی را توصیف می‌کند.

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

در صورت تعیین گزینه -count، این گزینه هیچ تأثیری ندارد.

توجه داشته باشید که پیش از ژوئیه ۲۰۰۰، یک فایل نمی‌توانست شامل بیش از یک تصویر باشد و بسیاری از برنامه‌ها همه تصاویر به‌جز اولین تصویر را نادیده می‌گیرند.

این گزینه در Netpbm 9.5 (ژوئیه ۲۰۰۰) معرفی شد.

این گزینه باعث می‌شود pamfile برای هر تصویر PAM گزارشی از توضیحات (کامنت‌های) سربرگ تصویر را ارائه دهد.

برای تصاویر PBM، PGM یا PPM، دستور pamfile گزارش می‌دهد که هیچ توضیحی وجود ندارد، حتی اگر وجود داشته باشد.

این گزینه در Netpbm 10.35 (اوت ۲۰۰۶) معرفی شد.

این گزینه باعث می‌شود pamfile تنها تعداد تصاویر موجود در هر فایل ورودی را نمایش دهد.

همانند -allimages، این گزینه باعث می‌شود pamfile تمام تصاویر را بخواند.

می‌توانید حداکثر یکی از گزینه‌های -count، -machine و -size را مشخص کنید.

این گزینه در Netpbm 10.31 (دسامبر ۲۰۰۵) معرفی شد.

این گزینه خروجی را برای پردازش ماشینی مناسب‌تر و برای خواندن انسان کمتر مناسب می‌کند. pamfile همان اطلاعات حالت بدون گزینه را گزارش می‌دهد.

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

  • قالب (Format): مقادیر 'PAM'، 'PBM'، 'PGM' یا 'PPM'
  • زیرقالب (Subformat): مقادیر 'PLAIN' یا 'RAW'
  • عرض (Width): بر حسب پیکسل، در مبنای ده‌دهی
  • ارتفاع (Height): بر حسب پیکسل، در مبنای ده‌دهی
  • عمق (Depth): در مبنای ده‌دهی
  • حداکثر مقدار (Maxval): در مبنای ده‌دهی (اگر تصویر PBM باشد برابر ۱ است)
  • نوع چندتایی (Tuple type): شبیه‌سازی‌شده در صورتی که تصویر PAM نباشد

    می‌توانید حداکثر یکی از گزینه‌های -count، -machine و -size را مشخص کنید.

    این گزینه در Netpbm 10.86 (مارس ۲۰۱۹) معرفی شد.

این گزینه باعث می‌شود خروجی تنها شامل عرض و ارتفاع تصویر باشد، در قالبی که برای پردازش ماشینی مناسب است.

یک خط خروجی به ازای هر تصویر تولید می‌شود که از دو نشانه جداشده با فاصله تشکیل شده است:

  • عرض: بر حسب پیکسل، در مبنای ده‌دهی
  • ارتفاع: بر حسب پیکسل، در مبنای ده‌دهی

    توجه داشته باشید که اگر چندین فایل ورودی با چندین تصویر داشته باشید، راهی برای تشخیص اینکه کدام تصویر در کدام فایل است وجود ندارد. در این صورت، از -machine استفاده کنید.

    می‌توانید حداکثر یکی از گزینه‌های -count، -machine و -size را مشخص کنید.

    این گزینه در Netpbm 10.86 (مارس ۲۰۱۹) معرفی شد.

pam(1), ppmhist(1), file

حق نشر © ۱۹۹۱ توسط Jef Poskanzer.

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

http://netpbm.sourceforge.net/doc/pamfile.html
04 July 2020 مستندات netpbm