.\" $Xorg: xclock.man,v 1.4 2001/02/09 02:05:39 xorgcvs Exp $
.\" Copyright 1988, 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.\" $XFree86: xc/programs/xclock/xclock.man,v 1.15 2003/07/04 16:24:30 eich Exp $
.\"
.TH XCLOCK 1 2025-05-18 "xclock 1.2.1" "X Version 11"
.SH "نام (NAME)"
xclock \- ساعت آنالوگ / دیجیتال برای X
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBxclock\fP [ \fB\-help\fP | \fB\-version\fP ] [ \fB\-analog\fP | \fB\-analog24\fP | \fB\-digital\fP ] \
[ \fB\-brief\fP ] [ \fB\-chime\fP ]
    [ \fB\-hd\fP \fIcolor\fP ] [ \fB\-hl\fP \fIcolor\fP ] \
[ \fB\-update\fP \fIseconds\fP ] [ \fB\-strftime\fP \fIformat\fP ]
    [ \fB\-twelve\fP | \fB-twentyfour\fP | \fB-utime\fP ] \
[ \fB\-padding\fP \fInumber\fP ]
    [ \fB\-norender\fP ] [ \fB\-render\fP ] [ \fB\-sharp\fP ] [ \fB\-proportional\fP ] \
[ \fB\-face\fP \fIpattern\fP ]
.fi
.SH "توضیحات (DESCRIPTION)"
برنامه
.B xclock
زمان را به صورت آنالوگ یا دیجیتال نمایش می‌دهد.
زمان به طور پیوسته در بسامدی که می‌تواند توسط کاربر مشخص شود به‌روزرسانی می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.B Xclock
تمام گزینه‌های استاندارد خط فرمان X Toolkit را به همراه گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد:
.TP 8
.B \-help
این گزینه مشخص می‌کند که خلاصه‌ای کوتاه از گزینه‌های مجاز باید در خروجی خطای استاندارد چاپ شود.
.TP 8
.B \-analog
این گزینه مشخص می‌کند که باید از صفحه ساعت ۱۲ ساعته مرسوم با نشانگرها و عقربه‌ها استفاده شود.
این حالت پیش‌فرض است.
.TP 8
.B \-analog24
این گزینه مشخص می‌کند که باید از صفحه ساعت ۲۴ ساعته غیرمرسوم با نشانگرها و عقربه‌ها استفاده شود. (این گزینه مستلزم \fB-analog\fP است.) این حالت پیش‌فرض نیست.
.TP 8
\fB\-digital\fP یا \fB\-d\fP
این گزینه مشخص می‌کند که باید از یک ساعت دیجیتال ۲۴ ساعته استفاده شود.
.TP 8
\fB\-brief\fP
این گزینه مشخص می‌کند که ساعت دیجیتال فقط باید فیلدهای ساعت و دقیقه را نمایش دهد.
حالت پیش‌فرض نمایش اطلاعات کامل زمان و تاریخ است.
.TP 8
\fB\-utime\fP
این گزینه مشخص می‌کند که ساعت دیجیتال باید ثانیه‌های سپری‌شده از مبدأ زمانی Epoch را (در قالب \(aq970012340 seconds since Epoch\(aq به جای زمان استاندارد ۲۴ ساعته) نمایش دهد.
.TP 8
.B \-strftime \fIformat\fP
این گزینه امکان مشخص کردن یک رشته قالب‌بندی
.BR strftime ( 3)
را برای نمایش ساعت دیجیتال فراهم می‌کند.
.TP 8
.B \-twelve
این گزینه مشخص می‌کند که ساعت دیجیتال باید زمان را در قالب دوازده‌ساعته نمایش دهد.
این گزینه فقط برای حالت نمایش کوتاه مؤثر است.
.TP 8
.B \-twentyfour
این گزینه مشخص می‌کند که ساعت دیجیتال باید زمان را در قالب بیست‌وچهار ساعته نمایش دهد.
این گزینه فقط برای حالت نمایش کوتاه مؤثر است.
هنگامی که ساعت دیجیتال استفاده می‌شود، این حالت پیش‌فرض است.
.TP 8
.B \-chime
این گزینه مشخص می‌کند که ساعت باید در نیم‌ساعت یک بار و در رأس ساعت دو بار زنگ بزند.
.TP 8
\fB\-hands\fP \fIcolor\fP (یا \fB\-hd\fP \fIcolor\fP)
این گزینه رنگ عقربه‌ها را در یک ساعت آنالوگ مشخص می‌کند.
مقدار پیش‌فرض \fBblack\fP است.
هنگامی که Xrender در حال استفاده باشد، این گزینه عملاً نادیده گرفته می‌شود.
.TP 8
\fB\-highlight\fP \fIcolor\fP (یا \fB\-hl\fP \fIcolor\fP)
این گزینه رنگ لبه‌های عقربه‌ها را در یک ساعت آنالوگ مشخص می‌کند و فقط در نمایشگرهای رنگی کاربرد دارد.
مقدار پیش‌فرض \fBblack\fP است.
هنگامی که Xrender در حال استفاده باشد، این گزینه عملاً نادیده گرفته می‌شود.
.TP 8
.B \-update \fIseconds\fP
این گزینه بسامد به‌روزرسانی صفحه نمایش توسط \fBxclock\fP را بر حسب ثانیه مشخص می‌کند.
اگر پنجره ساعت پوشانده شده و سپس دوباره نمایان شود، فوراً به‌روزرسانی خواهد شد.
مقداری برابر با ۳۰ ثانیه یا کمتر، عقربه ثانیه‌شمار را در ساعت آنالوگ فعال خواهد کرد.
مقدار پیش‌فرض ۶۰ ثانیه است.
.TP 8
.B \-padding \fInumber\fP
این گزینه عرض حاشیه خالی میان مرز پنجره و متن یا تصویر ساعت را بر حسب پیکسل مشخص می‌کند.
مقدار پیش‌فرض در ساعت دیجیتال ۱۰ و در ساعت آنالوگ ۸ است.
.TP 8
.B \-render
این گزینه به \fBxclock\fP می‌گوید که از افزونه Xrender برای رسم صفحه‌ای صاف‌شده (anti-aliased) استفاده کند.
اگر \fBxclock\fP با پشتیبانی از Xrender کامپایل شده باشد، این حالت پیش‌فرض است.
توجه داشته باشید که گزینه‌های انتخاب رنگ و منابع مورد استفاده هنگام فعال بودن Xrender با گزینه‌های استاندارد تفاوت دارند.
.TP 8
.B \-norender
این گزینه استفاده از Xrender را برای رسم ساعت غیرفعال می‌کند.
.TP 8
.B \-sharp
این گزینه به \fBxclock\fP می‌گوید هنگام رسم با استفاده از افزونه Xrender، از لبه‌های تیزتر استفاده کند.
.TP 8
.B \-proportional
هنگام رسم با استفاده از افزونه Xrender، این گزینه به \fIxclock\fP می‌گوید که حتی در صورت مربع نبودن پنجره، ساعت را با ابعاد متناسب رسم کند.
.TP 8
.B \-face \fIpattern\fP
این گزینه قلم مورد استفاده در حالت دیجیتال را هنگام استفاده از افزونه Xrender مشخص می‌کند.
الگوها با استفاده از قالب نگارش فونت fontconfig که در بخش
.I Font Names
از
.BR fonts.conf (5)
توصیف شده است، مشخص می‌شوند.
.TP 8
.B \-version
این گزینه مشخص می‌کند که نسخه برنامه چاپ شود و سپس دستور بدون باز کردن پنجره ساعت خارج شود..SH "پیش‌فرض‌های اکس (X DEFAULTS)"
این برنامه از ویجت
.B Clock
استفاده می‌کند.
این ویجت علاوه بر موارد زیر، تمام نام‌ها و کلاس‌های منابع پایه (core resources) را درک می‌کند:
.TP 8
.B width (\fPclass\fB Width)
عرض ساعت را مشخص می‌کند.
مقدار پیش‌فرض برای ساعت‌های عقربه‌ای (آنالوگ) ۱۶۴ پیکسل است؛
مقدار پیش‌فرض برای ساعت‌های دیجیتال به میزانی است که برای نگهداری ساعت هنگام نمایش با قلم انتخاب‌شده مورد نیاز است.
.TP 8
.B height (\fPclass\fB Height)
ارتفاع ساعت را مشخص می‌کند.
مقدار پیش‌فرض برای ساعت‌های عقربه‌ای (آنالوگ) ۱۶۴ پیکسل است؛
مقدار پیش‌فرض برای ساعت‌های دیجیتال به میزانی است که برای نگهداری ساعت هنگام نمایش با قلم انتخاب‌شده مورد نیاز است.
.TP 8
.B update (\fPclass\fB Interval)
بسامد به‌روزرسانی و بازنمایش زمان را بر حسب ثانیه مشخص می‌کند.
.TP 8
.B foreground (\fPclass\fB Foreground)
رنگ نشانگرهای تیک (درجه‌بندی) را مشخص می‌کند.
مقدار پیش‌فرض به این بستگی دارد که آیا \fBreverseVideo\fP مشخص شده باشد یا خیر.
اگر \fBreverseVideo\fP مشخص شده باشد، مقدار پیش‌فرض \fBlwhite\fP است،
در غیر این صورت مقدار پیش‌فرض \fBblack\fP خواهد بود.
توجه داشته باشید هنگامی که Xrender فعال است، از این منبع استفاده نمی‌شود.
.TP 8
.B hands (\fPclass\fB Foreground)
رنگ بخش درونی عقربه‌های ساعت را مشخص می‌کند.
مقدار پیش‌فرض به این بستگی دارد که آیا \fBreverseVideo\fP مشخص شده باشد یا خیر.
اگر \fBreverseVideo\fP مشخص شده باشد، مقدار پیش‌فرض \fBlwhite\fP است،
در غیر این صورت مقدار پیش‌فرض \fBblack\fP خواهد بود.
توجه داشته باشید هنگامی که Xrender فعال است، از این منبع استفاده نمی‌شود.
.TP 8
.B highlight (\fPclass\fB Foreground)
رنگ مورد استفاده برای برجسته‌سازی عقربه‌های ساعت را مشخص می‌کند.
مقدار پیش‌فرض به این بستگی دارد که آیا \fBreverseVideo\fP مشخص شده باشد یا خیر.
اگر \fBreverseVideo\fP مشخص شده باشد، مقدار پیش‌فرض \fBlwhite\fP است،
در غیر این صورت مقدار پیش‌فرض \fBblack\fP خواهد بود.
توجه داشته باشید هنگامی که Xrender فعال است، از این منبع استفاده نمی‌شود.
.TP 8
.B analog (\fPclass\fB Boolean)
مشخص می‌کند که آیا ساعت عقربه‌ای به جای ساعت دیجیتال استفاده شود یا خیر.
مقدار پیش‌فرض True است.
.TP 8
.B analog24 (\fPclass\fB Boolean)
مشخص می‌کند که آیا ساعت عقربه‌ای ۲۴ ساعته به جای ساعت دیجیتال یا عقربه‌ای ۱۲ ساعته استفاده شود یا خیر.
تنظیم آن روی True همچنین \fBanalog\fP را روی True تنظیم می‌کند.
مقدار پیش‌فرض False است.
.TP 8
.B twentyfour (\fPclass\fB Boolean)
مشخص می‌کند که آیا ساعت دیجیتال زمان را در قالب ۲۴ ساعته نمایش دهد یا خیر.
مقدار پیش‌فرض True است.
.TP 8
.B chime (\fPclass\fB Boolean)
مشخص می‌کند که آیا در رأس هر ساعت و نیم‌ساعت زنگ به صدا درآید یا خیر.
.TP 8
.B padding (\fPclass\fB Margin)
میزان حاشیه درونی (padding) مورد استفاده را بر حسب پیکسل مشخص می‌کند.
مقدار پیش‌فرض ۸ است.
.TP 8
.B font (\fPclass\fB Font)
قلم مورد استفاده برای ساعت دیجیتال را مشخص می‌کند.
توجه داشته باشید که قلم‌های با عرض متغیر در حال حاضر ممکن است همیشه به درستی نمایش داده نشوند.
این قلم فقط زمانی استفاده می‌شود که Xrender فعال نباشد.
.TP 8
.B render (\fPclass\fB Boolean)
مشخص می‌کند که آیا افزونه Xrender برای نمایش استفاده شود یا خیر.
اگر \fBxclock\fP با پشتیبانی از Xrender کامپایل شده باشد، مقدار پیش‌فرض True است.
.PP
هنگامی که Xrender فعال باشد، منابع اضافی زیر نیز درک می‌شوند:
.TP 8
.B face (\fPclass\fB FaceName)
الگوی قلم مورد استفاده برای ساعت دیجیتال در صورت استفاده از Xrender را مشخص می‌کند.
الگوها با استفاده از قالب چهره fontconfig که در بخش
.I Font Names
از
.BR fonts.conf (5)
شرح داده شده است، تعیین می‌شوند.
.TP 8
.B sharp (\fPclass\fB Boolean)
مشخص می‌کند که آیا هنگام رندر کردن ساعت باید از لبه‌های تیز استفاده شود یا خیر.
مقدار پیش‌فرض False است.
.TP 8
.B buffer (\fPclass\fB Boolean)
مشخص می‌کند که به‌روزرسانی‌های تصویر، به جای اینکه مستقیماً در پنجره رسم شوند، ابتدا روی یک pixmap رسم شده و سپس در پنجره کپی شوند.
.PP
مقادیر پیش‌فرض منابع رنگ زیر به این بستگی دارد که آیا
\fBreverseVideo\fP مشخص شده باشد یا خیر.
اگر \fBreverseVideo\fP مشخص شده باشد، مقدار پیش‌فرض \fBlwhite\fP است،
در غیر این صورت مقدار پیش‌فرض \fBblack\fP خواهد بود.
.TP 8
.B hourColor (\fPclass\fB Foreground)
رنگ عقربه ساعت‌شمار.
.TP 8
.B minuteColor (\fPclass\fB Foreground)
رنگ عقربه دقیقه‌شمار.
.TP 8
.B secondColor (\fPclass\fB Foreground)
رنگ عقربه ثانیه‌شمار.
.TP 8
.B majorColor (\fPclass\fB Foreground)
رنگ نشانگرهای اصلی درجه‌بندی (یعنی هر پنج دقیقه یا در صورت استفاده از \-analog24، هر ۲٫۵ دقیقه).
.TP 8
.B minorColor (\fPclass\fB Foreground)
رنگ نشانگرهای فرعی درجه‌بندی (بین نشانگرهای اصلی).
.TP 8
.B amColor (\fPclass\fB Foreground)
رنگ نشانگر AM.
.TP 8
.B pmColor (\fPclass\fB Foreground)
رنگ نشانگر PM.
.TP 8
.B fixed1Color (\fPclass\fB Foreground)
رنگ عنصر ثابت ۱.
.TP 8
.B fixed2Color (\fPclass\fB Foreground)
رنگ عنصر ثابت ۲.
.TP 8
.B fixed3Color (\fPclass\fB Foreground)
رنگ عنصر ثابت ۳.
.TP 8
.B hourShape (\fPclass\fB String)
شکل عقربه ساعت‌شمار.
.sp
شکل به صورت مجموعه‌ای از نقاط داده می‌شود که هر گروه سه‌تایی از نقطه‌ها، یک مثلث را توصیف می‌کند. یک نقطه می‌تواند به صورت \fB(X, Y)\fP مشخص شود که در آن \fB(0, 0)\fP در مرکز صفحه ساعت، \fB(0, 100)\fP در محیط بالایی هنگامی که عقربه رو به بالاست و \fB(100, 0)\fP در محیط سمت راست هنگامی که عقربه رو به بالاست قرار دارد. یک نقطه همچنین می‌تواند به صورت یک اندیس عدد صحیح داده شود که در آن \fB0\fP به نقطه نخست، \fB\-1\fP به نقطه پیشین و غیره اشاره دارد. در هر کجای بیرون از پرانتزها، می‌توانید دستگاه مختصات را تبدیل کنید که بر همهٔ مختصات پس از آن اثر می‌گذارد:
\fBrA\fP دستگاه مختصات را در جهت عقربه‌های ساعت به اندازه زاویه \fBA\fP می‌چرخاند، \fBwF\fP / \fBhF\fP مختصات x / y را به ترتیب با ضریب \fBF\fP مقیاس‌بندی می‌کند، و \fBxL\fP / \fByL\fP دستگاه مختصات را در امتداد x / y به ترتیب به اندازه طول \fBL\fP انتقال می‌دهد. یک رشته خالی چیزی را رندر نخواهد کرد.
.TP 8
.B minuteShape (\fPclass\fB String)
شکل عقربه دقیقه‌شمار.
.TP 8
.B secondShape (\fPclass\fB String)
شکل عقربه ثانیه‌شمار.
.TP 8
.B majorShape (\fPclass\fB String)
شکل نشانگرهای اصلی درجه‌بندی (یعنی هر پنج دقیقه).
.TP 8
.B minorShape (\fPclass\fB String)
شکل نشانگرهای فرعی درجه‌بندی (بین نشانگرهای اصلی).
.TP 8
.B amShape (\fPclass\fB String)
شکل نشانگر AM.
.TP 8
.B pmShape (\fPclass\fB String)
شکل نشانگر PM.
.TP 8
.B fixed1Shape (\fPclass\fB String)
شکل عنصر ثابت ۱.
عناصر ثابت نمی‌چرخند و به شما امکان می‌دهند صفحه ساعت را به صورت دلخواه طراحی کنید.
.TP 8
.B fixed2Shape (\fPclass\fB String)
شکل عنصر ثابت ۲.
.TP 8
.B fixed3Shape (\fPclass\fB String)
شکل عنصر ثابت ۳.
.TP 8
.B rotateAmpm (\fPclass\fB Boolean)
اگر روی True باشد، نشانگرهای AM و PM را با همان سرعت عقربه ساعت‌شمار می‌چرخاند.
.TP 8
.B zOrder (\fPclass\fB String)
رشته‌ای که ترتیب رندر شدن عناصر ساعت را توصیف می‌کند.
هر نویسه یک عنصر از ساعت را به صورت زیر مشخص می‌کند:
.sp
.nf
\fBT\fR: نشانگرهای اصلی
\fBt\fR: نشانگرهای فرعی
\fB1\fR: عنصر ثابت ۱
\fB2\fR: عنصر ثابت ۲
\fB3\fR: عنصر ثابت ۳
\fBa\fR: نشانگر AM
\fBp\fR: نشانگر PM
\fBh\fR: عقربه ساعت‌شمار
\fBm\fR: عقربه دقیقه‌شمار
\fBs\fR: عقربه ثانیه‌شمار
.fi.TP 8
.B proportional (\fPclass\fB Boolean)
در صورت تنظیم روی درست (true)، حتی اگر پنجره مربع نباشد، یک ساعت متناسب ایجاد می‌کند.
.SH "ویجت‌ها (WIDGETS)"
برای تعیین منابع (resources)، دانستن سلسله‌مراتب ویجت‌هایی که \fBxclock\fR را تشکیل می‌دهند مفید است.
در نشانه‌گذاری زیر، تورفتگی نشان‌دهنده ساختار سلسله‌مراتبی است.
ابتدا نام کلاس ویجت و سپس نام نمونهٔ (instance) ویجت آمده است.
.sp
.ft CW
.nf
XClock  xclock
        Clock  clock
.fi
.ft
.sp
.SH "نمونه استفاده از منابع X (EXAMPLE USE OF X RESOURCES)"
به عنوان مثال، موارد زیر را به \(ti/.Xresources اضافه کنید:
.sp
.ft CW
.nf
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)
.fi
.ft
.sp
سپس \fBxrdb \(ti/.Xresources\fP را اجرا کرده و \fBxclock\fP را آغاز کنید.
.sp
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای دریافت میزبان پیش‌فرض و شماره نمایشگر.
.TP 8
.B XENVIRONMENT
برای دریافت نام فایل منبعی که جایگزین منابع سراسری ذخیره‌شده در ویژگی RESOURCE_MANAGER می‌شود.
.SH "فایل‌ها (FILES)"
.TP
.I /usr/share/X11/app-defaults/XClock
منابع مورد نیاز را مشخص می‌کند
.SH "همچنین ببینید (SEE ALSO)"
.BR xrdb (1),
.BR time (3),
.BR fonts.conf (5),
.BR X (7).
.SH "گزارش باگ‌ها (BUGS)"
.I Xclock
به ساعت سیستم اعتماد می‌کند.
.PP
در حالت دیجیتال، رشته متنی باید به صورت خودکار در مرکز تراز شود.
.SH "نویسندگان (AUTHORS)"
Tony Della Fera (MIT-Athena, DEC)
.br
Dave Mankins (MIT-Athena, BBN)
.br
Ed Moy (UC Berkeley)