.Dd $Mdocdate: November 14 2022 $
.Dt HYPRPICKER 1
.Os Linux
.Sh "نام (NAME)"
.Nm hyprpicker
.Nd ابزار انتخاب رنگ در وی‌لند سازگار با wlroots
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl acnh
.Op Fl f Ar fmt
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک انتخاب‌کننده رنگ با پشتیبانی از قالب‌های مختلف خروجی است.
هنگامی که
.Nm
فراخوانی می‌شود، نشانگر ماوس به یک ذره‌بین تبدیل می‌شود، و کلیک روی هر پیکسل از صفحه، رنگ آن پیکسل را در خروجی استاندارد چاپ می‌کند.
قالب پیش‌فرض خروجی هگزادسیمال است، اما می‌توان آن را با گزینه
.Fl f
پیکربندی کرد.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl a , Fl Fl autocopy
خروجی
.Nm
را به طور خودکار در کلیپ‌بورد کپی می‌کند.
این گزینه نیازمند نصب بودن دستور
.Xr wl-copy 1
روی سیستم است.
.It Fl f Ar fmt , Fl Fl format Ns = Ns Ar fmt
قالب خروجی رنگ پیکسل انتخاب‌شده را تعیین می‌کند.
آرگومان
.Ar fmt
به بزرگی و کوچکی حروف حساس نیست.
گزینه‌های موجود عبارتند از:
.Pp
.Bl -hang -compact
.It Ar cmyk
.Pq Dq C% M% Y% K%
.It Ar hex
.Pq Dq #RRGGBB
.It Ar rgb
.Pq Dq R G B
.It Ar hsl
.Pq Dq H S% L%
.It Ar hsv
.Pq Dq H S% V%
.El
.Pp
قالب پیش‌فرض
.Ar hex
است.
.It Fl n , Fl Fl no-fancy
خروجی رنگی را غیرفعال می‌کند.
رفتار پیش‌فرض نمایش خروجی با همان رنگ پیکسل انتخاب‌شده است.
.It Fl h , Fl Fl help
پیام راهنما را نمایش داده و با موفقیت خارج می‌شود.
.It Fl c , Fl Fl cursor
نشانگر ماوس را در پیش‌نمایش ثابت‌شده (freeze) قرار می‌دهد.
.El
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width NO_COLOR
.It Ev NO_COLOR
در صورت تنظیم، خروجی رنگی غیرفعال می‌شود.
.El
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std
.Sh "مثال‌ها (EXAMPLES)"
دریافت رنگ یک پیکسل:
.Pp
.Dl $ hyprpicker
.Pp
دریافت رنگ یک پیکسل در قالب HSL، در قالب تابع
.Fn hsl
در CSS:
.Pp
.Dl $ hyprpicker -f hsl | sed 's/^/hsl(/; s/$/)/; y/ /,/'
.Sh "همچنین ببینید (SEE ALSO)"
.Xr hyprctl 1 ,
.Xr hyprland 1 ,
.Xr sed 1 ,
.Xr wl-copy 1
.Pp
.Lk https://github.com/hyprwm/hyprpicker "سورس‌های Hyprpicker"
.Sh "نویسندگان (AUTHORS)"
.An -nosplit
ابزار
.Nm
در ابتدا توسط
.An Vaxerski Aq Lk https://github.com/vaxerski
و صفحه راهنما توسط
.An Thomas Voss Aq Mt mail@thomasvoss.com
نوشته شده است.
.Sh "اشکالات (BUGS)"
.Lk https://github.com/hyprwm/hyprpicker/issues "سامانه ثبت اشکالات Hyprpicker"