نام (NAME)

ppmrough - ایجاد تصویر PPM از یک مستطیل تک‌رنگ با لبه‌های ناهموار روی پس‌زمینه‌ای با رنگ دیگر

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

ppmrough

[-left pixels]

[-right pixels]

[-top pixels]

[-bottom pixels]

[-width pixels]

[-height pixels]

[-bg colorspec]

[-fg colorspec]

[-var pixels]

[-randomseed seed]

[-verbose]

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

توضیحات (DESCRIPTION)

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

دستور ppmrough یک تصویر PPM با عرض و ارتفاع مشخص تولید می‌کند. تصویر شامل مستطیلی با رنگ پیش‌زمینه تعیین‌شده است که توسط حاشیه‌هایی با اندازه و رنگ پس‌زمینه مشخص احاطه شده است؛ با این تفاوت که مرز بین مستطیل پیش‌زمینه و حاشیه‌ها ناهموار و ناصاف است. جلوه ناهمواری به‌صورت تصادفی است.

دستور ppmrough تصویر PPM را در خروجی استاندارد (Standard Output) می‌نویسد.

مقدار maxval در تصویر خروجی ۲۵۵ است (می‌توانید این مقدار را با pamdepth تغییر دهید).

به‌ترتیب از گزینه‌های -left یا -right برای ایجاد حاشیه‌های عمودی، و به‌ترتیب از -top یا -bottom برای ایجاد حاشیه‌های افقی درون تصویر استفاده کنید. مقدار هر یک از این گزینه‌ها حداقل عرض حاشیه در آن لبه است. فراتر از این حداقل، عرض در هر نقطه از آن لبه تصادفی بوده و در طول لبه به روشی فرکتال‌گونه تغییر می‌کند.

از گزینه -var برای کنترل «ناهمواری» حاشیه استفاده کنید. هرچه مقدار آن کمتر باشد، حاشیه صاف‌تر خواهد بود. می‌توانید مولد اعداد شبه‌تصادفی را با گزینه -init مقداردهی اولیه کنید.

می‌توانید از ppmrough همراه با ppmtopgm برای ایجاد یک ماسک شفافیت PGM استفاده کرده و با آن لبه‌های تصویری دیگر را ناهموار سازید.

گزینه‌ها (OPTIONS)

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

-width=pixels

عرض تصویر را بر حسب پیکسل مشخص می‌کند (پیش‌فرض: 100).

-height=pixels

ارتفاع تصویر را بر حسب پیکسل مشخص می‌کند (پیش‌فرض: 100).

-left=pixels

-right=pixels

-top=pixels

-bottom=pixels

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

-bg=colorspec

این رنگ پس‌زمینه است، یعنی رنگ حاشیه‌ها. colorspec همان‌گونه است که برای آرگومان تابع کتابخانه‌ای pnm_parsecolor() توصیف شده است. پیش‌فرض black (سیاه) است.

-fg=color

رنگ پیش‌زمینه را مشخص می‌کند، یعنی رنگ مرکز تصویر - همه چیز به‌جز حاشیه‌ها. colorspec همان‌گونه است که برای آرگومان تابع کتابخانه‌ای pnm_parsecolor() توصیف شده است. پیش‌فرض white (سفید) است.

-var=pixels

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

این مقدار باید یک عدد صحیح غیرمنفی باشد. پیش‌فرض 10 است.

-randomseed=seed

از این گزینه برای مقداردهی اولیه مولد اعداد شبه‌تصادفی با seed استفاده کنید.

می‌توانید از این گزینه برای واداشتن برنامه به تولید خروجی تکرارپذیر استفاده کنید.

قبل از Netpbm 10.61 (دسامبر ۲۰۱۲)، نام این گزینه -init بود و آن گزینه هنوز هم کار می‌کند.

-verbose

اجرای ppmrough در حالت پرگو (verbose). تمام پارامترها را در خطای استاندارد (Standard Error) گزارش می‌دهد.

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

ppmmake(1), pamcat(1), ppmtopgm(1), ppm(1),

تاریخچه (HISTORY)

این برنامه در نگارش 10.9 (سپتامبر ۲۰۰۲) به Netpbm اضافه شد.

نویسندگان (AUTHORS)

حق نشر (C) ۲۰۰۲ متعلق به Eckard Specht.

منبع سند (DOCUMENT SOURCE)

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

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