Pampaintspill User Manual(0) Pampaintspill User Manual(0)

pampaintspill - پخش روان رنگ‌ها در پس‌زمینه تصویر

pampaintspill [--bgcolor=color] [--wrap] [--all] [--downsample=number] [--near=number] [--power=number] [filename] [-randomseed=integer]

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

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

دستور pampaintspill یک گرادیان رنگی روان از تمامی پیکسل‌های غیر پس‌زمینه در تصویر ورودی ایجاد می‌کند که در عمل مانند «ریختن رنگ» بر روی پس‌زمینه عمل می‌نماید. دستور pampaintspill مشابه pamgradient است، اما در ویژگی‌های زیر با آن تفاوت دارد:

  • دستور pampaintspill هر تعداد منبع رنگ (پیکسل‌های غیر هم‌رنگ با پس‌زمینه) را می‌پذیرد که می‌توانند در هر نقطه‌ای از بوم تصویر قرار داشته باشند. در مقابل، pamgradient دقیقاً چهار منبع رنگ، یکی در هر گوشه از تصویر، را می‌پذیرد.
  • دستور pampaintspill به یک تصویر ورودی نیاز دارد، در حالی که pamgradient تصویری کاملاً جدید را از ابتدا تولید می‌کند.
  • دستور pampaintspill می‌تواند خروجی قابل کاشی‌کاری (tileable) تولید کند و قادر است میزان وابستگی و پیوستگی شدید رنگ‌های گرادیان به پیکسل‌های منبع را کنترل نماید.

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

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

رنگ پس‌زمینه را به‌طور صریح مشخص می‌کند. color را می‌توان با استفاده از هر قالبی که توسط تابع کتابخانه‌ای pnm_parsecolor() پذیرفته می‌شود، مانند red یا #ff0000، مشخص کرد. اگر --bgcolor مشخص نشود، pampaintspill بر اساس رنگ‌های موجود در گوشه‌های تصویر، حدس معقولی در مورد رنگ پس‌زمینه می‌زند.

به گرادیان‌ها اجازه می‌دهد در امتداد لبه‌های تصویر به دور خود بپیچند (تکرار شوند). به این معنی که رنگ‌هایی که از سمت راست تصویر سرریز می‌شوند، در سمت چپ تصویر دوباره ظاهر می‌شوند و همین وضعیت برای چپ/راست، بالا/پایین و پایین/بالا نیز برقرار است. گزینهٔ --wrap تصاویر را قابل کاشی‌کاری (tileable) می‌کند که برای تولید تصاویر پس‌زمینهٔ میزکار مناسب است.

رنگ‌آمیزی مجدد همه پیکسل‌ها، نه فقط پیکسل‌های پس‌زمینه. در حالت عادی، پیکسل‌های غیر پس‌زمینه در تصویر ورودی بدون تغییر در تصویر خروجی ظاهر می‌شوند. با فعال بودن --all، همهٔ پیکسل‌ها بر اساس فاصله‌شان از تمام پیکسل‌های (دیگر) غیر پس‌زمینه رنگ‌آمیزی می‌شوند.

نادیده گرفتن همه پیکسل‌های غیر پس‌زمینه به جز به تعداد number. هنگامی که تعداد زیادی از پیکسل‌های تصویر ورودی از نظر رنگ با پس‌زمینه متفاوت باشند، pampaintspill بسیار کند اجرا می‌شود. گزینهٔ --downsample به‌طور تصادفی تعداد مشخص‌شده‌ای از پیکسل‌های رنگی را به عنوان منابع رنگ برای گرادیان‌ها انتخاب می‌کند و مابقی را نادیده می‌گیرد؛ به این ترتیب کیفیت تصویر فدای سرعت اجرا می‌شود.

تنها نزدیک‌ترین منابع رنگ به تعداد number را هنگام محاسبه رنگ جدید یک پیکسل در نظر می‌گیرد. حالت پیش‌فرض این است که تمامی منابع رنگ در نظر گرفته شوند. در بیشتر موارد، مقدار number باید نسبتاً کوچک باشد، در غیر این صورت تأثیر آن بسیار اندک خواهد بود و زمان اجرا بیهوده افزایش می‌یابد. مقدار 1 رنگ‌آمیزی‌ای تولید می‌کند که بسیار شبیه به یک نمودار ورونوی (Voronoi) است.

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

کنترل نحوه تغییر شدت رنگ به عنوان تابعی از فاصله نسبت به منبع رنگ. مقدار پیش‌فرض برای number برابر با -2.0 است، به این معنی که شدت رنگ (به دلیل علامت منفی) با مجذور (به دلیل 2.0) فاصله از هر منبع رنگ کاهش می‌یابد. مقدار -2.0 عموماً در عمل خوب کار می‌کند، اما مقادیر دیگری را می‌توان برای جلوه‌های ویژه گوناگون تعیین کرد. با تعداد بسیار کمی از منابع رنگ، مقدار -1.0 ممکن است گرادیان‌های نامحسوس‌تری تولید کند، اما با افزایش تعداد منابع رنگ، این گرادیان‌ها محوتر و کدرتر می‌شوند. مقادیر مثبت (مانند 1.0 و 2.0) با راندن گرادیان‌ها به دورتر از منابع رنگ، باعث برجسته شدن منابع رنگ در تصویر خروجی می‌شوند.

این مقدار، بذر (seed) برای مولد اعداد تصادفی است که پیکسل‌ها را تولید می‌کند.

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

این گزینه در Netpbm نسخهٔ 10.94 (مارس ۲۰۲۱) اضافه شده است.

  • pamgradient(1)

  • ppmmake(1),

  • ppmrainbow(1),

  • pgmramp(1),

  • ppmpat(1),

  • pam(1)

دستور pampaintspill در Netpbm نسخهٔ 10.50 (مارس ۲۰۱۰) معرفی شد.

حق نشر © 2010–2021 متعلق به Scott Pakin، scott+pbm@pakin.org است.

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

http://netpbm.sourceforge.net/doc/pampaintspill.html
02 November 2021 netpbm documentation