نام (NAME)

xclock - ساعت آنالوگ / دیجیتال برای X

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

xclock [ -help | -version ] [ -analog | -analog24 | -digital ] [ -brief ] [ -chime ]
    [ -hd color ] [ -hl color ] [ -update seconds ] [ -strftime format ]
    [ -twelve | -twentyfour | -utime ] [ -padding number ]
    [ -norender ] [ -render ] [ -sharp ] [ -proportional ] [ -face pattern ]

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

Xclock تمام گزینه‌های استاندارد خط فرمان X Toolkit را به همراه گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد:

-help: این گزینه مشخص می‌کند که خلاصه‌ای کوتاه از گزینه‌های مجاز باید در خروجی خطای استاندارد چاپ شود.
-analog: این گزینه مشخص می‌کند که باید از صفحه ساعت ۱۲ ساعته مرسوم با نشانگرها و عقربه‌ها استفاده شود. این حالت پیش‌فرض است.
-analog24: این گزینه مشخص می‌کند که باید از صفحه ساعت ۲۴ ساعته غیرمرسوم با نشانگرها و عقربه‌ها استفاده شود. (این گزینه مستلزم -analog است.) این حالت پیش‌فرض نیست.
-digital یا -d: این گزینه مشخص می‌کند که باید از یک ساعت دیجیتال ۲۴ ساعته استفاده شود.
-brief: این گزینه مشخص می‌کند که ساعت دیجیتال فقط باید فیلدهای ساعت و دقیقه را نمایش دهد. حالت پیش‌فرض نمایش اطلاعات کامل زمان و تاریخ است.
-utime: این گزینه مشخص می‌کند که ساعت دیجیتال باید ثانیه‌های سپری‌شده از مبدأ زمانی Epoch را (در قالب '970012340 seconds since Epoch' به جای زمان استاندارد ۲۴ ساعته) نمایش دهد.
-strftime format: این گزینه امکان مشخص کردن یک رشته قالب‌بندی strftime(3) را برای نمایش ساعت دیجیتال فراهم می‌کند.
-twelve: این گزینه مشخص می‌کند که ساعت دیجیتال باید زمان را در قالب دوازده‌ساعته نمایش دهد. این گزینه فقط برای حالت نمایش کوتاه مؤثر است.
-twentyfour: این گزینه مشخص می‌کند که ساعت دیجیتال باید زمان را در قالب بیست‌وچهار ساعته نمایش دهد. این گزینه فقط برای حالت نمایش کوتاه مؤثر است. هنگامی که ساعت دیجیتال استفاده می‌شود، این حالت پیش‌فرض است.
-chime: این گزینه مشخص می‌کند که ساعت باید در نیم‌ساعت یک بار و در رأس ساعت دو بار زنگ بزند.
-hands color (یا -hd color): این گزینه رنگ عقربه‌ها را در یک ساعت آنالوگ مشخص می‌کند. مقدار پیش‌فرض black است. هنگامی که Xrender در حال استفاده باشد، این گزینه عملاً نادیده گرفته می‌شود.
-highlight color (یا -hl color): این گزینه رنگ لبه‌های عقربه‌ها را در یک ساعت آنالوگ مشخص می‌کند و فقط در نمایشگرهای رنگی کاربرد دارد. مقدار پیش‌فرض black است. هنگامی که Xrender در حال استفاده باشد، این گزینه عملاً نادیده گرفته می‌شود.
-update seconds: این گزینه بسامد به‌روزرسانی صفحه نمایش توسط xclock را بر حسب ثانیه مشخص می‌کند. اگر پنجره ساعت پوشانده شده و سپس دوباره نمایان شود، فوراً به‌روزرسانی خواهد شد. مقداری برابر با ۳۰ ثانیه یا کمتر، عقربه ثانیه‌شمار را در ساعت آنالوگ فعال خواهد کرد. مقدار پیش‌فرض ۶۰ ثانیه است.
-padding number: این گزینه عرض حاشیه خالی میان مرز پنجره و متن یا تصویر ساعت را بر حسب پیکسل مشخص می‌کند. مقدار پیش‌فرض در ساعت دیجیتال ۱۰ و در ساعت آنالوگ ۸ است.
-render: این گزینه به xclock می‌گوید که از افزونه Xrender برای رسم صفحه‌ای صاف‌شده (anti-aliased) استفاده کند. اگر xclock با پشتیبانی از Xrender کامپایل شده باشد، این حالت پیش‌فرض است. توجه داشته باشید که گزینه‌های انتخاب رنگ و منابع مورد استفاده هنگام فعال بودن Xrender با گزینه‌های استاندارد تفاوت دارند.
-norender: این گزینه استفاده از Xrender را برای رسم ساعت غیرفعال می‌کند.
-sharp: این گزینه به xclock می‌گوید هنگام رسم با استفاده از افزونه Xrender، از لبه‌های تیزتر استفاده کند.
-proportional: هنگام رسم با استفاده از افزونه Xrender، این گزینه به xclock می‌گوید که حتی در صورت مربع نبودن پنجره، ساعت را با ابعاد متناسب رسم کند.
-face pattern: این گزینه قلم مورد استفاده در حالت دیجیتال را هنگام استفاده از افزونه Xrender مشخص می‌کند. الگوها با استفاده از قالب نگارش فونت fontconfig که در بخش Font Names از fonts.conf(5) توصیف شده است، مشخص می‌شوند.
-version: این گزینه مشخص می‌کند که نسخه برنامه چاپ شود و سپس دستور بدون باز کردن پنجره ساعت خارج شود..SH "پیش‌فرض‌های اکس (X DEFAULTS)" این برنامه از ویجت Clock استفاده می‌کند. این ویجت علاوه بر موارد زیر، تمام نام‌ها و کلاس‌های منابع پایه (core resources) را درک می‌کند:
width (class Width): عرض ساعت را مشخص می‌کند. مقدار پیش‌فرض برای ساعت‌های عقربه‌ای (آنالوگ) ۱۶۴ پیکسل است؛ مقدار پیش‌فرض برای ساعت‌های دیجیتال به میزانی است که برای نگهداری ساعت هنگام نمایش با قلم انتخاب‌شده مورد نیاز است.
height (class Height): ارتفاع ساعت را مشخص می‌کند. مقدار پیش‌فرض برای ساعت‌های عقربه‌ای (آنالوگ) ۱۶۴ پیکسل است؛ مقدار پیش‌فرض برای ساعت‌های دیجیتال به میزانی است که برای نگهداری ساعت هنگام نمایش با قلم انتخاب‌شده مورد نیاز است.
update (class Interval): بسامد به‌روزرسانی و بازنمایش زمان را بر حسب ثانیه مشخص می‌کند.
foreground (class Foreground): رنگ نشانگرهای تیک (درجه‌بندی) را مشخص می‌کند. مقدار پیش‌فرض به این بستگی دارد که آیا reverseVideo مشخص شده باشد یا خیر. اگر reverseVideo مشخص شده باشد، مقدار پیش‌فرض lwhite است، در غیر این صورت مقدار پیش‌فرض black خواهد بود. توجه داشته باشید هنگامی که Xrender فعال است، از این منبع استفاده نمی‌شود.
hands (class Foreground): رنگ بخش درونی عقربه‌های ساعت را مشخص می‌کند. مقدار پیش‌فرض به این بستگی دارد که آیا reverseVideo مشخص شده باشد یا خیر. اگر reverseVideo مشخص شده باشد، مقدار پیش‌فرض lwhite است، در غیر این صورت مقدار پیش‌فرض black خواهد بود. توجه داشته باشید هنگامی که Xrender فعال است، از این منبع استفاده نمی‌شود.
highlight (class Foreground): رنگ مورد استفاده برای برجسته‌سازی عقربه‌های ساعت را مشخص می‌کند. مقدار پیش‌فرض به این بستگی دارد که آیا reverseVideo مشخص شده باشد یا خیر. اگر reverseVideo مشخص شده باشد، مقدار پیش‌فرض lwhite است، در غیر این صورت مقدار پیش‌فرض black خواهد بود. توجه داشته باشید هنگامی که Xrender فعال است، از این منبع استفاده نمی‌شود.
analog (class Boolean): مشخص می‌کند که آیا ساعت عقربه‌ای به جای ساعت دیجیتال استفاده شود یا خیر. مقدار پیش‌فرض True است.
analog24 (class Boolean): مشخص می‌کند که آیا ساعت عقربه‌ای ۲۴ ساعته به جای ساعت دیجیتال یا عقربه‌ای ۱۲ ساعته استفاده شود یا خیر. تنظیم آن روی True همچنین analog را روی True تنظیم می‌کند. مقدار پیش‌فرض False است.
twentyfour (class Boolean): مشخص می‌کند که آیا ساعت دیجیتال زمان را در قالب ۲۴ ساعته نمایش دهد یا خیر. مقدار پیش‌فرض True است.
chime (class Boolean): مشخص می‌کند که آیا در رأس هر ساعت و نیم‌ساعت زنگ به صدا درآید یا خیر.
padding (class Margin): میزان حاشیه درونی (padding) مورد استفاده را بر حسب پیکسل مشخص می‌کند. مقدار پیش‌فرض ۸ است.
font (class Font): قلم مورد استفاده برای ساعت دیجیتال را مشخص می‌کند. توجه داشته باشید که قلم‌های با عرض متغیر در حال حاضر ممکن است همیشه به درستی نمایش داده نشوند. این قلم فقط زمانی استفاده می‌شود که Xrender فعال نباشد.
render (class Boolean): مشخص می‌کند که آیا افزونه Xrender برای نمایش استفاده شود یا خیر. اگر xclock با پشتیبانی از Xrender کامپایل شده باشد، مقدار پیش‌فرض True است.

