Pambrighten User Manual(0) Pambrighten User Manual(0)

pambrighten - تغییر میزان Saturation و Value در تصاویر PPM

pambrighten [-saturation=[+|-]saturation_percent] [-value=[+|-]value_percent] [netpbmfile]

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

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

دستور pambrighten مقدار Saturation (اشباع رنگ) و Value (روشنایی رنگ) هر پیکسل از یک تصویر Netpbm را (بر اساس فضای رنگی HSV) افزایش یا کاهش می‌دهد. شما درصد تغییر را برای هر یک از این پارامترها مشخص می‌کنید.

همچنین می‌توانید رنگ‌های پیکسل‌ها را به گونه‌ای بازنگاشت کنید که مقادیر Value آن‌ها کل دامنه مقادیر ممکن Value را پوشش دهد.

تصویر ورودی از فایلی به نام netpbmfile یا در صورت تعیین نشدن netpbmfile، از ورودی استاندارد (Standard Input) خوانده می‌شود.

قالب خروجی همانند قالب ورودی است و هرگونه کانال اضافی، مانند شفافیت (transparency)، بدون تغییر عبور داده می‌شوند.

مدل Hue-Saturation-Value یا HSV، یکی از روش‌های نمایش رنگ است، درست مانند مدل شناخته‌شده‌تر RGB. متغیرهای Hue (فام)، Saturation (اشباع)، و Value (روشنایی) اعدادی در بازه 0 تا 1 هستند. در این نوشتار هرگاه منظور مقداری از فضای رنگی HSV باشد، همواره آن‌ها را با حرف بزرگ آغاز می‌کنیم؛ به‌ویژه از آنجا که واژه «value» در کاربرد معمول انگلیسی مفهومی بسیار انتزاعی‌تر دارد.

مقدار Value معیاری برای سنجش روشنایی رنگ نسبت به یک مقدار بیشینه مشخص است (قالب‌های Netpbm نیز بر اساس یک بیشینه روشنایی مشخص تعریف شده‌اند -- برای اهداف این برنامه، هر دوی آن‌ها یکسان هستند). به‌طور خاص، این مقدار برابر است با روشناییِ روشن‌ترین مؤلفه از رنگ‌های اصلی تقسیم بر بیشینه روشنایی ممکن برای یک مؤلفه. مقدار صفر برای Value به معنای رنگ سیاه است. رنگ سفید دارای Value کامل (1) است.

مقدار Hue نشان‌دهنده رنگ ثانویه‌ای با همان روشنایی است که بیشترین تقریب را به رنگ مورد نظر ارائه می‌دهد. یک رنگ ثانویه از ترکیب حداکثر دو مورد از رنگ‌های اصلی ساخته می‌شود.

مقدار Saturation معیاری است از نزدیکی رنگ به رنگِ مشخص‌شده توسط Hue و Value. مقدار کمتر به این معنی است که برای دستیابی به رنگ دقیق، باید نور بیشتری از رنگ اصلی سوم اضافه شود. اشباع (Saturation) کامل به این معناست که رنگ یک رنگ ثانویه خالص است. مقدار اشباع صفر به معنای رنگ خاکستری (یا سیاه و سفید) است. کاهش اشباع یک رنگ تمایل دارد که آن را رنگ‌ورفته و کدر کند.

اگر افزایش مقدار Value یک پیکسل به میزانی که تعیین کرده‌اید ناممکن باشد (برای مثال، مقدار Value برابر ۰٫۵ باشد و شما +200% را مشخص کنید)، pambrighten در عوض آن را به حداکثر Value افزایش می‌دهد.

اگر افزایش مقدار Saturation یک پیکسل به میزانی که تعیین کرده‌اید ناممکن باشد (برای مثال، از قبل نیمه‌اشباع باشد و شما +200% را مشخص کنید)، pambrighten در عوض آن را به حداکثر Saturation افزایش می‌دهد.

برای روش ساده‌تری از افزایش روشنایی، می‌توانید از pamfunc -multiplier صرفاً برای افزایش روشنایی هر پیکسل به میزان یک درصد مشخص استفاده کنید، که در آن هر مؤلفه RGB که روشنایی محاسبه‌شده آن از بیشینه روشنایی فراتر رود برش می‌خورد (clip می‌شود). بنابراین، علاوه بر عدم دستیابی به روشنایی مشخص‌شده، رنگمایگی (chromaticity) روشن‌ترین رنگ‌ها در تصویر تغییر خواهد کرد. برای کاهش روشنایی، دستور pamfunc باید عملکرد یکسانی با pambrighten داشته باشد.

دستور ppmflash نوع دیگری از روشن‌سازی را انجام می‌دهد. این دستور رنگ هر پیکسل را تغییر می‌دهد تا آن را به میزانی درصدی مشخص به رنگ سفید نزدیک‌تر کند. این کار باعث افزایش value و saturation می‌شود.

برنامه pambrighten به عنوان جایگزینی برای ppmbrighten طراحی شده است. این برنامه همانند ppmbrighten عمل می‌کند، با این تفاوت که قالب‌های تصویری گوناگون Netpbm را به رسمیت می‌شناسد به جای اینکه با همه آن‌ها مانند PPM رفتار کند. قالب خروجی مشابه قالب ورودی است و کانال‌های اضافی در یک تصویر PAM (مانند کانال شفافیت) دست‌نخورده عبور داده می‌شوند.

اگر قصد تغییر دادن فام‌ها (hues) را در تصویر دارید، از pamhue استفاده کنید.

برای دو برابر کردن Value هر پیکسل:

pambrighten -value=100

برای دو برابر کردن Saturation و نصف کردن Value هر پیکسل:

pambrighten -saturation=+100 -value=-50

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

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

پیش‌فرض صفر است.

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

پیش‌فرض صفر است.

pnmnorm(1), ppmdim(1), pamfunc(1), ppmflash(1), pamaltsat(1), pamdepth(1), pnmgamma(1), pamhue(1), ppmhist(1), ppm(1)

دستور pambrighten در Netpbm 10.86 (مارس ۲۰۱۹) جدید بود. این برنامه نسخه تبدیل‌شده به PAM از دستور بسیار قدیمی‌تر ppmbrighten بود.

حق نشر © ۱۹۹۰ متعلق به Brian Moffet. حق نشر © ۱۹۸۹ متعلق به Jef Poskanzer.

مجوز استفاده، رونوشت‌برداری، تغییر و توزیع این نرم‌افزار و مستندات آن به هر منظور و بدون دریافت هزینه، بدین وسیله اعطا می‌شود، به این شرط که اعلامیه حق نشر فوق در تمامی نسخه‌ها درج شود و هر دو اعلامیه حق نشر و این اعلامیه مجوز در مستندات پشتیبان ذکر گردند. این نرم‌افزار «همان‌گونه که هست» و بدون هرگونه ضمانت صریح یا ضمنی ارائه می‌شود.

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

http://netpbm.sourceforge.net/doc/pambrighten.html
18 August 2020 netpbm documentation