.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ppmrough User Manual" 0 "20 August 2023" "netpbm documentation"

.SH "نام (NAME)"
ppmrough \- ایجاد تصویر PPM از یک مستطیل تک‌رنگ با لبه‌های ناهموار روی پس‌زمینه‌ای با رنگ دیگر

.UN synopsis
.SH "خلاصه دستور (SYNOPSIS)"

\fBppmrough\fP

[\fB-left \fP\fIpixels\fP]

[\fB-right \fP\fIpixels\fP]

[\fB-top \fP\fIpixels\fP]

[\fB-bottom \fP\fIpixels\fP]

[\fB-width \fP\fIpixels\fP]

[\fB-height \fP\fIpixels\fP]

[\fB-bg \fP\fIcolorspec\fP]

[\fB-fg \fP\fIcolorspec\fP]

[\fB-var \fP\fIpixels\fP]

[\fB-randomseed \fP\fIseed\fP]

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

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmrough\fP یک تصویر PPM با عرض و ارتفاع مشخص تولید می‌کند. تصویر شامل مستطیلی با رنگ پیش‌زمینه تعیین‌شده است که توسط حاشیه‌هایی با اندازه و رنگ پس‌زمینه مشخص احاطه شده است؛ با این تفاوت که مرز بین مستطیل پیش‌زمینه و حاشیه‌ها ناهموار و ناصاف است. جلوه ناهمواری به‌صورت تصادفی است.
.PP
دستور \fBppmrough\fP تصویر PPM را در خروجی استاندارد (Standard Output) می‌نویسد.
.PP
مقدار maxval در تصویر خروجی ۲۵۵ است (می‌توانید این مقدار را با \fBpamdepth\fP تغییر دهید).
.PP
به‌ترتیب از گزینه‌های \fB-left\fP یا \fB-right\fP برای ایجاد حاشیه‌های عمودی، و به‌ترتیب از \fB-top\fP یا \fB-bottom\fP برای ایجاد حاشیه‌های افقی درون تصویر استفاده کنید. مقدار هر یک از این گزینه‌ها حداقل عرض حاشیه در آن لبه است. فراتر از این حداقل، عرض در هر نقطه از آن لبه تصادفی بوده و در طول لبه به روشی فرکتال‌گونه تغییر می‌کند.
.PP
از گزینه \fB-var\fP برای کنترل «ناهمواری» حاشیه استفاده کنید. هرچه مقدار آن کمتر باشد، حاشیه صاف‌تر خواهد بود. می‌توانید مولد اعداد شبه‌تصادفی را با گزینه \fB-init\fP مقداردهی اولیه کنید.
.PP
می‌توانید از \fBppmrough\fP همراه با \fBppmtopgm\fP برای ایجاد یک ماسک شفافیت PGM استفاده کرده و با آن لبه‌های تصویری دیگر را ناهموار سازید.

.UN options
.SH "گزینه‌ها (OPTIONS)"
.PP
علاوه بر گزینه‌های مشترک در تمام برنامه‌های مبتنی بر libnetpbm (به‌ویژه \fB-quiet\fP، به
.UR index.html#commonoptions
گزینه‌های مشترک
.UE
\& مراجعه کنید)، \fBppmrough\fP گزینه‌های خط فرمان زیر را می‌شناسد:



.TP
\fB-width=\fP\fIpixels\fP
عرض تصویر را بر حسب پیکسل مشخص می‌کند (پیش‌فرض: 100).

.TP
\fB-height=\fP\fIpixels\fP
ارتفاع تصویر را بر حسب پیکسل مشخص می‌کند (پیش‌فرض: 100).

.TP
\fB-left=\fP\fIpixels\fP
.TP
\fB-right=\fP\fIpixels\fP
.TP
\fB-top=\fP\fIpixels\fP
.TP
\fB-bottom=\fP\fIpixels\fP
این گزینه باعث می‌شود که برنامه به‌ترتیب یک حاشیه چپ، راست، بالا یا پایین ایجاد کند که عرض آن حداقل \fIpixels\fP پیکسل است و فراتر از آن به‌طور تصادفی تغییر می‌کند. می‌توانید هر ترکیبی از این موارد را مشخص کنید.

.TP
\fB-bg=\fP\fIcolorspec\fP
این رنگ پس‌زمینه است، یعنی رنگ حاشیه‌ها. \fIcolorspec\fP همان‌گونه است که برای
.UR libnetpbm_image.html#colorname
آرگومان تابع کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& توصیف شده است. پیش‌فرض black (سیاه) است.

.TP
\fB-fg=\fP\fIcolor\fP
رنگ پیش‌زمینه را مشخص می‌کند، یعنی رنگ مرکز تصویر \- همه چیز به‌جز حاشیه‌ها. \fIcolorspec\fP همان‌گونه است که برای
.UR libnetpbm_image.html#colorname
آرگومان تابع کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& توصیف شده است. پیش‌فرض white (سفید) است.

.TP
\fB-var=\fP\fIpixels\fP
میزان ناهمواری حاشیه‌ها را مشخص می‌کند \- اینکه عرض آن در طول لبه تصویر چقدر و با چه سرعتی تغییر کند. معنای دقیق آن پیچیده است، اما هرچه بزرگ‌تر باشد، تغییرات حاشیه بیشتر خواهد بود. مقدار صفر به این معنی است که اصلاً تغییری نمی‌کند \- لبه پیش‌زمینه کاملاً صاف و مستقیم خواهد بود.
.sp
این مقدار باید یک عدد صحیح غیرمنفی باشد. پیش‌فرض 10 است.

.TP
\fB-randomseed=\fP\fIseed\fP
از این گزینه برای مقداردهی اولیه مولد اعداد شبه‌تصادفی با \fIseed\fP استفاده کنید.
.sp
می‌توانید از این گزینه برای واداشتن برنامه به تولید خروجی تکرارپذیر استفاده کنید.
.sp
قبل از Netpbm 10.61 (دسامبر ۲۰۱۲)، نام این گزینه \fB-init\fP بود و آن گزینه هنوز هم کار می‌کند.

.TP
\fB-verbose\fP
اجرای \fBppmrough\fP در حالت پرگو (verbose). تمام پارامترها را در خطای استاندارد (Standard Error) گزارش می‌دهد.



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.BR "ppmmake" (1)\c
\&,
.BR "pamcat" (1)\c
\&,
.BR "ppmtopgm" (1)\c
\&,
.BR "ppm" (1)\c
\&,

.UN history
.SH "تاریخچه (HISTORY)"
.PP
این برنامه در نگارش 10.9 (سپتامبر ۲۰۰۲) به Netpbm اضافه شد.

.UN author
.SH "نویسندگان (AUTHORS)"

حق نشر (C) ۲۰۰۲ متعلق به Eckard Specht.
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار «makeman» در Netpbm از منبع HTML تولید شده است. مستندات اصلی در آدرس زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmrough.html
.PP