نام (NAME)

pamenlarge - بزرگ‌نمایی تصویر Netpbm به اندازه N برابر با تکرار پیکسل‌ها

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

pamenlarge [-scale=integer] [-xscale=integer] [-yscale=integer] [filename]

pamenlarge N [pnmfile]

توضیحات (DESCRIPTION)

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

برنامه pamenlarge یک تصویر Netpbm را به عنوان ورودی می‌خواند، پیکسل‌های آن را N بار تکرار می‌کند، و یک تصویر Netpbm در خروجی تولید می‌نماید. خروجی از همان نوع تصویر ورودی است.

اگر اندازه تصویر را ۳ برابر یا بیشتر بزرگ می‌کنید، احتمالاً باید یک مرحله pnmsmooth نیز اضافه کنید؛ در غیر این صورت، پیکسل‌های اصلی در تصویر حاصل به وضوح دیده می‌شوند.

برای تصاویر PBM، pamenlarge از الگوریتم‌های سریع ویژه‌ای برای ضریب‌های مقیاس تا ۱۰ استفاده می‌کند. برای ضریب‌های بزرگ‌تر، از یک الگوریتم ساده اما کند بهره می‌برد. در نتیجه، اغلب می‌توانید با چند بار اجرای pamenlarge به مقیاس‌بندی به مراتب سریع‌تری دست یابید. به عنوان مثال، بزرگ‌نمایی به اندازه ۳ برابر و سپس ۵ برابر، سریع‌تر از یک بار بزرگ‌نمایی به اندازه ۱۵ برابر است. و چون الگوریتم‌ها برای ضریب‌های مختلف مقیاس متفاوت هستند و برخی سریع‌تر از بقیه‌اند، ترتیب اجرا نیز اهمیت دارد. به عنوان مثال، نمونه‌های زیر همگی خروجی یکسانی تولید می‌کنند -- تصویری که طول هر لبه آن ۱۵ برابر بزرگ‌تر از ورودی است -- اما با سرعت‌های متفاوت، که هر کدام سریع‌تر از مورد قبلی است:

     $ pamenlarge -scale=15 test.pbm
     $ pamenlarge -scale=5 test.pbm | pamenlarge -scale=3
     $ pamenlarge -scale=3 test.pbm | pamenlarge -scale=5

حالت‌های سریع ویژه برای ضریب‌های تا ۱۰ از نسخه 10.50 (مارس ۲۰۱۰) وجود داشته‌اند. حالت‌های ویژه برای ۱، ۲، ۳ و ۵ به نسخه 10.41 (دسامبر ۲۰۰۷) برمی‌گردند. پیش از نسخه 10.41، هیچ ضریب مقیاس ویژه‌ای وجود نداشت و بزرگ‌نمایی PBM برای همه ضریب‌ها به طور چشمگیری کندتر از امروز بود.

برنامه pamenlarge تنها می‌تواند با ضریب‌های عدد صحیح بزرگ‌نمایی کند. برنامه کندتر اما عمومی‌تر pamscale می‌تواند با ضریب‌های دلخواه بزرگ‌نمایی یا کوچک‌نمایی نماید. pamscale به شما امکان می‌دهد با بازنمونه‌برداری (resampling) بزرگ‌نمایی کنید که بزرگ‌نمایی‌های هموارتری به دست می‌دهد، اما بسیار کندتر است.

برنامه pamstretch یکی دیگر از برنامه‌های بزرگ‌نمایی است که با ضریب‌های عدد صحیح بزرگ می‌کند. این برنامه نوعی بازنمونه‌برداری ساده انجام می‌دهد که بزرگ‌نمایی هموارشده‌ای با هزینه محاسباتی کمتر ارائه می‌دهد.

برنامه pbmreduce می‌تواند با ضریب‌های صحیح کوچک‌نمایی کند، اما فقط برای تصاویر PBM.

آرگومان‌ها (ARGUMENTS)

همانند اکثر برنامه‌های Netpbm، می‌توانید نام فایل ورودی را به عنوان یک آرگومان ارائه دهید یا آن آرگومان را حذف کنید تا از ورودی استاندارد خوانده شود (و می‌توانید '-' را به عنوان آرگومان مشخص کنید تا صراحتاً ورودی استاندارد تعیین شود).

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

گزینه‌ها (OPTIONS)

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

-scale=integer

-xscale=integer

-yscale=integer

این گزینه‌ها ضریب مقیاس را مشخص می‌کنند. -xscale ضریب مقیاس افقی، -yscale ضریب مقیاس عمودی و -scale هر دو را تعیین می‌کند.

اگر -xscale را مشخص کنید اما -yscale را مشخص نکنید، pamenlarge مقیاس‌بندی عمودی انجام نمی‌دهد (یعنی ضریب مقیاس عمودی برابر با 1 خواهد بود). عکس این حالت نیز زمانی صدق می‌کند که -yscale را مشخص کنید و نه -xscale را.

نمی‌توانید -scale را هم‌زمان با -xscale یا -yscale مشخص کنید.

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

تمام این گزینه‌ها در Netpbm نسخه 10.86 (مارس ۲۰۱۹) جدید بودند. پیش از آن، از آرگومان مقیاس استفاده می‌شد.

تاریخچه (HISTORY)

برنامه pamenlarge در Netpbm نسخه 10.25 (اکتبر ۲۰۰۴) جدید بود. این برنامه به عنوان جایگزینی برای pnmenlarge اثر Jef Poskanzer طراحی شده است که از سال ۱۹۸۹ در Pbmplus وجود داشت. تفاوت عمده این است که pamenlarge علاوه بر PNM می‌تواند تصاویر قالب PAM را نیز بزرگ‌نمایی کند.

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

pbmreduce(1), pamscale(1), pamstretch(1), pbmpscale(1), pnmsmooth(1), pnm(1)

نویسنده (AUTHOR)

حق نشر (C) ۱۹۸۹ توسط Jef Poskanzer.

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

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

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