.\" 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 "Pamgetcolor User Manual" 0 "18 May 2018" "netpbm documentation"

.SH "نام (NAME)"
pamgetcolor \- نمایش میانگین رنگ‌های نواحی مشخص‌شده در یک تصویر

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

\fBpamgetcolor\fP
[\fB-format\fP \fIformat\fP]
[\fB-radius\fP \fIradius\fP]
[\fB-linear\fP]
[\fB-infile\fP \fIpamfile\fP]
\fIregion1\fP [\fIregion2\fP ...]

.UN description
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخشی از
.BR "Netpbm" (1)\c
\& است.
.PP
دستور \fBpamgetcolor\fP میانگین رنگ‌های مجموعه‌ای از نواحی دایره‌ای را در تصویر ورودی چاپ می‌کند.
.PP
شما یک ناحیه را به عنوان یک آرگومان مکانی به قالب
\fIcolumn\fP,\fIrow\fP[:\fIlabel\fP] مشخص می‌کنید، که در آن \fIcolumn\fP (ستون) و \fIrow\fP (سطر)
مختصات مرکز دایره هستند (اولین سطر پیکسل‌ها سطر ۰ است؛
چپ‌ترین ستون پیکسل‌ها ستون ۰ است)، و \fIlabel\fP برچسبی اختیاری است
که \fBpamgetcolor\fP برای شناسایی آن ناحیه در خروجی خود نمایش می‌دهد.
همه نواحی شعاع یکسانی دارند که توسط گزینه \fB-radius\fP مشخص می‌شود.
مراکز نواحی باید درون تصویر قرار داشته باشند، اما بخشی از یک ناحیه ممکن است
بیرون از تصویر بیفتد؛ \fBpamgetcolor\fP در محاسبات فقط بخشی را که درون
تصویر قرار دارد در نظر می‌گیرد.


.UN examples
.SH "مثال‌ها (EXAMPLES)"

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

.nf
\f(CW
    pamgetcolor 10,14 -infile test.ppm
\fP
.fi
.PP
برای خواندن رنگ‌های سه پیکسل با قالب پیش‌فرض، همراه با تخصیص یک برچسب به هر پیکسل:
  
.nf
\f(CW
    pamgetcolor 10,10:topleft 100,100:middle 200,200:bottomright -infile test.ppm
\fP
.fi
.PP
برای خواندن میانگین رنگ در دایره‌ای با شعاع چهار پیکسل و مرکز در (100,100) با دقت ۱۶ بیتی:

.nf
\f(CW
    pamgetcolor -format int:65535 -radius 4 100,100 -infile test.ppm
\fP
.fi

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



.TP
\fB-format\fP
قالبی را که رنگ‌ها باید در آن خروجی داده شوند مشخص می‌کند. خروجی همواره یک
.UR libppm.html#colorname
مشخصات رنگ Netpbm
.UE
\& است؛ این
قالب تعیین می‌کند که برنامه از کدام‌یک از مشخصات گوناگون برای یک رنگ یکسان استفاده کند.
.sp
این آرگومان به صورت \fIformatId\fP[:\fIparam\fP] است، که در آن
\fIformatId\fP قالب را مشخص کرده و \fIparam\fP یک پارامتر عدد صحیح
مثبت است که بسته به \fIformatId\fP، دقت
یا نرمال‌سازی را نشان می‌دهد. مقادیر زیر برای
\fIformatId\fP امکان‌پذیر هستند:

.TP
int
نمونه‌ها اعداد صحیح ده‌دهی هستند که بر اساس maxval مشخص‌شده توسط
\fIparam\fP نرمال‌سازی شده‌اند. مثال: \fBrgb-255:255/128/64\fP
این قالب به صورت پیش‌فرض با maxval برابر با ۲۵۵ است.
.TP
norm
نمونه‌ها اعداد ممیز شناور هستند که به یک (مقدار واحد) نرمال شده‌اند؛ مانند
\fBrgbi:1.0/0.5/.25\fP
\fIparam\fP دقت را به عنوان تعداد ارقام بخش اعشاری مشخص می‌کند.
.TP
x11
نمونه‌ها اعداد هگزادسیمال با \fIparam\fP رقم هستند؛
مانند \fBrgb:01/ff/8000\fP


.TP
\fB-radius\fP
شعاع نواحی را تنظیم می‌کند.
مقدار صفر باعث می‌شود \fBpamgetcolor\fP تنها یک پیکسل را اندازه بگیرد و
مقدار پیش‌فرض است.

.TP
\fB-infile\fP
فایل Netpbm را برای تحلیل مشخص می‌کند.
.sp
اگر این گزینه را مشخص نکنید، \fBpamgetcolor\fP تصویر را از
ورودی استاندارد (Standard Input) می‌خواند.

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



.UN seealso
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR "pnmcolormap" (1)\c
\&،


.UN author
.SH "نویسندگان (AUTHORS)"
.PP
این برنامه نخستین بار توسط Anton Shepelev
(\fIanton.txt@gmail.com\fP) ارائه شد.

.UN history
.SH "تاریخچه (HISTORY)"
.PP
این برنامه در Netpbm 10.83 (ژوئن ۲۰۱۸) جدید بود.

.UN index
.SH "فهرست مطالب (TABLE OF CONTENTS)"

.IP \(bu

.UR #synopsis
خلاصه دستور (SYNOPSIS)
.UE
\&
.IP \(bu

.UR #description
توضیحات (DESCRIPTION)
.UE
\&
.IP \(bu

.UR #examples
مثال‌ها (EXAMPLES)
.UE
\&
.IP \(bu

.UR #options
گزینه‌ها (OPTIONS)
.UE
\&
.IP \(bu

.UR #seealso
همچنین ببینید (SEE ALSO)
.UE
\&
.IP \(bu

.UR #author
نویسندگان (AUTHORS)
.UE
\&
.IP \(bu

.UR #history
تاریخچه (HISTORY)
.UE
\&
.SH "منبع سند (DOCUMENT SOURCE)"
این صفحه راهنما توسط ابزار 'makeman' در Netpbm از منبع HTML تولید شده است.
مستندات مرجع در نشانی زیر قرار دارد:
.IP
.B http://netpbm.sourceforge.net/doc/pamgetcolor.html
.PP