358 lines
11 KiB
HTML
358 lines
11 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of XCLOCK</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>XCLOCK</H1>
|
|
Section: User Commands (1)<BR>Updated: xclock 1.0.9<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
xclock - analog / digital clock for X
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>xclock</B> [ <B>-help</B> ] [ <B>-analog</B> | <B>-digital</B> ]
|
|
[ <B>-brief</B> ] [ <B>-chime</B> ] [ <B>-hd</B> <I>color</I> ]
|
|
[ <B>-hl</B> <I>color</I> ] [ <B>-update</B> <I>seconds</I> ]
|
|
[ <B>-strftime</B> <I>format</I> ]
|
|
[ <B>-twelve</B> | <B>-twentyfour</B> | <B>-utime</B> ]
|
|
[ <B>-padding</B> <I>number</I> ]
|
|
[ <B>-norender</B> ]
|
|
[ <B>-render</B> ]
|
|
[ <B>-sharp</B> ]
|
|
[ <B>-face</B> <I>pattern</I> ]
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<I>xclock</I>
|
|
|
|
program displays the time in analog or digital form. The time is continuously
|
|
updated at a frequency which may be specified by the user.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<I>Xclock</I>
|
|
|
|
accepts all of the standard X Toolkit command line options along with the
|
|
additional options listed below:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-help</B>
|
|
|
|
<DD>
|
|
This option indicates that a brief summary of the allowed options should be
|
|
printed on the standard error.
|
|
<DT id="2"><B>-analog</B>
|
|
|
|
<DD>
|
|
This option indicates that a conventional 12 hour clock face with tick marks
|
|
and hands should be used. This is the default.
|
|
<DT id="3"><B>-digital</B> or <B>-d</B><DD>
|
|
This option indicates that a 24 hour digital clock should be used.
|
|
<DT id="4"><B>-brief</B><DD>
|
|
This option indicates that the digital clock should only display the hours
|
|
and minutes fields. The default is to show the full time and date information.
|
|
<DT id="5"><B>-utime</B><DD>
|
|
This option indicates that a digital clock should display seconds since
|
|
the Epoch (in format '970012340 seconds since Epoch' instead of a standard
|
|
24-hour time.
|
|
<DT id="6"><B>-strftime </B><I>format</I>
|
|
|
|
<DD>
|
|
This option allows an <A HREF="/cgi-bin/man/man2html?3+strftime">strftime</A>(3) format string to be specified
|
|
for the digital clock's display.
|
|
<DT id="7"><B>-twelve</B>
|
|
|
|
<DD>
|
|
This option indicates that a digital clock should display the time in
|
|
twelve hour format.
|
|
<DT id="8"><B>-twentyfour</B>
|
|
|
|
<DD>
|
|
This option indicates that a digital clock should display the time in
|
|
twenty-four hour format. This is the default when a digital clock is used.
|
|
<DT id="9"><B>-chime</B>
|
|
|
|
<DD>
|
|
This option indicates that the clock should chime
|
|
once on the half hour and twice on the hour.
|
|
<DT id="10"><B>-hands</B> <I>color</I> (or <B>-hd</B> <I>color</I>)<DD>
|
|
This option specifies the color of the hands on an analog clock. The default
|
|
is <I>black</I>.
|
|
This option is effectively ignored when Xrender is in use.
|
|
<DT id="11"><B>-highlight</B> <I>color</I> (or <B>-hl</B> <I>color</I>)<DD>
|
|
This option specifies the color of the edges of the hands on an analog clock,
|
|
and is only useful on color displays. The default is <I>black</I>.
|
|
This option is effectively ignored when Xrender is in use.
|
|
<DT id="12"><B>-update </B><I>seconds</I>
|
|
|
|
<DD>
|
|
This option specifies the frequency in seconds at which <I>xclock</I>
|
|
should update its display. If the clock is obscured and then exposed,
|
|
it will be updated immediately. A value of 30 seconds or less will enable a
|
|
second hand on an analog clock. The default is 60 seconds.
|
|
<DT id="13"><B>-padding </B><I>number</I>
|
|
|
|
<DD>
|
|
This option specifies the width in pixels of the padding
|
|
between the window border and clock text or picture. The default is 10
|
|
on a digital clock and 8 on an analog clock.
|
|
<DT id="14"><B>-render</B>
|
|
|
|
<DD>
|
|
This option tells <I>xclock</I> to use the Xrender extension to draw an
|
|
anti-aliased face. This is the default if <I>xclock</I> has been
|
|
compiled with Xrender support.
|
|
Note that the color selection options and resources used when Xrender is
|
|
in effect differ from the standard options.
|
|
<DT id="15"><B>-norender</B>
|
|
|
|
<DD>
|
|
This option turns off the use of Xrender to draw the clock.
|
|
<DT id="16"><B>-sharp</B>
|
|
|
|
<DD>
|
|
This option tells <I>xclock</I> to use sharper edges when drawn using
|
|
the Xrender extension.
|
|
<DT id="17"><B>-face </B><I>pattern</I>
|
|
|
|
<DD>
|
|
This option specifies the font to use in digital mode when the
|
|
Xrender extension is used. Patterns are specified using the
|
|
fontconfig face format described in the
|
|
<I>Font Names</I>
|
|
|
|
section of
|
|
<I><A HREF="/cgi-bin/man/man2html?5+fonts.conf">fonts.conf</A></I>(5).
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>X DEFAULTS</H2>
|
|
|
|
This program uses the
|
|
<I>Clock</I>
|
|
|
|
widget. It understands all of the core resource names and classes as well as:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="18"><B>width (</B>class<B> Width)</B>
|
|
|
|
<DD>
|
|
Specifies the width of the clock. The default for analog clocks is 164
|
|
pixels; the default for digital clocks is whatever is needed to hold the
|
|
clock when displayed in the chosen font.
|
|
<DT id="19"><B>height (</B>class<B> Height)</B>
|
|
|
|
<DD>
|
|
Specifies the height of the clock. The default for analog clocks is 164
|
|
pixels; the default for digital clocks is whatever is needed to hold the
|
|
clock when displayed in the chosen font.
|
|
<DT id="20"><B>update (</B>class<B> Interval)</B>
|
|
|
|
<DD>
|
|
Specifies the frequency in seconds at which the time should be redisplayed.
|
|
<DT id="21"><B>foreground (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
Specifies the color for the tick marks. The default depends on whether
|
|
<I>reverseVideo</I> is specified. If <I>reverseVideo</I> is specified
|
|
the default is <I>lwhite</I>, otherwise the default is <I>black</I>.
|
|
<P>
|
|
<DT id="22"><B>hands (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
Specifies the color of the insides of the clock's hands. The default
|
|
depends on whether
|
|
<I>reverseVideo</I> is specified. If <I>reverseVideo</I> is specified
|
|
the default is <I>lwhite</I>, otherwise the default is <I>black</I>.
|
|
Note that this resource is not used when Xrender is in effect.
|
|
<DT id="23"><B>highlight (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
Specifies the color used to highlight the clock's hands. The default is
|
|
<BR> depends on whether
|
|
<I>reverseVideo</I> is specified. If <I>reverseVideo</I> is specified
|
|
the default is <I>lwhite</I>, otherwise the default is <I>black</I>.
|
|
Note that this resource is not used when Xrender is in effect.
|
|
<DT id="24"><B>analog (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
Specifies whether or not an analog clock should be used instead of a digital
|
|
one. The default is True.
|
|
<DT id="25"><B>twentyfour (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
Specifies whether or not a digital clock should display the time in
|
|
twenty-four hour format. The default is True.
|
|
<DT id="26"><B>chime (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
Specifies whether or not a bell should be rung on the hour and half hour.
|
|
<DT id="27"><B>padding (</B>class<B> Margin)</B>
|
|
|
|
<DD>
|
|
Specifies the amount of internal padding in pixels to be used. The default is
|
|
8.
|
|
<DT id="28"><B>font (</B>class<B> Font)</B>
|
|
|
|
<DD>
|
|
Specifies the font to be used for the digital clock. Note that variable width
|
|
fonts currently will not always display correctly.
|
|
This font is only used when Xrender is not in effect.
|
|
<DT id="29"><B>render (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
Specifies whether or not the Xrender extension should be used for the
|
|
display. The default is True if <I>xclock</I> has been compiled with
|
|
Xrender support.
|
|
</DL>
|
|
<P>
|
|
|
|
When Xrender is in effect, the following additional resources are
|
|
understood:
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="30"><B>face (</B>class<B> FaceName)</B>
|
|
|
|
<DD>
|
|
Specify the pattern for the font to be used for the digital clock when
|
|
Xrender is used. Patterns are specified using the fontconfig face format
|
|
described in the
|
|
<I>Font Names</I>
|
|
|
|
section of
|
|
<I><A HREF="/cgi-bin/man/man2html?5+fonts.conf">fonts.conf</A></I>(5).
|
|
|
|
<DT id="31"><B>sharp (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
Specifies if sharp edges should be used when rendering the clock.
|
|
The default is False.
|
|
<DT id="32"><B>buffer (</B>class<B> Boolean)</B>
|
|
|
|
<DD>
|
|
Specifies that the updates of the image are drawn to a pixmap before copied
|
|
into the window instead drawing them into the window directly.
|
|
</DL>
|
|
<P>
|
|
|
|
The defaults of the following color resources depend on whether
|
|
<I>reverseVideo</I> is specified.
|
|
If <I>reverseVideo</I> is specified the default is <I>lwhite</I>,
|
|
otherwise the default is <I>black</I>.
|
|
<DL COMPACT>
|
|
<DT id="33"><B>hourColor (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
The color of the hour hand.
|
|
<DT id="34"><B>minuteColor (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
The color of the minute hand.
|
|
<DT id="35"><B>secondColor (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
The color of the second hand.
|
|
<DT id="36"><B>majorColor (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
The color of the major scale ticks (i. e. each five minutes).
|
|
<DT id="37"><B>minorColor (</B>class<B> Foreground)</B>
|
|
|
|
<DD>
|
|
The color of the minor scale ticks (between major ticks).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>WIDGETS</H2>
|
|
|
|
In order to specify resources, it is useful to know the hierarchy of
|
|
the widgets which compose <I>xclock</I>. In the notation below,
|
|
indentation indicates hierarchical structure. The widget class name
|
|
is given first, followed by the widget instance name.
|
|
<P>
|
|
|
|
<PRE>
|
|
XClock xclock
|
|
Clock clock
|
|
</PRE>
|
|
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="38"><B>DISPLAY</B>
|
|
|
|
<DD>
|
|
to get the default host and display number.
|
|
<DT id="39"><B>XENVIRONMENT</B>
|
|
|
|
<DD>
|
|
to get the name of a resource file that overrides the global resources
|
|
stored in the RESOURCE_MANAGER property.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="40"><I>/etc/X11/app-defaults/XClock</I>
|
|
|
|
<DD>
|
|
specifies required resources
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+X">X</A>(7), <A HREF="/cgi-bin/man/man2html?1+xrdb">xrdb</A>(1), <A HREF="/cgi-bin/man/man2html?3+time">time</A>(3), fonts.conf (5).
|
|
<A NAME="lbAK"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
<I>Xclock</I>
|
|
|
|
believes the system clock.
|
|
<P>
|
|
|
|
When in digital mode, the string should be centered automatically.
|
|
<A NAME="lbAL"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Tony Della Fera (MIT-Athena, DEC)
|
|
<BR>
|
|
|
|
Dave Mankins (MIT-Athena, BBN)
|
|
<BR>
|
|
|
|
Ed Moy (UC Berkeley)
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="41"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="42"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="43"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="44"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="45"><A HREF="#lbAF">X DEFAULTS</A><DD>
|
|
<DT id="46"><A HREF="#lbAG">WIDGETS</A><DD>
|
|
<DT id="47"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="48"><A HREF="#lbAI">FILES</A><DD>
|
|
<DT id="49"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
<DT id="50"><A HREF="#lbAK">BUGS</A><DD>
|
|
<DT id="51"><A HREF="#lbAL">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:30 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|