نام (NAME)

pamgetcolor - نمایش میانگین رنگ‌های نواحی مشخص‌شده در یک تصویر

خلاصه دستور (SYNOPSIS)

pamgetcolor [-format format] [-radius radius] [-linear] [-infile pamfile] region1 [region2 ...]

توضیحات (DESCRIPTION)

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

دستور pamgetcolor میانگین رنگ‌های مجموعه‌ای از نواحی دایره‌ای را در تصویر ورودی چاپ می‌کند.

شما یک ناحیه را به عنوان یک آرگومان مکانی به قالب column,row[:label] مشخص می‌کنید، که در آن column (ستون) و row (سطر) مختصات مرکز دایره هستند (اولین سطر پیکسل‌ها سطر ۰ است؛ چپ‌ترین ستون پیکسل‌ها ستون ۰ است)، و label برچسبی اختیاری است که pamgetcolor برای شناسایی آن ناحیه در خروجی خود نمایش می‌دهد. همه نواحی شعاع یکسانی دارند که توسط گزینه -radius مشخص می‌شود. مراکز نواحی باید درون تصویر قرار داشته باشند، اما بخشی از یک ناحیه ممکن است بیرون از تصویر بیفتد؛ pamgetcolor در محاسبات فقط بخشی را که درون تصویر قرار دارد در نظر می‌گیرد.

مثال‌ها (EXAMPLES)

برای خواندن رنگ پیکسل در موقعیت (10,14) با قالب پیش‌فرض:

    pamgetcolor 10,14 -infile test.ppm

برای خواندن رنگ‌های سه پیکسل با قالب پیش‌فرض، همراه با تخصیص یک برچسب به هر پیکسل:

    pamgetcolor 10,10:topleft 100,100:middle 200,200:bottomright -infile test.ppm

برای خواندن میانگین رنگ در دایره‌ای با شعاع چهار پیکسل و مرکز در (100,100) با دقت ۱۶ بیتی:

    pamgetcolor -format int:65535 -radius 4 100,100 -infile test.ppm

گزینه‌ها (OPTIONS)

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

-format

قالبی را که رنگ‌ها باید در آن خروجی داده شوند مشخص می‌کند. خروجی همواره یک مشخصات رنگ Netpbm است؛ این قالب تعیین می‌کند که برنامه از کدام‌یک از مشخصات گوناگون برای یک رنگ یکسان استفاده کند.

این آرگومان به صورت formatId[:param] است، که در آن formatId قالب را مشخص کرده و param یک پارامتر عدد صحیح مثبت است که بسته به formatId، دقت یا نرمال‌سازی را نشان می‌دهد. مقادیر زیر برای formatId امکان‌پذیر هستند:

int

نمونه‌ها اعداد صحیح ده‌دهی هستند که بر اساس maxval مشخص‌شده توسط param نرمال‌سازی شده‌اند. مثال: rgb-255:255/128/64 این قالب به صورت پیش‌فرض با maxval برابر با ۲۵۵ است.

norm

نمونه‌ها اعداد ممیز شناور هستند که به یک (مقدار واحد) نرمال شده‌اند؛ مانند rgbi:1.0/0.5/.25 param دقت را به عنوان تعداد ارقام بخش اعشاری مشخص می‌کند.

x11

نمونه‌ها اعداد هگزادسیمال با param رقم هستند؛ مانند rgb:01/ff/8000

-radius

شعاع نواحی را تنظیم می‌کند. مقدار صفر باعث می‌شود pamgetcolor تنها یک پیکسل را اندازه بگیرد و مقدار پیش‌فرض است.

-infile

فایل Netpbm را برای تحلیل مشخص می‌کند.

اگر این گزینه را مشخص نکنید، pamgetcolor تصویر را از ورودی استاندارد (Standard Input) می‌خواند.

-linear

به pamgetcolor می‌گوید تا با گونه خطی بر حسب شدت نور (intensity-linear) از تصاویر Netpbm کار کند، که در آن نمونه‌ها به جای روشنایی، متناسب با شدت نور هستند؛ برخلاف قالب‌های واقعی (تنظیم‌شده با گاما) Netpbm.

همچنین ببینید (SEE ALSO)

pnmcolormap(1)،

نویسندگان (AUTHORS)

این برنامه نخستین بار توسط Anton Shepelev (anton.txt@gmail.com) ارائه شد.

تاریخچه (HISTORY)

این برنامه در Netpbm 10.83 (ژوئن ۲۰۱۸) جدید بود.

فهرست مطالب (TABLE OF CONTENTS)

• خلاصه دستور (SYNOPSIS)

• توضیحات (DESCRIPTION)

• مثال‌ها (EXAMPLES)

• گزینه‌ها (OPTIONS)

• همچنین ببینید (SEE ALSO)

• نویسندگان (AUTHORS)

• تاریخچه (HISTORY)

منبع سند (DOCUMENT SOURCE)

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

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