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

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
XCLOCK(1)							     XCLOCK(1)

NAME
       xclock -	analog / digital clock for X

SYNOPSIS
       xclock  [  -help	] [ -analog ] [	-digital ] [ -brief ] [	-chime ] [ -hd
       color ] [ -hl color ] [ -update seconds ] [ -strftime format ] [	 -pad-
       ding number ] [ -norender ] [ -render ] [ -sharp	] [ -face pattern ]

DESCRIPTION
       The  xclock  program  displays the time in analog or digital form.  The
       time is continuously updated at a frequency which may be	 specified  by
       the user.

OPTIONS
       Xclock accepts all of the standard X Toolkit command line options along
       with the	additional options listed below:

       -help   This option indicates that  a  brief  summary  of  the  allowed
	       options should be printed on the	standard error.

       -analog This  option  indicates	that a conventional 12 hour clock face
	       with tick marks and hands should	be used.  This is the default.

       -digital	or -d
	       This  option  indicates	that a 24 hour digital clock should be
	       used.

       -brief  This option indicates that the digital clock should  only  dis-
	       play  the hours and minutes fields.  The	default	is to show the
	       full time and date information.

       -utime or -d
	       This option indicates that a digital clock should display  sec-
	       onds since the Epoch (in	format '970012340 seconds since	Epoch'
	       instead of a standard 24-hour time.

       -strftime format
	       This option allows an strftime(3) format	string to be specified
	       for the digital clock's display.

       -twelve This  option  indicates that a digital clock should display the
	       time in twelve hour format.

       -twentyfour
	       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.

       -chime  This option indicates that the clock should chime once  on  the
	       half hour and twice on the hour.

       -hands color (or	-hd color)
	       This  option  specifies	the  color  of	the hands on an	analog
	       clock.  The default  is	black.	 This  option  is  effectively
	       ignored when Xrender is in use.

       -highlight color	(or -hl	color)
	       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  black.   This  option  is effectively ignored when
	       Xrender is in use.

       -update seconds
	       This option specifies the frequency in seconds at which	xclock
	       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.

       -padding	number
	       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.

       -render This option tells xclock	to use the Xrender extension  to  draw
	       an  anti-aliased	 face.	This is	the default if xclock 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.

       -norender
	       This option turns off the use of	Xrender	to draw	the clock.

       -sharp  This option tells xclock	to use sharper edges when drawn	 using
	       the Xrender extension.

       -face pattern
	       This  option specifies the font to use in digital mode when the
	       Xrender extension is used.

X DEFAULTS
       This program uses the Clock widget.  It understands  all	 of  the  core
       resource	names and classes as well as:

       width (class Width)
	       Specifies  the  width  of  the  clock.	The default for	analog
	       clocks is 164 pixels; the default for digital clocks  is	 what-
	       ever  is	 needed	to hold	the clock when displayed in the	chosen
	       font.

       height (class Height)
	       Specifies the height of the  clock.   The  default  for	analog
	       clocks  is  164 pixels; the default for digital clocks is what-
	       ever is needed to hold the clock	when displayed in  the	chosen
	       font.

       update (class Interval)
	       Specifies  the frequency	in seconds at which the	time should be
	       redisplayed.

       foreground (class Foreground)
	       Specifies the color for the tick	marks. The default depends  on
	       whether	reverseVideo  is specified.  If	reverseVideo is	speci-
	       fied the	default	is lwhite, otherwise the default is black.

       hands (class Foreground)
	       Specifies the color of the insides of the  clock's  hands.  The
	       default	depends	 on  whether  reverseVideo  is	specified.  If
	       reverseVideo is specified the default is	lwhite,	otherwise  the
	       default	is  black.   Note  that	this resource is not used when
	       Xrender is in effect.

       highlight (class	Foreground)
	       Specifies the color used	to highlight the  clock's  hands.  The
	       default is
		depends	on whether reverseVideo	is specified.  If reverseVideo
	       is specified the	default	is lwhite, otherwise  the  default  is
	       black.	Note that this resource	is not used when Xrender is in
	       effect.

       analog (class Boolean)
	       Specifies whether or not	an analog clock	should be used instead
	       of a digital one.  The default is True.

       twentyfour (class Boolean)
	       Specifies  whether  or  not  a digital clock should display the
	       time in twenty-four hour	format.	 The default is	True.

       chime (class Boolean)
	       Specifies whether or not	a bell should be rung on the hour  and
	       half hour.

       padding (class Margin)
	       Specifies  the amount of	internal padding in pixels to be used.
	       The default is 8.

       font (class Font)
	       Specifies the font to be	used for the digital clock.  Note that
	       variable	 width	fonts  currently  will not always display cor-
	       rectly.	This font is only used when Xrender is not in  effect.

       render (class Boolean)
	       Specifies  whether  or not the Xrender extension	should be used
	       for the display.	The default is True if xclock  has  been  com-
	       piled with Xrender support.

       When  Xrender  is  in  effect,  the  following additional resources are
       understood:

       face (class FaceName)
	       Specify the pattern for the font	to be  used  for  the  digital
	       clock when Xrender is used.

       sharp (class Boolean)
	       Specifies  if  sharp  edges  should  be used when rendering the
	       clock.  The default is False.

       buffer (class Boolean)
	       Specifies that the updates of the image are drawn to  a	pixmap
	       before  copied  into  the  window instead drawing them into the
	       window directly.

       The defaults of the following color resources depend on whether	rever-
       seVideo	is  specified.	 If  reverseVideo  is specified	the default is
       lwhite, otherwise the default is	black.

       hourColor (class	Foreground)
	       The color of the	hour hand.

       minuteColor (class Foreground)
	       The color of the	minute hand.

       secondColor (class Foreground)
	       The color of the	second hand.

       majorColor (class Foreground)
	       The color of the	major scale ticks (i. e. each five minutes).

       minorColor (class Foreground)
	       The color of the	minor scale ticks (between major ticks).

WIDGETS
       In order	to specify resources, it is useful to know  the	 hierarchy  of
       the  widgets  which compose xclock.  In the notation below, indentation
       indicates hierarchical structure.   The	widget	class  name  is	 given
       first, followed by the widget instance name.

       XClock  xclock
	    Clock  clock

ENVIRONMENT
       DISPLAY to get the default host and display number.

       XENVIRONMENT
	       to  get	the  name of a resource	file that overrides the	global
	       resources stored	in the RESOURCE_MANAGER	property.

FILES
       /usr/X11R6/lib/X11/app-defaults/XClock
	      specifies	required resources

SEE ALSO
       X(7), xrdb(1), time(3C)

BUGS
       Xclock believes the system clock.

       When in digital mode, the string	should be centered automatically.

AUTHORS
       Tony Della Fera (MIT-Athena, DEC)
       Dave Mankins (MIT-Athena, BBN)
       Ed Moy (UC Berkeley)

XFree86				 Version 4.7.0			     XCLOCK(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | X DEFAULTS | WIDGETS | ENVIRONMENT | FILES | SEE ALSO | BUGS | AUTHORS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=xclock&sektion=1&manpath=XFree86+4.7.0>

home | help