هنگامی که Xrender فعال باشد، منابع اضافی زیر نیز درک می‌شوند:

face (class FaceName): الگوی قلم مورد استفاده برای ساعت دیجیتال در صورت استفاده از Xrender را مشخص می‌کند. الگوها با استفاده از قالب چهره fontconfig که در بخش Font Names از fonts.conf(5) شرح داده شده است، تعیین می‌شوند.
sharp (class Boolean): مشخص می‌کند که آیا هنگام رندر کردن ساعت باید از لبه‌های تیز استفاده شود یا خیر. مقدار پیش‌فرض False است.
buffer (class Boolean): مشخص می‌کند که به‌روزرسانی‌های تصویر، به جای اینکه مستقیماً در پنجره رسم شوند، ابتدا روی یک pixmap رسم شده و سپس در پنجره کپی شوند.

مقادیر پیش‌فرض منابع رنگ زیر به این بستگی دارد که آیا reverseVideo مشخص شده باشد یا خیر. اگر reverseVideo مشخص شده باشد، مقدار پیش‌فرض lwhite است، در غیر این صورت مقدار پیش‌فرض black خواهد بود.

hourColor (class Foreground)

رنگ عقربه ساعت‌شمار.

minuteColor (class Foreground)

رنگ عقربه دقیقه‌شمار.

