NAME
xonclock - simple X on-screen analog clock
SYNOPSIS
xonclock [OPTIONS]
DESCRIPTION
Shows an analog clock on X screen
OPTIONS
- --skin=FILE
- This option tells xonclock which file to be used as a
clock skin. xonclock can handle PNG, JPEG, TIFF, XPM images.
By default it loads an internal skin.
- --position=POSITION
- This option defines the clock placement on X screen. It may be:
TOP-LEFT, TOP-CENTER, TOP-RIGHT,
MIDDLE-LEFT, MIDDLE-CENTER, MIDDLE-RIGHT,
BOTTOM-LEFT, BOTTOM-CENTER, BOTTOM-RIGHT. By
default it set to BOTTOM-RIGHT.
- --offset-v=OFFSET
- This option defines vertical offset of the clock concerning its
base placement. Positive offset will shift clock lower, negative -
upper. Default: 0.
- --offset-h=OFFSET
- This option defines horizontal offset of the clock concerning
its base placement. Positive offset will shift clock right,
negative - left. Default: 0.
- --hour-length=LENGTH
- This option defines length of the clock hour hand. It ought to
be positive. Default: automatic.
- --hour-width=WIDTH
- This option defines width of the clock hour hand. It ought to
be positive. Default: 4.
- --minute-length=LENGTH
- This option defines length of the clock minute hand. It ought
to be positive. Default: automatic.
- --minute-width=WIDTH
- This option defines width of the clock minute hand. It ought to
be positive. Default: 3.
- --second-length=LENGTH
- This option defines length of the clock second hand. It ought
to be positive. Default: automatic.
- --second-width=WIDTH
- This option defines width of the clock second hand. It ought to
be positive. Default: 1.
- --color-hour=R/G/B/A
- This option defines color of the clock hour hand.
R/G/B/A are color components: R - red, G - green,
B - blue, A - alpha (opacity). Each of them ought to
be in 0...255 range. Default: 255/0/0/255.
- --color-minute=R/G/B/A
- This option defines color of the clock minute hand.
R/G/B/A are color components: R - red, G - green,
B - blue, A - alpha (opacity). Each of them ought to
be in 0...255 range. Default: 0/255/0/255.
- --color-second=R/G/B/A
- This option defines color of the clock second hand.
R/G/B/A are color components: R - red, G - green,
B - blue, A - alpha (opacity). Each of them ought to
be in 0...255 range. Default: 0/0/255/255.
- --hands-rotation-axis=X/Y
- This option defines coordinates of the clock hands rotation
axis concerning top left corner of a clock window. Usefull for
nonrectangular clock skins. Default: center of the clock skin
rectangle.
- --overlap=SIZE
- This option defines length of the clock hands tails that
overlaps thru center of the clock hands rotation axis. Default:
1/5 of the clock second hand length.
- --sleep=SECONDS
- This option defines startup sleep time. It useful if you start
xonclock from your ~/.xinitrc file (see startx
script manual page). Doing so you will prevent display connection
error (it may ouccur if you start xonclock while your have
no display created by X server). Default: 0.
- --top
- Set the clock to be shown always on top. Your windows manager
may ignore this request and the option may not work. Default:
no.
- -s, --show-seconds
- Render the second hand. Default: no.
- -d, --show-date
- Render the date string. Default: no.
- --date-font=FONTNAME
- This option defines a date string font. Detailed descrition of
the font name format see in fontconfig library manual. Default:
fixed-8.
- --date-color=R/G/B/A
- This option defines color of a date string. R/G/B/A are
color components: R - red, G - green, B - blue,
A - alpha (opacity). Each of them ought to be in 0...255
range. Default: 0/0/0/255.
- --date-position=POSITION
- This option defines date string position on the clock. It may
be: TOP-LEFT, TOP-CENTER, TOP-RIGHT,
MIDDLE-LEFT, MIDDLE-CENTER, MIDDLE-RIGHT,
BOTTOM-LEFT, BOTTOM-CENTER, BOTTOM-RIGHT. By
default it set to MIDDLE-CENTER.
- --date-offset-v=OFFSET
- This option defines vertical offset of the date string
concerning its base placement. Positive offset will shift it lower,
negative - upper. Default: 10.
- --date-offset-h=OFFSET
- This option defines horizontal offset of the date string
concerning its base placement. Positive offset will shift it right,
negative - left. Default: 0.
- --date-format=FORMAT
- This option defines format of the date string. Detailed
description of the FORMAT may be found in strftime manual page
(type man strftime). Default: %G-%m-%d.
- --date-clip-format=FORMAT
- This option defines format of the date string to be pasted into
X clipboard. Note that program was tested with KDE 3.4.1 (KWrite,
KEdit) so on other systems it may doesn't work. No multilanguage
support are provided for a while. The date string will be copied
into X clipboard on mouse left button click over the clock.
Detailed description of the FORMAT may be found in strftime manual
page (type man strftime). Default: %G-%m-%d %H:%M:%S.
- --movable
- Allows to move the clock with a mouse left button. Default:
not set.
- --use-background
- This option tells xonclock to merge clock skin with desktop
root window background image allowing to render the skins with
alpha channel. It does not work with XPM skins. Default: not
set.
- --remerge-sleep=MICROSECOND
- This option tells xonclock to sleep for MICROSECOND to
be sure that any obscured window has been refreshed while
retrieving new background. This option is useful if only
--use-background is used. Default: 5000.
- --no-winredirect
- If the program is started under KDE or GNOME (and maybe someone
else) the clock may get hidden state. Try to set this flag to
prevent a such situation. It may help I hope. Default: not
set.
- --tz-hour=VAL
- This option allows to customize system time-zone settings. The
hour value obtained from a system call will be calculated as hour's
system value + VAL. The valid range is [-24;24]. Default:
0.
- --tz-minute=VAL
- This option allows to customize system time-zone settings. The
minute value obtained from a system call will be calculated as
minute's system value + VAL. The valid range is [-60;60].
Default: 0.
- -v, --version
- Prints program version and exit.
- -h, --help
- Display help and exit.
EVENTS
- -
- You may copy date string into X clipboard with mouse left
button single click on xonclock. It works if xonclock has been
started with --show-date option only.
- -
- You may exit from xonclock with mouse right button double
click.
- -
- You may remerge desktop root window background image and clock
skin by mouse left button double click (it works if xonclock
has been started with --use-background option only).
AUTHOR
Written by Cyrill Gorcunov <gclion@mail.ru>. There is ABSOLUTELY
NO WARRANTY for this program.
COPYRIGHT
It may be freely distributed under the terms of
GNU General Public License.