'\" t
.TH XCOLOR 1 2018
.SH "نام (NAME)"
xcolor \- انتخاب‌گر رنگ سبک برای X11
.SH "خلاصه دستور (SYNOPSIS)"
.B xcolor
[\fB\-f\fR \fINAME\fR | \fB\-c\fR \fIFORMAT\fR] [\fB\-s\fR [\fISELECTION\fR]] [\fB\-S\fR \fISCALE\fR] [\fB\-P\fR \fIPREVIEW_SIZE\fR] [\fB\-v\fR] [\fB\-h\fR]
.SH "توضیحات (DESCRIPTION)"
\fBxcolor\fR یک انتخاب‌گر رنگ سبک برای X11 است. از ماوس برای انتخاب رنگ‌های قابل مشاهده در هر کجای صفحه نمایش استفاده کنید تا بازنمایی RGB آن‌ها را دریافت نمایید.
.PP
به‌طور پیش‌فرض، رنگ انتخاب‌شده در خروجی استاندارد چاپ می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-f " NAME\fR,\fP " \-\-format " NAME"
قالب خروجی را مشخص می‌کند. مقادیر ممکن برای \fINAME\fR عبارتند از \fBhex\fR، \fBHEX\fR، \fBhex!\fR، \fBHEX!\fR، \fBrgb\fR و \fBplain\fR. برای توضیح گزینه‌های مختلف قالب‌بندی به بخش \fBقالب‌بندی (FORMATTING)\fR مراجعه کنید. با \fB\-\-custom\fR تداخل دارد.
.TP
.BI \-c " FORMAT\fR,\fP " \-\-custom " FORMAT"
الگوی قالب خروجی سفارشی را مشخص می‌کند. برای توضیح نحو الگو به بخش \fBقالب‌بندی سفارشی (CUSTOM FORMATTING)\fR مراجعه کنید. با \fB\-\-format\fR تداخل دارد.
.TP
.BI \-s " \fR[\fPSELECTION\fR]\fP\fR,\fP " \-\-selection " \fR[\fPSELECTION\fR]\fP"
ذخیره خروجی در گزینش (selection) مربوط به X11. مقادیر ممکن برای \fISELECTION\fR عبارتند از \fBclipboard\fR، \fBprimary\fR و \fBsecondary\fR. اگر \fISELECTION\fR ارائه نشود، از \fBclipboard\fR استفاده می‌شود.
.TP
.BR \-S ", " \-\-scale
مقیاس بزرگ‌نمایی انتخاب‌گر، پیش‌فرض 8 است
.TP
.BR \-P ", " \-\-preview\-size
اندازه به پیکسل انتخاب‌گر، پیش‌فرض 255 است
.TP
.BR \-v ", " \-\-version
چاپ اطلاعات نسخه و خروج.
.TP
.BR \-h ", " \-\-help
چاپ پیام راهنما و خروج.
.SH "قالب‌بندی (FORMATTING)"
به‌طور پیش‌فرض، مقادیر رنگ در قالب شانزده‌شانزدهی (hexadecimal) با حروف کوچک چاپ می‌شوند. قالب خروجی را می‌توان با استفاده از سوییچ \fB\-\-format\fR \fINAME\fR تغییر داد. مقادیر ممکن برای \fINAME\fR عبارتند از:
.TP
.B hex
شانزده‌شانزدهی با حروف کوچک (پیش‌فرض)
.TP
.B HEX
شانزده‌شانزدهی با حروف بزرگ
.TP
.B hex!
شانزده‌شانزدهی فشرده با حروف کوچک
.TP
.B HEX!
شانزده‌شانزدهی فشرده با حروف بزرگ
.TP
.B rgb
مقدار ده‌دهی RGB
.TP
.B plain
ده‌دهی با جداکننده‌های نقطه‌ویرگول
.PP
شکل فشرده به کدهای رنگی سه‌حرفی CSS اشاره دارد، همان‌طور که در CSS Color Module Level 3 مشخص شده است. اگر رنگ در قالب سه‌حرفی قابل بیان نباشد، از شکل شش‌حرفی معمولی استفاده خواهد شد.
.SS "قالب‌بندی سفارشی (CUSTOM FORMATTING)"
سوییچ \fB\-\-format\fR دسترسی سریع به برخی از گزینه‌های پرکاربرد قالب‌بندی را فراهم می‌کند. با این حال، در صورت تمایل به قالب‌بندی سفارشی خروجی، می‌توان با استفاده از سوییچ \fB\-\-custom\fR \fIFORMAT\fR به این هدف دست یافت. پارامتر \fIFORMAT\fR الگویی را برای خروجی تعیین می‌کند و از یک زبان الگوی ساده پشتیبانی می‌نماید.
الگوهای \fIFORMAT\fR می‌توانند شامل بسط‌های ویژه‌ای باشند که درون بلوک‌های \fB%\fR{\fI...\fR} نوشته می‌شوند. این بلوک‌ها مطابق با مشخص‌کننده‌های تعریف‌شده در داخل بلوک، به مقادیر رنگ بسط داده خواهند شد. در اینجا نمونه‌هایی از رشته‌های قالب معتبر و خروجی احتمالی آن‌ها آورده شده است:
.RS
.TS
lB lB
l l.
رشته قالب	خروجی نمونه
%{r}, %{g}, %{b}	255, 0, 100
Green: %{-4g}	Green: ---7
#%{02hr}%{02hg}%{02hb}	#00ff00
%{016Br}	0000000000000011
.TE
.RE

