GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
TCLOCK(1) FreeBSD General Commands Manual TCLOCK(1)

tclock - display time of day

tclock [-option ...]

Tclock displays an analog clock with a transparent face.

-background background-color
specify the color of the interior of the clock
-bg background-color
same as -background
-border border-color
specify the color of the clock border
-borderWidth border-width
specify the thickness of the border - this is used as the line-width attribute of a graphics context, so a border width of zero still results in a thin border. If you want no border at all, make the border color the same as the background color.
-display display-name
specify the name of the display to use
-geometry clock-geometry
specify the geometry of the clock. Note that the size specification of this string will be ignored; see the -scale option for changing the size of the clock.
-scale clock-size
specify the size of the clock as a scale of the normal size. For example, -scale 0.5 results in a clock half the size of the default (in width and height - one-fourth the size in area), and -scale 2.5 results in a clock two and one-half times larger.
-tickradius tick-distance
specify the distance of each tick from the center of the clock. Specifying zero results in no tick marks. Note that this is adjusted by the -scale option.
-ticksize tick-size
specify the radius of each tick mark. Note that this is adjusted by the -scale option; however, ticks do not seem to scale well, so if you regularly start up the clock at a specific scaling amount, you may wish to fine-tune this parameter for best results.
-width border-width
same as -borderWidth
-xrm miscellaneous-resource
specify a resource for which no command-line option exists. This is most often used to disable the second hand by specifying -xrm "Tclock.Second.Tip.Radius: 0".

The resources equivalent to command-line options are
Tclock.geometry
Tclock.scale
Tclock.border
Tclock.background
Tclock.borderWidth
Tclock.tick.radius
Tclock.tick.size

In addition, each hand of the clock is made up of four points. You may specify the position of each of these four points for each hand. The hand specifications are {hour, minute, second}, and the point specifications are {tip, right, middle, left}. Each point has two resources:

Tclock.hand.point.radius
Tclock.hand.point.offset

The radius specifies the distance in pixels of that points from the center of the clock. The offset specifies the angle of that point as an offset in minutes (sixtieths of a circle) from the "true" position of the hand. Specifying a radius of zero for the tip of a hand disables that hand.

Note that after you have fine-tuned the shapes of the hands, you can simply use the -scale option (or the .scale resource) to get any size clock with hands of that shape, without needing to adjust the radii of all those points.

oclock(1), xclock(1)

Copyright (C) 1991 Rob Mayoff.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Rob Mayoff (mayoff@ccwf.cc.utexas.edu)

Release 4 X Version 11

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.