| Pamrestack User Manual(0) | Pamrestack User Manual(0) |
Updated:
نام (NAME)
pamrestack - بازآرایی سطرهای یک تصویر Netpbm
خلاصه دستور (SYNOPSIS)
pamrestack
[-width=width]
[-trim={fill|crop|abort}]
[-verbose]
[pamfile]
کوتاه‌ترین اختصارات یکتای گزینه‌ها پذیرفته می‌شوند. می‌توانید به جای یک خط تیره از دو خط تیره برای مشخص کردن گزینه‌ها استفاده کنید. همچنین می‌توانید به جای علامت مساوی، از نویسهٔ فاصله برای جدا کردن نام گزینه از مقدار آن استفاده نمایید.
توضیحات (DESCRIPTION)
این برنامه بخشی از Netpbm(1) است.
دستور pamrestack پیکسل‌های یک تصویر Netpbm را در سطرهایی با اندازهٔ متفاوت بازآرایی می‌کند. برای نمونه، اگر تصویری ۱۰۰ پیکسل عرض و ۵۰ پیکسل ارتفاع داشته باشد، می‌توانید آن را به عرض ۱۲۵ و ارتفاع ۴۰ بازآرایی کنید. در این حالت، ۲۵ پیکسل از ابتدای سطر دوم ورودی به انتهای سطر اول ورودی منتقل می‌شود، ۵۰ پیکسل از سطر سوم به سطر دوم منتقل می‌گردد، و به همین ترتیب ادامه می‌یابد.
به بیان دیگر، pamrestack تمام سطرهای ورودی را در یک دنبالهٔ طولانی مرتب می‌کند و سطرهای خروجی را بر اساس خروج به ترتیب ورود (FIFO) از آن تولید می‌کند.
اگر فایل ورودی pamfile را مشخص نکنید، ورودی از ورودی استاندارد (Standard Input) خوانده می‌شود.
خروجی به خروجی استاندارد (Standard Output) ارسال می‌شود.
دستور pamrestack روی یک جریان چندتصویری (multi-image stream) کار می‌کند. این برنامه هر تصویر موجود در جریان را به‌طور جداگانه برش می‌دهد و یک جریان چندتصویری در خروجی تولید می‌کند.
گزینه‌ها (OPTIONS)
علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه -quiet؛ ببینید گزینه‌های مشترک )، دستور pamrestack گزینه‌های خط فرمان زیر را می‌شناسد:
- -width=width
- عرض خروجی. اگر این گزینه مشخص نشود، خروجی شامل یک سطر تک خواهد بود که پهنای آن برای در بر گرفتن تمام پیکسل‌های تصویر ورودی کافی است.
- -trim={fill|crop|abort}
- این گزینه مشخص می‌کند هنگامی که عرض جدید نتواند تعداد پیکسل‌های تصویر ورودی را به‌طور دقیق و بدون باقی‌مانده تقسیم کند، چه کاری انجام شود.
- fill
-
(پیش‌فرض) سطر پایانی را در صورت نیاز با افزودن پیکسل‌های سیاه تکمیل می‌کند.
- crop
-
سطر ناقص پایانی را دور می‌ریزد. اگر این کار باعث شود هیچ چیزی برای خروجی نماند، برنامه با شکست پایان می‌یابد.
- abort
-
برنامه را با خطا متوقف می‌کند.
- -verbose
- اطلاعات مربوط به پردازش را در خطای استاندارد (Standard Error) چاپ می‌کند.
نحوه استفاده (USAGE)
دستور pamrestack یک ویرایشگر همه‌منظوره با کاربردهای بالقوه فراوان است.
-
دستور pamrestack می‌تواند تصاویر تک‌بُعدی ایجاد شده توسط برنامه‌هایی مانند ppmhist و pamseq را به مستطیل بازآرایی کند. این کار بررسی خروجی را با یک نمایشگر تصویر آسان‌تر می‌سازد. برعکس، می‌توان از pamrestack برای تبدیل یک تصویر مستطیلی معمولی به یک سطر عریض یا یک ستون بلند استفاده کرد؛ چنانچه این کار برای فشرده‌سازی، تبدیل یا تحلیل مورد نظر باشد. -
دستور pamrestack می‌تواند تصاویری را که به دلیل مقدار عرض نادرست در سرآیند خراب شده‌اند، بازسازی کند. تصاویری که از دستگاه framebuffer دریافت می‌شوند اغلب دچار این مشکل هستند. - دستور pamrestack می‌تواند به همراه pamdice، pamundice، pamcat و غیره برای تقسیم و ترکیب تصاویر در فرآیند درهم‌آمیزی (interlacing) به کار رود.
مثال‌ها (EXAMPLES)
- بازآرایی
خروجی
یک‌بُعدی
pamseq به صورت
یک مربع:
pamseq 3 255 | pamrestack -width=4096 - ترکیب دو
فایل که هر
یک ۶۰۰
پیکسل عرض
دارند، یکی
شامل
سطرهای فرد
و دیگری
شامل
سطرهای
زوج، برای
ساختن یک
تصویر
درهم‌بافته:
pamcat -leftright oddrows.ppm evenrows.ppm | pamrestack -width=600 - مشابه مورد
بالا، اما
با معکوس
کردن افقی
تمام
پیکسل‌ها
در سطرهای
زوج از چپ
به راست
برای تولید
درهم‌بافتگی
مارپیچ (serpentine):
pamflip -leftright evenrows.ppm | pamcat -leftright oddrows.ppm - | pamrestack -width 600
همچنین ببینید (SEE ALSO)
pamseq(1)، ppmhist(1)، pnmshear(1)، pamscale(1)، pamdeinterlace(1)، pamdice(1)، pamundice(1)، pamcat(1)، pam(1)
تاریخچه (HISTORY)
دستور pamrestack در Netpbm 10.99 (ژوئن ۲۰۲۲) معرفی شد.
نویسنده (AUTHOR)
نوشته شده توسط Akira F. Urushibata. توسط نویسنده به مالکیت عمومی (public domain) واگذار شده است.
منبع سند (DOCUMENT SOURCE)
این صفحهٔ راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است. مستندات مرجع در نشانی زیر قرار دارد:
| netpbm documentation |