.TH REDSHIFT 1
.SH "نام (NAME)"
redshift \- تنظیم دمای رنگ صفحه نمایش بر اساس زمان روز
.SH "خلاصه دستور (SYNOPSIS)"
.B redshift
\fR[\fB\-l\fR \fILAT\fB:\fILON\fR | \fB\-l\fR \fIPROVIDER\fB:\fIOPTIONS\fR] [\fB\-t\fR \fIDAY\fB:\fINIGHT\fR] [\fIگزینه‌ها\fR...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B redshift
دمای رنگ صفحه نمایش شما را بر اساس محیط اطرافتان تنظیم می‌کند. این کار ممکن است در صورت کار با صفحه نمایش در شب، به کاهش درد و خستگی چشم یا کاهش خطر ابتلا به سندرم تأخیر فاز خواب کمک کند.
.PP
دمای رنگ بر اساس موقعیت خورشید تنظیم می‌شود. دمای رنگ متفاوتی در طول شب و روز تنظیم می‌گردد. در زمان گرگ‌ومیش و اوایل صبح، دمای رنگ به نرمی از دمای شب به روز تغییر می‌کند تا چشمان شما بتوانند در مدت حدود یک ساعت به آرامی با آن سازگار شوند. در شب دمای رنگ باید به گونه‌ای تنظیم شود که با لامپ‌های اتاق شما هماهنگ باشد. این مقدار معمولاً دمای پایینی در حدود ۳۰۰۰K تا ۴۰۰۰K است (پیش‌فرض ۴۵۰۰K است). در طول روز، دمای رنگ باید با نور بیرون هماهنگ باشد که معمولاً حدود ۵۵۰۰K تا ۶۵۰۰K است (پیش‌فرض ۶۵۰۰K است). نور در یک روز ابری دمای بالاتری دارد.
.PP
علاوه بر ابزار خط فرمان
.BR redshift ،
رابط گرافیکی
.B redshift-gtk
رابط کاربری جایگزینی را فراهم می‌کند که به صورت یک آیکون اعلان در محیط دسکتاپ نمایش داده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR
نمایش پیام راهنما.
.TP
\fB\-v\fR
فعال کردن خروجی با جزئیات کامل (verbose).
.TP
\fB\-V\fR
نمایش نسخه برنامه.
.TP
\fB\-b\fR \fIDAY\fB:\fINIGHT\fR
روشنایی صفحه نمایش برای اعمال (بین 0.1 و 1.0).
.TP
\fB\-c\fR \fIFILE\fR
بارگذاری تنظیمات از فایل پیکربندی مشخص‌شده.
.TP
\fB\-g\fR \fIR\fB:\fIG\fB:\fIB\fR
اصلاح گامای اضافی برای اعمال.
.TP
\fB\-l\fR \fILAT\fB:\fILON\fR
موقعیت مکانی فعلی شما بر حسب درجه، به صورت اعداد ممیز شناور به سمت شمال و شرق، که اعداد منفی به ترتیب نشان‌دهنده جنوب و غرب هستند.
.TP
\fB\-l\fR \fIPROVIDER\fR[\fB:\fIOPTIONS\fR]
انتخاب ارائه‌دهنده برای به‌روزرسانی خودکار موقعیت مکانی
(برای مشاهده ارائه‌دهندگان موجود از \fB"\-l list"\fR استفاده کنید).
.TP
\fB\-m\fR \fIMETHOD\fR[\fB:\fIOPTIONS\fR]
روش مورد استفاده برای تنظیم دمای رنگ
(برای مشاهده روش‌های موجود از \fB"\-m list"\fR استفاده کنید).
.TP
\fB\-o\fR
حالت تک‌باره (عدم تنظیم مداوم دمای رنگ). از این گزینه به همراه گزینه
.B \-P
برای پاک کردن رمپ‌های گامای موجود پیش از اعمال دمای رنگ جدید استفاده کنید.
.TP
\fB\-O\fR \fITEMP\fR
حالت دستی تک‌باره (تنظیم دمای رنگ). از این گزینه به همراه گزینه
.B \-P
برای پاک کردن رمپ‌های گامای موجود پیش از اعمال دمای رنگ جدید استفاده کنید.
.TP
\fB\-p\fR
حالت چاپ (فقط چاپ پارامترها و خروج).
.TP
\fB\-P\fR
بازنشانی رمپ‌های گامای موجود پیش از اعمال اثر رنگ جدید.
.TP
\fB\-x\fR
حالت بازنشانی (حذف تنظیمات و اثر اعمال‌شده از صفحه نمایش).
.TP
\fB\-r\fR
غیرفعال کردن محوشدگی تدریجی (fading) بین دماهای رنگ.
.TP
\fB\-t\fR \fIDAY\fB:\fINIGHT\fR
دمای رنگ برای تنظیم در روز/شب.
.PP
دمای رنگ خنثی ۶۵۰۰ کلوین (6500K) است. استفاده از این مقدار، دمای رنگ صفحه نمایش را تغییر نخواهد داد. تنظیم دمای رنگ روی مقداری بالاتر از این باعث نور آبی بیشتر می‌شود و تنظیم مقدار کمتر، نور قرمز بیشتری را در پی خواهد داشت.
.PP
مقادیر دمای پیش‌فرض:
.IP
روز: 6500K، شب: 4500K
.SH "فایل پیکربندی (CONFIGURATION FILE)"
یک فایل پیکربندی با نام \fIredshift.conf\fR می‌تواند به صورت اختیاری در پوشه \fI~/.config/\fR قرار گیرد. این فایل ساختار استاندارد INI دارد. گزینه‌های عمومی برنامه زیر سربرگ \fBredshift\fR قرار می‌گیرند، در حالی که گزینه‌های مربوط به ارائه‌دهندگان موقعیت مکانی و روش‌های تنظیم، زیر سربرگی با نام همان ارائه‌دهنده یا روش قرار داده می‌شوند. گزینه‌های عمومی عبارتند از:
.TP
\fBtemp\-day\fR = \fIinteger\fR
دمای روز
.TP
\fBtemp\-night\fR = \fIinteger\fR
دمای شب
.TP
\fBfade\fR = \fI0 or 1\fR
غیرفعال یا فعال کردن محوشدگی تدریجی میان دماهای رنگ هنگام شروع یا توقف Redshift
.TP
\fBbrightness\-day\fR = \fI0.1\-1.0\fR
روشنایی صفحه نمایش در طول روز
.TP
\fBbrightness\-night\fR = \fI0.1\-1.0\fR
روشنایی صفحه نمایش در طول شب
.TP
\fBelevation-high\fR = \fIdecimal\fR
ارتفاع خورشید بر حسب درجه برای گذار به روز
.TP
\fBelevation-low\fR = \fIdecimal\fR
ارتفاع خورشید بر حسب درجه برای گذار به شب
.TP
\fBdawn-time\fR = \fIHH\fB:\fIMM\fR[\fB\-\fIHH\fB:\fIMM\fR]
بازه زمانی سفارشی برای گذار از شب به روز در بامداد. در صورت تعیین، برای تشخیص دوره روز یا شب از ارتفاع خورشید استفاده نخواهد شد. در صورت تنظیم این گزینه، dusk-time نیز باید مشخص شود.
.TP
\fBdusk-time\fR = \fIHH\fB:\fIMM\fR[\fB\-\fIHH\fB:\fIMM\fR]
بازه زمانی سفارشی برای گذار از روز به شب در غروب. در صورت تعیین، برای تشخیص دوره روز یا شب از ارتفاع خورشید استفاده نخواهد شد. در صورت تنظیم این گزینه، dawn-time نیز باید مشخص شود.
.TP
\fBgamma\fR = \fIR\fB:\fIG\fB:\fIB\fR
تنظیم گاما برای اعمال (روز و شب)
.TP
\fBgamma-day\fR = \fIR\fB:\fIG\fB:\fIB\fR
تنظیم گاما برای اعمال در طول روز
.TP
\fBgamma-night\fR = \fIR\fB:\fIG\fB:\fIB\fR
تنظیم گاما برای اعمال در طول شب
.TP
\fBadjustment\-method\fR = \fIname\fR
انتخاب روش تنظیم. گزینه‌های مربوط به روش تنظیم را می‌توان زیر سربرگی به همین نام در فایل پیکربندی وارد کرد.
.TP
\fBlocation\-provider\fR = \fIname\fR
انتخاب ارائه‌دهنده موقعیت مکانی. گزینه‌های مربوط به ارائه‌دهنده موقعیت را می‌توان زیر سربرگی به همین نام در فایل پیکربندی وارد کرد.
.PP
گزینه‌های مربوط به ارائه‌دهندگان موقعیت مکانی و روش‌های تنظیم را می‌توان در خروجی راهنمای همان ارائه‌دهنده‌ها و روش‌ها پیدا کرد.
.SH "مثال‌ها (EXAMPLES)"
مثال برای کپنهاگ، دانمارک:
.IP
\fB$\fR redshift \-l 55.7:12.6 \-t 5700:3600 \-g 0.8 \-m randr \-v
.PP
یک نمونه فایل پیکربندی با همان اثر خط فرمان بالا:
.IP
.nf
[\fBredshift\fR]
temp\-day=5700
temp\-night=3600
gamma=0.8
adjustment\-method=randr
location\-provider=manual

[\fBmanual\fR]
lat=55.7
lon=12.6
.fi
.SH "قلاب‌ها (HOOKS)"
فایل‌های اجرایی (مانند اسکریپت‌ها) که در پوشه \fI~/.config/redshift/hooks\fR قرار داده می‌شوند، با رخ دادن رویدادی خاص اجرا خواهند شد. پارامتر اول ارسالی به اسکریپت، نشان‌دهنده رویداد است و پارامترهای بعدی ممکن است جزئیات بیشتری درباره رویداد ارائه دهند. رویداد \fBperiod-changed\fR هنگامی ارسال می‌شود که دوره زمانی تغییر کند (\fBnight\fR، \fBdaytime\fR، \fBtransition\fR). پارامتر دوم دوره قبلی و پارامتر سوم دوره جدید است. این رویداد همچنین هنگام شروع به کار Redshift ارسال می‌شود که در آن، دوره قبلی برابر با \fBnone\fR خواهد بود. از فایل‌های نقطه‌دار (dotfiles) موجود در این پوشه صرف‌نظر می‌شود.
.PP
یک اسکریپت ساده برای مدیریت این رویدادها را می‌توان به این صورت نوشت:
.IP
.nf
#!/bin/sh
case \fB$1\fR in
    \fBperiod-changed\fR)
        exec notify-send "Redshift" "Period changed to \fB$3\fR"
esac
.fi
.SH "نویسندگان (AUTHORS)"
.B redshift
توسط Jon Lund Steffensen <jonlst@gmail.com> نوشته شده است.
.PP
هم
.B redshift
و هم این صفحه راهنما تحت مجوز عمومی گنو (GNU General Public License) نسخه ۳ منتشر شده‌اند.
.SH "اشکالات (BUGS)"
لطفاً اشکالات را به <https://github.com/jonls/redshift/issues> گزارش دهید.
.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"
.B redshift
هنگامی که درایور گرافیک شما برای استفاده از نشانگرهای سخت‌افزاری (hardware cursors) پیکربندی شده باشد، بر رنگ نشانگر ماوس تأثیری نخواهد گذاشت. برخی از درایورهای گرافیک گزینه‌ای برای غیرفعال کردن نشانگرهای سخت‌افزاری دارند.