.\" 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 "Ppmpat User Manual" 0 "12 November 2023" "netpbm documentation"

.SH "نام (NAME)"

ppmpat \- ایجاد یک تصویر زیبای PPM

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

\fBppmpat\fP
[{\fB-gingham2\fP|\fB-g2\fP} |
{\fB-gingham3\fP|\fB-g3\fP} |
\fB-madras\fP |
\fB-tartan\fP |
\fB-poles\fP |
\fB-squig\fP |
\fB-camo\fP |
\fB-anticamo\fP |
\fB-argyle1\fP |
\fB-argyle2\fP]
[\fB-color\fP \fIcolorlist\fP]
[\fB-mesh\fP]
[\fB-randomseed\fP \fIinteger\fP]

\fIwidth\fP \fIheight\fP
.PP
شما می‌توانید هر گزینه را به کوتاه‌ترین پیشوند یکتای آن خلاصه کنید.

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBppmpat\fP یک تصویر PPM با عرض و ارتفاع مشخص‌شده تولید می‌کند که حاوی یک الگو درون خود است.
.PP
برای مثال، می‌توانید از آن برای ایجاد والپیپر و تصویر پس‌زمینه برای صفحه نمایش رایانه استفاده کنید.
.PP
یکی از کاربردهای این برنامه، ارائه‌ی مثالی از توابع رسم
.BR "drawing" (1)\c
\& در کتابخانه Netpbm است که برنامه از آن‌ها بهره می‌برد.
.PP
برخی از این الگوها دارای تعداد بسیار زیادی رنگ هستند؛ بنابراین اگر الگوی ساده‌تری می‌خواهید، از \fBpnmquant\fP بر روی خروجی استفاده کنید.

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

.UN patspec
.SS "مشخص کردن الگو (Pattern Specification)"
.PP
نوع الگو را با این گزینه‌ها تعیین کنید. باید دقیقاً یک نوع الگو مشخص شود.


.TP
\fB-gingham2\fP \fB-g2\fP
الگوی چهارخانه گینگهام (gingham). قابلیت کاشی‌کاری و چیدمان تکرارشونده دارد.
.sp
اگر \fB-color\fP را مشخص می‌کنید، دو رنگ ارائه دهید: پس‌زمینه و پیش‌زمینه، به همین ترتیب.

.TP
\fB-gingham3\fP \fB-g3\fP
یک الگوی گینگهام کمی پیچیده‌تر. قابلیت کاشی‌کاری دارد.
.sp
اگر \fB-color\fP را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه و دو پیش‌زمینه، به همین ترتیب.

.TP
\fB-madras\fP
الگوی چهارخانه مَدرَس (madras plaid). قابلیت کاشی‌کاری دارد.
.sp
اگر \fB-color\fP را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه و دو پیش‌زمینه، به همین ترتیب.

.TP
\fB-tartan\fP
الگوی پیچازی تارتان (tartan plaid). قابلیت کاشی‌کاری دارد.
.sp
اگر \fB-color\fP را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه و دو پیش‌زمینه، به همین ترتیب.

.TP
\fB-poles\fP
گرادیان‌های رنگی با مرکزیت قطب‌هایی که به‌صورت تصادفی جای‌گذاری شده‌اند: یک نمودار ورونوی (Voronoi).
.sp
(نمونه‌های متعددی از این الگو در طبیعت وجود دارد؛ یک مورد پوست زرافه است).
.sp
اگر \fB-color\fP را مشخص می‌کنید، دو یا چند رنگ تعیین کنید.

.TP
\fB-squig\fP
الگوی لوله‌ای فنری و پیچ در پیچ. قابلیت کاشی‌کاری دارد.
.sp
اگر \fB-color\fP را مشخص می‌کنید، سه یا چند رنگ تعیین کنید. رنگ اول، رنگ پس‌زمینه است.

.TP
\fB-camo\fP
الگوی استتار (کاموفلاژ).
.sp
اگر \fB-color\fP را مشخص می‌کنید، سه یا چند رنگ تعیین کنید. رنگ اول، رنگ پس‌زمینه است؛ رنگ‌های دیگر برای اشکال برگی پیش‌زمینه استفاده می‌شوند. اشکال پیش‌زمینه احتمالاً تقریباً تمام تصویر را اشغال خواهند کرد، به‌طوری که رنگ پس‌زمینه به‌سختی قابل مشاهده خواهد بود.

.TP
\fB-anticamo\fP
الگوی ضد استتار - شبیه به \fB-camo\fP، اما با رنگ‌های فوق‌العاده درخشان.
.sp
اگر \fB-color\fP را مشخص کنید، عملکرد آن مشابه \fB-camo\fP خواهد بود.

