REDSHIFT(1) General Commands Manual REDSHIFT(1) نام (NAME) redshift - تنظیم دمای رنگ صفحه نمایش بر اساس زمان روز خلاصه دستور (SYNOPSIS) redshift [-l LAT:LON | -l PROVIDER:OPTIONS] [-t DAY:NIGHT] [گزینه‌ها...] توضیحات (DESCRIPTION) دستور redshift دمای رنگ صفحه نمایش شما را بر اساس محیط اطرافتان تنظیم می‌کند. این کار ممکن است در صورت کار با صفحه نمایش در شب، به کاهش درد و خستگی چشم یا کاهش خطر ابتلا به سندرم تأخیر فاز خواب کمک کند. دمای رنگ بر اساس موقعیت خورشید تنظیم می‌شود. دمای رنگ متفاوتی در طول شب و روز تنظیم می‌گردد. در زمان گرگ‌ومیش و اوایل صبح، دمای رنگ به نرمی از دمای شب به روز تغییر می‌کند تا چشمان شما بتوانند در مدت حدود یک ساعت به آرامی با آن سازگار شوند. در شب دمای رنگ باید به گونه‌ای تنظیم شود که با لامپ‌های اتاق شما هماهنگ باشد. این مقدار معمولاً دمای پایینی در حدود ۳۰۰۰K تا ۴۰۰۰K است (پیش‌فرض ۴۵۰۰K است). در طول روز، دمای رنگ باید با نور بیرون هماهنگ باشد که معمولاً حدود ۵۵۰۰K تا ۶۵۰۰K است (پیش‌فرض ۶۵۰۰K است). نور در یک روز ابری دمای بالاتری دارد. علاوه بر ابزار خط فرمان redshift، رابط گرافیکی redshift-gtk رابط کاربری جایگزینی را فراهم می‌کند که به صورت یک آیکون اعلان در محیط دسکتاپ نمایش داده می‌شود. گزینه‌ها (OPTIONS) -h نمایش پیام راهنما. -v فعال کردن خروجی با جزئیات کامل (verbose). -V نمایش نسخه برنامه. -b DAY:NIGHT روشنایی صفحه نمایش برای اعمال (بین 0.1 و 1.0). -c FILE بارگذاری تنظیمات از فایل پیکربندی مشخص‌شده. -g R:G:B اصلاح گامای اضافی برای اعمال. -l LAT:LON موقعیت مکانی فعلی شما بر حسب درجه، به صورت اعداد ممیز شناور به سمت شمال و شرق، که اعداد منفی به ترتیب نشان‌دهنده جنوب و غرب هستند. -l PROVIDER[:OPTIONS] انتخاب ارائه‌دهنده برای به‌روزرسانی خودکار موقعیت مکانی (برای مشاهده ارائه‌دهندگان موجود از "-l list" استفاده کنید). -m METHOD[:OPTIONS] روش مورد استفاده برای تنظیم دمای رنگ (برای مشاهده روش‌های موجود از "-m list" استفاده کنید). -o حالت تک‌باره (عدم تنظیم مداوم دمای رنگ). از این گزینه به همراه گزینه -P برای پاک کردن رمپ‌های گامای موجود پیش از اعمال دمای رنگ جدید استفاده کنید. -O TEMP حالت دستی تک‌باره (تنظیم دمای رنگ). از این گزینه به همراه گزینه -P برای پاک کردن رمپ‌های گامای موجود پیش از اعمال دمای رنگ جدید استفاده کنید. -p حالت چاپ (فقط چاپ پارامترها و خروج). -P بازنشانی رمپ‌های گامای موجود پیش از اعمال اثر رنگ جدید. -x حالت بازنشانی (حذف تنظیمات و اثر اعمال‌شده از صفحه نمایش). -r غیرفعال کردن محوشدگی تدریجی (fading) بین دماهای رنگ. -t DAY:NIGHT دمای رنگ برای تنظیم در روز/شب. دمای رنگ خنثی ۶۵۰۰ کلوین (6500K) است. استفاده از این مقدار، دمای رنگ صفحه نمایش را تغییر نخواهد داد. تنظیم دمای رنگ روی مقداری بالاتر از این باعث نور آبی بیشتر می‌شود و تنظیم مقدار کمتر، نور قرمز بیشتری را در پی خواهد داشت. مقادیر دمای پیش‌فرض: روز: 6500K، شب: 4500K فایل پیکربندی (CONFIGURATION FILE) یک فایل پیکربندی با نام redshift.conf می‌تواند به صورت اختیاری در پوشه ~/.config/ قرار گیرد. این فایل ساختار استاندارد INI دارد. گزینه‌های عمومی برنامه زیر سربرگ redshift قرار می‌گیرند، در حالی که گزینه‌های مربوط به ارائه‌دهندگان موقعیت مکانی و روش‌های تنظیم، زیر سربرگی با نام همان ارائه‌دهنده یا روش قرار داده می‌شوند. گزینه‌های عمومی عبارتند از: temp-day = integer دمای روز temp-night = integer دمای شب fade = 0 or 1 غیرفعال یا فعال کردن محوشدگی تدریجی میان دماهای رنگ هنگام شروع یا توقف Redshift brightness-day = 0.1-1.0 روشنایی صفحه نمایش در طول روز brightness-night = 0.1-1.0 روشنایی صفحه نمایش در طول شب elevation-high = decimal ارتفاع خورشید بر حسب درجه برای گذار به روز elevation-low = decimal ارتفاع خورشید بر حسب درجه برای گذار به شب dawn-time = HH:MM[-HH:MM] بازه زمانی سفارشی برای گذار از شب به روز در بامداد. در صورت تعیین، برای تشخیص دوره روز یا شب از ارتفاع خورشید استفاده نخواهد شد. در صورت تنظیم این گزینه، dusk-time نیز باید مشخص شود. dusk-time = HH:MM[-HH:MM] بازه زمانی سفارشی برای گذار از روز به شب در غروب. در صورت تعیین، برای تشخیص دوره روز یا شب از ارتفاع خورشید استفاده نخواهد شد. در صورت تنظیم این گزینه، dawn-time نیز باید مشخص شود. gamma = R:G:B تنظیم گاما برای اعمال (روز و شب) gamma-day = R:G:B تنظیم گاما برای اعمال در طول روز gamma-night = R:G:B تنظیم گاما برای اعمال در طول شب adjustment-method = name انتخاب روش تنظیم. گزینه‌های مربوط به روش تنظیم را می‌توان زیر سربرگی به همین نام در فایل پیکربندی وارد کرد. location-provider = name انتخاب ارائه‌دهنده موقعیت مکانی. گزینه‌های مربوط به ارائه‌دهنده موقعیت را می‌توان زیر سربرگی به همین نام در فایل پیکربندی وارد کرد. گزینه‌های مربوط به ارائه‌دهندگان موقعیت مکانی و روش‌های تنظیم را می‌توان در خروجی راهنمای همان ارائه‌دهنده‌ها و روش‌ها پیدا کرد. مثال‌ها (EXAMPLES) مثال برای کپنهاگ، دانمارک: $ redshift -l 55.7:12.6 -t 5700:3600 -g 0.8 -m randr -v یک نمونه فایل پیکربندی با همان اثر خط فرمان بالا: [redshift] temp-day=5700 temp-night=3600 gamma=0.8 adjustment-method=randr location-provider=manual [manual] lat=55.7 lon=12.6 قلاب‌ها (HOOKS) فایل‌های اجرایی (مانند اسکریپت‌ها) که در پوشه ~/.config/redshift/hooks قرار داده می‌شوند، با رخ دادن رویدادی خاص اجرا خواهند شد. پارامتر اول ارسالی به اسکریپت، نشان‌دهنده رویداد است و پارامترهای بعدی ممکن است جزئیات بیشتری درباره رویداد ارائه دهند. رویداد period-changed هنگامی ارسال می‌شود که دوره زمانی تغییر کند (night، daytime، transition). پارامتر دوم دوره قبلی و پارامتر سوم دوره جدید است. این رویداد همچنین هنگام شروع به کار Redshift ارسال می‌شود که در آن، دوره قبلی برابر با none خواهد بود. از فایل‌های نقطه‌دار (dotfiles) موجود در این پوشه صرف‌نظر می‌شود. یک اسکریپت ساده برای مدیریت این رویدادها را می‌توان به این صورت نوشت: #!/bin/sh case $1 in period-changed) exec notify-send "Redshift" "Period changed to $3" esac نویسندگان (AUTHORS) redshift توسط Jon Lund Steffensen نوشته شده است. هم redshift و هم این صفحه راهنما تحت مجوز عمومی گنو (GNU General Public License) نسخه ۳ منتشر شده‌اند. اشکالات (BUGS) لطفاً اشکالات را به گزارش دهید. مشکلات شناخته‌شده (KNOWN ISSUES) redshift هنگامی که درایور گرافیک شما برای استفاده از نشانگرهای سخت‌افزاری (hardware cursors) پیکربندی شده باشد، بر رنگ نشانگر ماوس تأثیری نخواهد گذاشت. برخی از درایورهای گرافیک گزینه‌ای برای غیرفعال کردن نشانگرهای سخت‌افزاری دارند. REDSHIFT(1)