Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TCLOCK(1)		    General Commands Manual		     TCLOCK(1)

NAME
       tclock -	display	time of	day

SYNOPSIS
       tclock [-option ...]

DESCRIPTION
       Tclock displays an analog clock with a transparent face.

OPTIONS
       -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 specifi-
	       cation  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  ad-
	       justed  by  the	-scale	option;	 however, ticks	do not seem to
	       scale well, so if you regularly start up	the clock  at  a  spe-
	       cific  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 specify-
	       ing -xrm	"Tclock.Second.Tip.Radius: 0".

RESOURCES
       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 specifi-
       cations 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 dis-
       ables 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.

SEE ALSO
       oclock(1), xclock(1)

COPYRIGHT
       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  MER-
       CHANTABILITY  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.

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

X Version 11			   Release 4			     TCLOCK(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tclock&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help