NAME¶
cairo-clock - an analog clock drawn with vector-graphics
SYNOPSIS¶
cairo-clock [
--x X] [
--y Y] [
--width WIDTH] [
--height HEIGHT] [
--seconds] [
--date] [
--theme
name] [
--ontop] [
--pager] [
--taskbar] [
--sticky] [
--twelve] [
--twentyfour] [
--refresh]
cairo-clock -h, --help
cairo-clock -v, --version
cairo-clock -l, --list
DESCRIPTION¶
This manual page documents briefly the usage of the
cairo-clock program.
You can move the clock around with your mouse by pressing and holding the left
mouse-button and dragging your mouse around. The clock will follow your
movements. To resize the clock you have to press and hold the middle
mouse-button down and drag your mouse around. The upper-left corner of the
clock will follow your movements. Just clicking the right mouse-button on the
clock will bring up the popup-menu. You find three menu-items. Properties,
Info and Quit. Selecting the Properties item will bring up a dialog where you
can change all available features of the clock (e.g. size, theme, display of
optional elements, pager- and taskbar-behaviour). The next menu-item, Info,
will bring up an informational dialog stating the name of program, current
version, author and license information. The third and last menu-item, Quit,
really exits the program if you select it. Surprised?! ;-) You can also hit
the ESC-key if you want to exit the program.
If you want to install additional themes for the clock you downloaded from the
internet you can best place them in you home-directory under
~/.cairo-clock/themes. You proably have to create that directory-structure the
first time you install new themes. A theme there goes in a directory like e.g.
~/.cairo-clock/theme/new_theme. Once you copied the new themes directory there
you will be able to select it via the Properties dialog in the theme-selection
widget after a restart of the program. The theme-directories are only scanned
during program-start. The newly added 24h-mode for cairo-clock will need you
to select any of the supplied 24h-themes. While the clock will run without any
problems if you switch to 24h-mode and still use a 12h-based theme, you are
going to want to select a 24h-based theme in order to make any sense of the
displayed hand-positions in 24h-mode.
OPTIONS¶
cairo-clock now uses common GNU-convention for commandline-options. Take note
that using commandline-options overrules everything which maybe stored in your
local settings-file. Using the commandline-options will completely ignore any
settings you may have stored in your local settings-file. Every option will
default to program-internal settings. A summary of options is included below.
There is no Info file on this.
- -x, --xposition X
-
The initial x-position of the top-left window-corner of the clock will be
X.
- -y, --yposition Y
-
The initial y-position of the top-left window-corner of the clock will be
Y.
- -w, --width WIDTH
-
Initially open the window of the clock with a width of WIDTH.
- -g, --height HEIGHT
-
Initially open the window of the clock with a height of HEIGHT.
- -s, --seconds
-
Passing this means to render the seconds-hand. If you leave this out no
seconds-hand will be drawn.
- -d, --date
-
Passing this means to render the date-display. If you leave this out no date
will be drawn.
- -l, --list
-
List all themes installed system-wide and locally for the current user and
exit.
- -t, --theme NAME
-
Use theme NAME for rendering. Use the any of the names returned by
the options -l or --list.
- -o, --ontop
-
Passing this means the clock-window will stay above all other windows. If
you leave this out other windows can overlap the clock-window.
- -p, --pager
-
Passing this means the clock-window will appear in the pager. If you leave
this out the pager will ignore the clock-window and not display it.
- -b, --taskbar
-
Passing this means the clock-window will show up in the taskbar. If you
leave this out the clock-window will not show up in the taskbar.
- -i, --sticky
-
Passing this means to have the clock-window appear all your workspaces. If
you leave this out the clock will only be visible on the current workspace
from where you initially started cairo-clock.
- -e, --twelve
-
Passing this will force the hour hand to use commonly known 12h per full
circle.
- -f, --twentyfour
-
Passing this will cause the hour hand to spread 24h across a full
circle.
- -r, --refresh RATE
-
Use an animation-refreshrate of RATE for rendering. Use this with
caution! Possible values are 1..60 Hz.
- -h, --help
-
Print a usage-description and exit.
- -v, --version
-
Print the programs version-number and exit.
BUGS¶
If redraws don't happen every second (the second-hand is drawn) the needed
refresh after a window-size change via the preferences-dialog only happens on
a minute-interval.
AUTHOR¶
cairo-clock is written and maintained by Mirco Mueller
<macslow@bangang.de>.
This manual page was written by Mirco Mueller <macslow@bangang.de>, for
the Debian/Ubuntu project (but may be used by others).