نام (NAME)

xcolor - انتخاب‌گر رنگ سبک برای X11

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

xcolor [-f NAME | -c FORMAT] [-s [SELECTION]] [-S SCALE] [-P PREVIEW_SIZE] [-v] [-h]

توضیحات (DESCRIPTION)

xcolor یک انتخاب‌گر رنگ سبک برای X11 است. از ماوس برای انتخاب رنگ‌های قابل مشاهده در هر کجای صفحه نمایش استفاده کنید تا بازنمایی RGB آن‌ها را دریافت نمایید.

به‌طور پیش‌فرض، رنگ انتخاب‌شده در خروجی استاندارد چاپ می‌شود.

گزینه‌ها (OPTIONS)

-f NAME, --format NAME: قالب خروجی را مشخص می‌کند. مقادیر ممکن برای NAME عبارتند از hex، HEX، hex!، HEX!، rgb و plain. برای توضیح گزینه‌های مختلف قالب‌بندی به بخش قالب‌بندی (FORMATTING) مراجعه کنید. با --custom تداخل دارد.
-c FORMAT, --custom FORMAT: الگوی قالب خروجی سفارشی را مشخص می‌کند. برای توضیح نحو الگو به بخش قالب‌بندی سفارشی (CUSTOM FORMATTING) مراجعه کنید. با --format تداخل دارد.
-s [SELECTION], --selection [SELECTION]: ذخیره خروجی در گزینش (selection) مربوط به X11. مقادیر ممکن برای SELECTION عبارتند از clipboard، primary و secondary. اگر SELECTION ارائه نشود، از clipboard استفاده می‌شود.
-S, --scale: مقیاس بزرگ‌نمایی انتخاب‌گر، پیش‌فرض 8 است
-P, --preview-size: اندازه به پیکسل انتخاب‌گر، پیش‌فرض 255 است
-v, --version: چاپ اطلاعات نسخه و خروج.
-h, --help: چاپ پیام راهنما و خروج.

قالب‌بندی (FORMATTING)

به‌طور پیش‌فرض، مقادیر رنگ در قالب شانزده‌شانزدهی (hexadecimal) با حروف کوچک چاپ می‌شوند. قالب خروجی را می‌توان با استفاده از سوییچ --format NAME تغییر داد. مقادیر ممکن برای NAME عبارتند از:

hex: شانزده‌شانزدهی با حروف کوچک (پیش‌فرض)
HEX: شانزده‌شانزدهی با حروف بزرگ
hex!: شانزده‌شانزدهی فشرده با حروف کوچک
HEX!: شانزده‌شانزدهی فشرده با حروف بزرگ
rgb: مقدار ده‌دهی RGB
plain: ده‌دهی با جداکننده‌های نقطه‌ویرگول

شکل فشرده به کدهای رنگی سه‌حرفی CSS اشاره دارد، همان‌طور که در CSS Color Module Level 3 مشخص شده است. اگر رنگ در قالب سه‌حرفی قابل بیان نباشد، از شکل شش‌حرفی معمولی استفاده خواهد شد.

قالب‌بندی سفارشی (CUSTOM FORMATTING)

سوییچ --format دسترسی سریع به برخی از گزینه‌های پرکاربرد قالب‌بندی را فراهم می‌کند. با این حال، در صورت تمایل به قالب‌بندی سفارشی خروجی، می‌توان با استفاده از سوییچ --custom FORMAT به این هدف دست یافت. پارامتر FORMAT الگویی را برای خروجی تعیین می‌کند و از یک زبان الگوی ساده پشتیبانی می‌نماید. الگوهای FORMAT می‌توانند شامل بسط‌های ویژه‌ای باشند که درون بلوک‌های %{...} نوشته می‌شوند. این بلوک‌ها مطابق با مشخص‌کننده‌های تعریف‌شده در داخل بلوک، به مقادیر رنگ بسط داده خواهند شد. در اینجا نمونه‌هایی از رشته‌های قالب معتبر و خروجی احتمالی آن‌ها آورده شده است:

رشته قالب	خروجی نمونه
%{r}, %{g}, %{b}	255, 0, 100
Green: %{-4g}	Green: ---7
#%{02hr}%{02hg}%{02hb}	#00ff00
%{016Br}	0000000000000011

بلوک‌های بسط در رشته‌های قالب همواره حاوی یک مشخص‌کننده کانال هستند (r برای قرمز، g برای سبز، و b برای آبی). افزون بر این، آن‌ها می‌توانند شامل یک مشخص‌کننده اختیاری قالب عدد (h برای شانزده‌شانزدهی با حروف کوچک، H برای شانزده‌شانزدهی با حروف بزرگ، o برای هشت‌هشتی، B برای دودویی، و d برای ده‌دهی) و یک مشخص‌کننده اختیاری پرکردن (padding) متشکل از نویسه‌ای برای پرکردن و طولی که رشته باید تا آن پر شود، باشند. نمودار زیر نشان می‌دهد چگونه می‌توانیم از این قواعد برای رمزگشایی یک الگوی قالب‌بندی استفاده کنیم:

%{016Br}
  | |||
  | ||`- کانال (red)
  | |`-- مشخص‌کننده قالب عدد (binary)
  | `--- طول پرکردن (16)
  `----- نویسه مورد استفاده برای پرکردن (0)

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

محیط (ENVIRONMENT)

XCOLOR_FOREGROUND: غیرفعال‌سازی حالت دیمن (daemon). به دلیل نحوه عملکرد گزینش‌ها در X11، هنگامی که از حالت --selection استفاده می‌شود، xcolor به پس‌زمینه فورک (fork) می‌شود. این رفتار را می‌توان با تعریف متغیر محیطی XCOLOR_FOREGROUND غیرفعال کرد.

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

Samuel Laurén <samuel.lauren@iki.fi> Callum Osmotherly <acheronfail@gmail.com>