secondColor (class Foreground)

رنگ عقربه ثانیه‌شمار.

majorColor (class Foreground)

رنگ نشانگرهای اصلی درجه‌بندی (یعنی هر پنج دقیقه یا در صورت استفاده از -analog24، هر ۲٫۵ دقیقه).

minorColor (class Foreground)

رنگ نشانگرهای فرعی درجه‌بندی (بین نشانگرهای اصلی).

amColor (class Foreground)

رنگ نشانگر AM.

pmColor (class Foreground)

رنگ نشانگر PM.

fixed1Color (class Foreground)

رنگ عنصر ثابت ۱.

fixed2Color (class Foreground)

رنگ عنصر ثابت ۲.

fixed3Color (class Foreground)

رنگ عنصر ثابت ۳.

hourShape (class String)

شکل عقربه ساعت‌شمار.

شکل به صورت مجموعه‌ای از نقاط داده می‌شود که هر گروه سه‌تایی از نقطه‌ها، یک مثلث را توصیف می‌کند. یک نقطه می‌تواند به صورت (X, Y) مشخص شود که در آن (0, 0) در مرکز صفحه ساعت، (0, 100) در محیط بالایی هنگامی که عقربه رو به بالاست و (100, 0) در محیط سمت راست هنگامی که عقربه رو به بالاست قرار دارد. یک نقطه همچنین می‌تواند به صورت یک اندیس عدد صحیح داده شود که در آن 0 به نقطه نخست، -1 به نقطه پیشین و غیره اشاره دارد. در هر کجای بیرون از پرانتزها، می‌توانید دستگاه مختصات را تبدیل کنید که بر همهٔ مختصات پس از آن اثر می‌گذارد: rA دستگاه مختصات را در جهت عقربه‌های ساعت به اندازه زاویه A می‌چرخاند، wF / hF مختصات x / y را به ترتیب با ضریب F مقیاس‌بندی می‌کند، و xL / yL دستگاه مختصات را در امتداد x / y به ترتیب به اندازه طول L انتقال می‌دهد. یک رشته خالی چیزی را رندر نخواهد کرد.

