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

FreeBSD Manual Pages

  
 
  

home | help
XCLOCK(1)		    General Commands Manual		     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  op-
	       tions 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 ig-
	       nored 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 de-
	       fault is	black.	This option is effectively ignored when	 Xren-
	       der 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  de-
	       fault is	60 seconds.

       -padding	number
	       This  option  specifies	the width in pixels of the padding be-
	       tween 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 re-
       source 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  re-
	       verseVideo  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 un-
       derstood:

       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:
<https://www.freebsd.org/cgi/man.cgi?query=xclock&sektion=1&manpath=XFree86+4.7.0>

home | help