بلوک‌های بسط در رشته‌های قالب همواره حاوی یک مشخص‌کننده کانال هستند (\fBr\fR برای قرمز، \fBg\fR برای سبز، و \fBb\fR برای آبی). افزون بر این، آن‌ها می‌توانند شامل یک مشخص‌کننده اختیاری قالب عدد (\fBh\fR برای شانزده‌شانزدهی با حروف کوچک، \fBH\fR برای شانزده‌شانزدهی با حروف بزرگ، \fBo\fR برای هشت‌هشتی، \fBB\fR برای دودویی، و \fBd\fR برای ده‌دهی) و یک مشخص‌کننده اختیاری پرکردن (padding) متشکل از نویسه‌ای برای پرکردن و طولی که رشته باید تا آن پر شود، باشند. نمودار زیر نشان می‌دهد چگونه می‌توانیم از این قواعد برای رمزگشایی یک الگوی قالب‌بندی استفاده کنیم:

.nf
.RS
\fB%\fR{\fI0\fR\fB16\fR\fIB\fR\fBr\fR}
  | |||
  | ||`- کانال (\fIred\fR)
  | |`-- مشخص‌کننده قالب عدد (\fIbinary\fR)
  | `--- طول پرکردن (\fI16\fR)
  `----- نویسه مورد استفاده برای پرکردن (\fI0\fR)
.RE
.fi

خروجی، محتوای کانال رنگ قرمز است که در قالب دودویی قالب‌بندی شده و با صفر پر شده است تا طول آن شانزده نویسه شود.
.SH "محیط (ENVIRONMENT)"
.TP
.I XCOLOR_FOREGROUND
غیرفعال‌سازی حالت دیمن (daemon). به دلیل نحوه عملکرد گزینش‌ها در X11، هنگامی که از حالت \fB\-\-selection\fR استفاده می‌شود، \fBxcolor\fR به پس‌زمینه فورک (fork) می‌شود. این رفتار را می‌توان با تعریف متغیر محیطی \fIXCOLOR_FOREGROUND\fR غیرفعال کرد.
.SH "نویسندگان (AUTHORS)"
Samuel Laurén <samuel.lauren@iki.fi>
Callum Osmotherly <acheronfail@gmail.com>