minuteShape (class String)

شکل عقربه دقیقه‌شمار.

secondShape (class String)

شکل عقربه ثانیه‌شمار.

majorShape (class String)

شکل نشانگرهای اصلی درجه‌بندی (یعنی هر پنج دقیقه).

minorShape (class String)

شکل نشانگرهای فرعی درجه‌بندی (بین نشانگرهای اصلی).

amShape (class String)

شکل نشانگر AM.

pmShape (class String)

شکل نشانگر PM.

fixed1Shape (class String)

شکل عنصر ثابت ۱. عناصر ثابت نمی‌چرخند و به شما امکان می‌دهند صفحه ساعت را به صورت دلخواه طراحی کنید.

fixed2Shape (class String)

شکل عنصر ثابت ۲.

fixed3Shape (class String)

شکل عنصر ثابت ۳.

rotateAmpm (class Boolean)

اگر روی True باشد، نشانگرهای AM و PM را با همان سرعت عقربه ساعت‌شمار می‌چرخاند.

zOrder (class String)

رشته‌ای که ترتیب رندر شدن عناصر ساعت را توصیف می‌کند. هر نویسه یک عنصر از ساعت را به صورت زیر مشخص می‌کند:

T: نشانگرهای اصلی
t: نشانگرهای فرعی
1: عنصر ثابت ۱
2: عنصر ثابت ۲
3: عنصر ثابت ۳
a: نشانگر AM
p: نشانگر PM
h: عقربه ساعت‌شمار
m: عقربه دقیقه‌شمار
s: عقربه ثانیه‌شمار
proportional (class Boolean)
در صورت تنظیم روی درست (true)، حتی اگر پنجره مربع نباشد، یک ساعت متناسب ایجاد می‌کند.

ویجت‌ها (WIDGETS)

برای تعیین منابع (resources)، دانستن سلسله‌مراتب ویجت‌هایی که xclock را تشکیل می‌دهند مفید است. در نشانه‌گذاری زیر، تورفتگی نشان‌دهنده ساختار سلسله‌مراتبی است. ابتدا نام کلاس ویجت و سپس نام نمونهٔ (instance) ویجت آمده است.

XClock  xclock
        Clock  clock

نمونه استفاده از منابع X (EXAMPLE USE OF X RESOURCES)

به عنوان مثال، موارد زیر را به ~/.Xresources اضافه کنید:

XClock.Clock.width: 600
XClock.Clock.update: 0.1
XClock.Clock.foreground: #cc6050
XClock.Clock.analog: true
XClock.Clock.padding: 20
XClock.Clock.font: fixed
XClock.Clock.face: :pixelsize=50:antialias=true
XClock.Clock.majorColor: #cc6050
XClock.Clock.hourShape: (-5, 30) (0, 5) (0, 35) -2 -2 (5, 30) \
                        (-1, 37.5) (0, 38.5) (0, 36.5) -2 -2 (1, 37.5) \
                        (-1, 0) (0, 1) (0, -1) -2 -2 (1, 0)

سپس xrdb ~/.Xresources را اجرا کرده و xclock را آغاز کنید.

محیط (ENVIRONMENT)

DISPLAY: برای دریافت میزبان پیش‌فرض و شماره نمایشگر.
XENVIRONMENT: برای دریافت نام فایل منبعی که جایگزین منابع سراسری ذخیره‌شده در ویژگی RESOURCE_MANAGER می‌شود.

فایل‌ها (FILES)

/usr/share/X11/app-defaults/XClock: منابع مورد نیاز را مشخص می‌کند

همچنین ببینید (SEE ALSO)

xrdb(1), time(3), fonts.conf(5), X(7).

گزارش باگ‌ها (BUGS)

Xclock به ساعت سیستم اعتماد می‌کند.

در حالت دیجیتال، رشته متنی باید به صورت خودکار در مرکز تراز شود.

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

Tony Della Fera (MIT-Athena, DEC)
Dave Mankins (MIT-Athena, BBN)
Ed Moy (UC Berkeley)