.TH REDSHIFT 1
.SH "نام (NAME)"
gammastep \- تنظیم دمای رنگ صفحه نمایش با توجه به زمان روز
.SH "خلاصه دستور (SYNOPSIS)"
.B gammastep
\fR[\fB\-l\fR \fILAT\fB:\fILON\fR | \fB\-l\fR \fIPROVIDER\fB:\fIOPTIONS\fR] [\fB\-t\fR \fIDAY\fB:\fINIGHT\fR] [\fIOPTIONS\fR...]
.SH "توضیحات (DESCRIPTION)"
.B gammastep
دمای رنگ صفحه نمایش شما را با توجه به محیط اطرافتان تنظیم می‌کند. این کار ممکن است در صورت کار در برابر صفحه نمایش در شب، به کاهش خستگی چشم‌ها یا کاهش خطر ابتلا به سندرم فاز خواب با تأخیر کمک کند.
.PP
دمای رنگ بر اساس موقعیت خورشید تنظیم می‌شود. دمای رنگ متفاوتی در طول شب و روز تعیین می‌گردد. در هنگام گرگ‌ومیش و اوایل صبح، دمای رنگ به آرامی و پیوسته در یک دوره زمانی حدوداً یک‌ساعته از دمای شب به روز تغییر می‌یابد تا به چشمان شما امکان دهد به آرامی سازگار شوند. در شب دمای رنگ باید طوری تنظیم شود که با لامپ‌های اتاق شما هماهنگ باشد؛ این معمولاً دمای پایینی در حدود 3000K تا 4000K است (پیش‌فرض 4500K است). در طول روز، دمای رنگ باید با نور بیرون هماهنگ باشد، معمولاً در حدود 5500K تا 6500K (پیش‌فرض 6500K است). نور در یک روز ابری دمای بالاتری دارد.
.PP
علاوه بر ابزار خط فرمانی \fBgammastep\fR، ابزار گرافیکی \fBgammastep-indicator\fR یک رابط جایگزین فراهم می‌کند که به صورت یک نماد اعلان در محیط میزکار نمایش می‌یابد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-h\fR
نمایش پیام راهنما.
.TP
\fB\-v\fR
فعال کردن خروجی با جزئیات کامل.
.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
حالت یک‌باره (عدم تنظیم پیوسته دمای رنگ). از این گزینه به همراه گزینه \fB\-P\fR برای پاک کردن شیب‌های گامای موجود پیش از اعمال دمای رنگ جدید استفاده کنید.
.TP
\fB\-O\fR \fITEMP\fR
حالت دستی یک‌باره (تنظیم مستقیم دمای رنگ). از این گزینه به همراه گزینه \fB\-P\fR برای پاک کردن شیب‌های گامای موجود پیش از اعمال دمای رنگ جدید استفاده کنید.
.TP
\fB\-p\fR
حالت چاپ (تنها پارامترها چاپ شده و خارج می‌شود).
.TP
\fB\-P\fR
بازنشانی شیب‌های گامای موجود پیش از اعمال جلوه رنگ جدید.
.TP
\fB\-x\fR
حالت بازنشانی (حذف تغییرات و بازگرداندن وضعیت صفحه).
.TP
\fB\-r\fR
غیرفعال کردن تغییر تدریجی (fade) بین دماهای رنگ.
.TP
\fB\-t\fR \fIDAY\fB:\fINIGHT\fR
دمای رنگ برای تنظیم در طول روز/شب.
.PP
دمای خنثی 6500K است. استفاده از این مقدار، دمای رنگ صفحه نمایش را تغییر نخواهد داد. تنظیم دمای رنگ روی مقداری بالاتر از این مقدار به نور آبی بیشتر، و تنظیم مقدار کمتر به نور قرمز بیشتر منجر می‌شود.
.PP
مقادیر دمای پیش‌فرض:
.IP
روز: 6500K، شب: 4500K
.SH "فایل پیکربندی (CONFIGURATION FILE)"
یک فایل پیکربندی با نام \fIconfig.ini\fR را می‌توان به صورت اختیاری در \fI~/.config/gammastep/\fR (اگر متغیر محیطی XDG_CONFIG_HOME تعریف نشده باشد) یا در \fI${XDG_CONFIG_HOME}/gammastep/\fR (اگر XDG_CONFIG_HOME تعریف شده باشد) قرار داد. این فایل دارای قالب استاندارد INI است. گزینه‌های عمومی برنامه زیر عنوان \fBgeneral\fR قرار می‌گیرند، در حالی که گزینه‌های ارائه‌دهندگان موقعیت مکانی و روش‌های تنظیم زیر سرآیندی به نام همان ارائه‌دهنده یا روش درج می‌شوند. گزینه‌های عمومی عبارتند از:
.TP
\fBtemp\-day\fR = \fIinteger\fR
دمای رنگ در طول روز
.TP
\fBtemp\-night\fR = \fIinteger\fR
دمای رنگ در شب
.TP
\fBfade\fR = \fI0 or 1\fR
غیرفعال یا فعال کردن تغییر تدریجی میان دماهای رنگ.
.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 "مثال (EXAMPLE)"
نمونه‌ای برای کپنهاگ، دانمارک:
.IP
\fB$\fR gammastep \-l 55.7:12.6 \-t 5700:3600 \-g 0.8 \-m randr \-v
.PP
نمونه‌ای از فایل پیکربندی با اثری مشابه دستور خط فرمان بالا:
.IP
.nf
[\fBgeneral\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/gammastep/hooks\fR قرار داده شوند، هنگام رخ دادن رویدادی خاص اجرا خواهند شد. نخستین پارامتر ارسالی به اسکریپت نشان‌دهنده رویداد است و پارامترهای بعدی ممکن است جزئیات بیشتری درباره رویداد ارائه دهند. رویداد \fBperiod-changed\fR هنگامی ارسال می‌شود که دوره زمانی تغییر کند (\fBnight\fR، \fBdaytime\fR، \fBtransition\fR). پارامتر دوم دوره قبلی و پارامتر سوم دوره جدید است. این رویداد در هنگام راه‌اندازی نیز ارسال می‌شود که در آن زمان دوره قبلی روی \fBnone\fR تنظیم شده است. فایل‌های نقطه‌دار (dotfiles) در این پوشه نادیده گرفته می‌شوند.
.PP
یک اسکریپت ساده برای مدیریت این رویدادها را می‌توان به این صورت نوشت:
.IP
.nf
#!/bin/sh
case \fB$1\fR in
    \fBperiod-changed\fR)
        exec notify-send "Gammastep" "Period changed to \fB$3\fR"
esac
.fi
.SH "نویسنده (AUTHOR)"
.B gammastep
توسط Jon Lund Steffensen <jonlst@gmail.com> نوشته شده است،
و اکنون توسط Cameron Nemo <cam@nohom.org> نگهداری می‌شود.
.PP
هم
.B gammastep
و هم این صفحه راهنما تحت مجوز عمومی گنو (GNU General Public License) نسخه ۳ منتشر شده‌اند.
.SH "اشکالات (BUGS)"
لطفاً اشکالات را به نشانی <https://gitlab.freedesktop.org/CameronNemo/gammastep/issues> گزارش دهید
.SH "مسائل شناخته‌شده (KNOWN ISSUES)"
.B gammastep
هنگامی که درایور گرافیک شما برای استفاده از مکان‌نماهای سخت‌افزاری پیکربندی شده باشد، بر رنگ مکان‌نمای شما تأثیری نخواهد گذاشت. برخی درایورهای گرافیکی گزینه‌ای برای غیرفعال کردن مکان‌نماهای سخت‌افزاری دارند.