Ppmpat User Manual(0)                                    Ppmpat User Manual(0)



نام (NAME)
       ppmpat - ایجاد یک تصویر زیبای PPM


خلاصه دستور (SYNOPSIS)
       ppmpat [{-gingham2|-g2} | {-gingham3|-g3} | -madras | -tartan | -poles
       | -squig | -camo | -anticamo | -argyle1 | -argyle2] [-color colorlist]
       [-mesh] [-randomseed integer]

       width height

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


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

       دستور ppmpat یک تصویر PPM با عرض و ارتفاع مشخص‌شده تولید می‌کند که حاوی
       یک الگو درون خود است.

       برای مثال، می‌توانید از آن برای ایجاد والپیپر و تصویر پس‌زمینه برای صفحه
       نمایش رایانه استفاده کنید.

       یکی از کاربردهای این برنامه، ارائه‌ی مثالی از توابع رسم drawing(1) در
       کتابخانه Netpbm است که برنامه از آن‌ها بهره می‌برد.

       برخی از این الگوها دارای تعداد بسیار زیادی رنگ هستند؛ بنابراین اگر
       الگوی ساده‌تری می‌خواهید، از pnmquant بر روی خروجی استفاده کنید.


گزینه‌ها (OPTIONS)
       علاوه بر گزینه‌های مشترک بین تمامی برنامه‌های مبتنی بر libnetpbm (به‌ویژه
       -quiet، به گزینه‌های رایج (Common Options) <index.html#commonoptions>
       مراجعه کنید)، دستور ppmpat گزینه‌های خط فرمان زیر را می‌شناسد:


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



       -gingham2 -g2
              الگوی چهارخانه گینگهام (gingham). قابلیت کاشی‌کاری و چیدمان
              تکرارشونده دارد.

              اگر -color را مشخص می‌کنید، دو رنگ ارائه دهید: پس‌زمینه و
              پیش‌زمینه، به همین ترتیب.


       -gingham3 -g3
              یک الگوی گینگهام کمی پیچیده‌تر. قابلیت کاشی‌کاری دارد.

              اگر -color را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه و دو
              پیش‌زمینه، به همین ترتیب.


       -madras
              الگوی چهارخانه مَدرَس (madras plaid). قابلیت کاشی‌کاری دارد.

              اگر -color را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه و دو
              پیش‌زمینه، به همین ترتیب.


       -tartan
              الگوی پیچازی تارتان (tartan plaid). قابلیت کاشی‌کاری دارد.

              اگر -color را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه و دو
              پیش‌زمینه، به همین ترتیب.


       -poles گرادیان‌های رنگی با مرکزیت قطب‌هایی که به‌صورت تصادفی جای‌گذاری
              شده‌اند: یک نمودار ورونوی (Voronoi).

              (نمونه‌های متعددی از این الگو در طبیعت وجود دارد؛ یک مورد پوست
              زرافه است).

              اگر -color را مشخص می‌کنید، دو یا چند رنگ تعیین کنید.


       -squig الگوی لوله‌ای فنری و پیچ در پیچ. قابلیت کاشی‌کاری دارد.

              اگر -color را مشخص می‌کنید، سه یا چند رنگ تعیین کنید. رنگ اول،
              رنگ پس‌زمینه است.


       -camo  الگوی استتار (کاموفلاژ).

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


       -anticamo
              الگوی ضد استتار - شبیه به -camo، اما با رنگ‌های فوق‌العاده درخشان.

              اگر -color را مشخص کنید، عملکرد آن مشابه -camo خواهد بود.


       -argyle1
              یک الگوی لوزی آرگایل (argyle)، بدون خط مورب از میان لوزی، همراه
              با یک لوزی. قابلیت کاشی‌کاری دارد.

              اگر -color را مشخص می‌کنید، دو رنگ ارائه دهید: پس‌زمینه و
              پیش‌زمینه، به همین ترتیب.

              این گزینه از Netpbm 10.78 (مارس ۲۰۱۷) اضافه شد.


       -argyle2
              یک الگوی لوزی آرگایل، همراه با خط مورب از میان لوزی، با یک لوزی.
              قابلیت کاشی‌کاری دارد.

              اگر -color را مشخص می‌کنید، سه رنگ ارائه دهید: پس‌زمینه، پیش‌زمینه
              و خط راه‌راه، به همین ترتیب.

              این گزینه از Netpbm 10.78 (مارس ۲۰۱۷) اضافه شد.




   سایر گزینه‌ها (Other Options)
       -color colorlist
              رنگ‌هایی را که باید در الگو ظاهر شوند، مشخص می‌کند.

              اگر این گزینه را مشخص نکنید، ppmpat رنگ‌ها را به‌صورت تصادفی
              انتخاب می‌کند.

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

              مقدار colorlist فهرستی از رنگ‌ها است که با کاما از یکدیگر جدا
              شده‌اند.

              هر رنگ را مطابق توضیحات ارائه‌شده برای آرگومان روال کتابخانه‌ای
              pnm_parsecolor() <libnetpbm_image.html#colorname>  تعیین کنید.

              مثال: -color red, green, rgbi:1.0/0.5/.25 .

              این گزینه از Netpbm 10.78 (مارس ۲۰۱۷) اضافه شد.


       -mesh  این گزینه بر الگوهای تولیدشده توسط -gingham2، -gingham3، -madras
              و -tartan تأثیر می‌گذارد. هنگامی که این گزینه تعیین نشده باشد، در
              محل تقاطع دو رنگ، برنامه آن‌ها را با هم ترکیب کرده و میانگین آن‌ها
              را در ناحیه مستطیلی تقاطع قرار می‌دهد. با تعیین گزینه -mesh،
              برنامه آن ناحیه را با یک الگوی شطرنجی متشکل از آن دو رنگ پر
              می‌کند. تصویر حاصل شبیه به یک پارچه بافته‌شده واقعی به نظر می‌رسد
              که در آن برای هر رنگ، تار و پود مجزایی به کار رفته است.

              این گزینه از Netpbm 10.97 (دسامبر ۲۰۲۱) اضافه شد.



       -randomseed integer
              این مقدار دانه‌ی اولیه (seed) برای مولد اعداد تصادفی است که
              پیکسل‌ها را ایجاد می‌کند.

              از این گزینه برای اطمینان از دریافت تصویری یکسان در دفعات مختلف
              اجرای دستور استفاده کنید.

              به‌طور پیش‌فرض، ppmpat از دانه‌ای استفاده می‌کند که از زمان جاری و
              شناسه فرایند (PID) مشتق شده است؛ این امر در دفعات مختلف اجرا،
              نتایجی کاملاً مستقل و نامرتبط با یکدیگر به دست می‌دهد.

              این گزینه از Netpbm 10.61 (دسامبر ۲۰۱۲) اضافه شد.




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


همچنین ببینید (SEE ALSO)
       pnmtile(1), pnmquant(1), ppmmake(1), ppmrainbow(1), pamgradient(1),
       ppm(1)


نویسنده (AUTHOR)
       حق نشر (C) سال ۱۹۸۹ متعلق به Jef Poskanzer است.

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

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

netpbm documentation           12 November 2023          Ppmpat User Manual(0)