.TP
\fB-argyle1\fP
یک الگوی لوزی آرگایل (argyle)، بدون خط مورب از میان لوزی، همراه با یک لوزی. قابلیت کاشی‌کاری دارد.
.sp
اگر \fB-color\fP را مشخص می‌کنید، دو رنگ ارائه دهید: پس‌زمینه و پیش‌زمینه، به همین ترتیب.
.sp
این گزینه از Netpbm 10.78 (مارس ۲۰۱۷) اضافه شد.

.TP
\fB-argyle2\fP
یک الگوی لوزی آرگایل، همراه با خط مورب از میان لوزی، با یک لوزی. قابلیت کاشی‌کاری دارد.
.sp
اگر \fB-color\fP را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه، پیش‌زمینه و خط راه‌راه، به همین ترتیب.
.sp
این گزینه از Netpbm 10.78 (مارس ۲۰۱۷) اضافه شد.



.UN otheropts
.SS "سایر گزینه‌ها (Other Options)"



.TP
\fB-color\fP \fIcolorlist\fP
رنگ‌هایی را که باید در الگو ظاهر شوند، مشخص می‌کند.
.sp
اگر این گزینه را مشخص نکنید، \fBppmpat\fP رنگ‌ها را به‌صورت تصادفی انتخاب می‌کند.
.sp
الگوهای مختلف تعداد رنگ‌های متفاوتی می‌پذیرند. برخی از آن‌ها می‌توانند شامل تعداد متغیری رنگ باشند. اگر تعداد رنگی که مشخص می‌کنید با الگوی انتخابی ناسازگار باشد، \fBppmpat\fP با خطا مواجه شده و به شما اعلام می‌کند که چند رنگ باید تعیین کنید.
.sp
مقدار \fIcolorlist\fP فهرستی از رنگ‌ها است که با کاما از یکدیگر جدا شده‌اند.
.sp
هر رنگ را مطابق توضیحات ارائه‌شده برای
.UR libnetpbm_image.html#colorname
آرگومان روال کتابخانه‌ای \fBpnm_parsecolor()\fP
.UE
\& تعیین کنید.
.sp
مثال: \fB-color red, green, rgbi:1.0/0.5/.25\fP .
.sp
این گزینه از Netpbm 10.78 (مارس ۲۰۱۷) اضافه شد.

.TP
\fB-mesh\fP
این گزینه بر الگوهای تولیدشده توسط \fB-gingham2\fP، \fB-gingham3\fP، \fB-madras\fP و \fB-tartan\fP تأثیر می‌گذارد. هنگامی که این گزینه تعیین \fIنشده\fP باشد، در محل تقاطع دو رنگ، برنامه آن‌ها را با هم ترکیب کرده و میانگین آن‌ها را در ناحیه مستطیلی تقاطع قرار می‌دهد. با تعیین گزینه \fB-mesh\fP، برنامه آن ناحیه را با یک الگوی شطرنجی متشکل از آن دو رنگ پر می‌کند. تصویر حاصل شبیه به یک پارچه بافته‌شده واقعی به نظر می‌رسد که در آن برای هر رنگ، تار و پود مجزایی به کار رفته است.
.sp
این گزینه از Netpbm 10.97 (دسامبر ۲۰۲۱) اضافه شد.

  
.TP
\fB-randomseed\fP \fIinteger\fP
این مقدار دانه‌ی اولیه (seed) برای مولد اعداد تصادفی است که پیکسل‌ها را ایجاد می‌کند.
.sp
از این گزینه برای اطمینان از دریافت تصویری یکسان در دفعات مختلف اجرای دستور استفاده کنید.
.sp
به‌طور پیش‌فرض، \fBppmpat\fP از دانه‌ای استفاده می‌کند که از زمان جاری و شناسه فرایند (PID) مشتق شده است؛ این امر در دفعات مختلف اجرا، نتایجی کاملاً مستقل و نامرتبط با یکدیگر به دست می‌دهد.
.sp
این گزینه از Netpbm 10.61 (دسامبر ۲۰۱۲) اضافه شد.



.UN references
.SH "مراجع (REFERENCES)"

برخی از این الگوها برگرفته از کتاب "Designer's Guide to Color 3" نوشته Jeanne Allen هستند.

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

.UN author
.SH "نویسنده (AUTHOR)"

حق نشر (C) سال ۱۹۸۹ متعلق به Jef Poskanzer است.
.SH "منبع مستندات (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از کد منبع HTML تولید شده است. مستندات اصلی در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/ppmpat.html
.PP