rleClock man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

RLECLOCK(1)							   RLECLOCK(1)

NAME
       rleClock - Generate a clock face in RLE format

SYNOPSIS
       rleClock [ options ] [ -o outfile ]

DESCRIPTION
       This  program  generates an analog clock face in RLE(5) file format and
       writes it to outfile or standard output.	 The  picture  is  a  standard
       clock  face  with  optional digital representation above.  The user has
       control over the colors of the portions of the clock  face,  the	 text,
       and the text background.	 The user also has control over the clock con‐
       figuration: number of ticks, scale of the big  and  little  hands,  the
       values of the big and little hands, and the format used to generate the
       digital portion.

       By default, rleClock generates a standard analog clock face  displaying
       the  current  time  and	with no digital portion.  This default face is
       transparent, that is, the alpha channel is only defined for  the	 clock
       outline, tick marks, and the hands.

       On  those options that expect colors, three numbers must be given after
       the option switch.  These are values for red,  green,  and  blue	 on  a
       scale  of  zero	through 255.  Those color options that are capitalized
       indicate the colors for the filled regions (optional for the clock face
       and  text  but  default for the hands).	Those that are not capitalized
       are for lines that either outline or constitute the feature (the	 clock
       face is default, but they're optional for the hands).

OPTIONS
       -help  Prints a synopsis of the options.

       The options that control the value displayed by the clock are

       -ls FLOAT
	      This  specifies the full scale (360 degrees) of the little hand.
	      Default is 12.

       -lv FLOAT
	      This specifies the value of the little hand, expressed in	 units
	      of the little hand full scale.  Default is the current hour time
	      on a 12-hour scale.

       -bs FLOAT
	      This specifies the full scale (360 degrees)  of  the  big	 hand.
	      Default is 60.

       -bv FLOAT
	      This  specifies the value of the big hand, expressed in units of
	      the big hand full scale.	Default is the current minute time.

       The following options manage the display configuration of the clock:

       -x INT The INT specifies the width of the clock in pixels.  Default  is
	      128.

       -cy INT
	      The  INT specifies the height of the clock face (minus text por‐
	      tion) in pixels.	The default is 128.

       -ty INT
	      The INT specifies the height in pixels of the  text  portion  of
	      the  display.   If  it is zero (the default), no text portion is
	      displayed.

       -t INT This specifies the number of tick	 marks	to  place  around  the
	      clock.  The default is 12.

       -lw INT
	      This  specifies  the line width in pixels of the clock face, the
	      tick marks, the  optional	 hand  borders,	 and  the  text.   The
	      default is one, but two or three give better looking clocks.

       -tf STR
	      The  string  describes  how  to  show the digital portion of the
	      clock.  The rules for forming STR are the	 same  as  for	printf
	      format  strings, that is, a percent sign, optionally followed by
	      field width values, followed by a key letter.  In this case, the
	      key  letter  may be b, l, B, or L.  Lower case b means to insert
	      the integer value of the big hand and  upper  case  B  means  to
	      insert  the  floating point value of the big hand.  Lower case l
	      means to insert the integer value of the little hand  and	 upper
	      case  L  means  to insert the floating point value of the little
	      hand.

       -fc R G B
	      This specifies the color in red, green, and blue, of  the	 clock
	      face.

       -Fc R G B
	      This specifies the color to fill in inside the clock face, under
	      the hands.  If this option is not supplied, the clock is	gener‐
	      ated  with  no inside-face background (by use of the alpha chan‐
	      nel).

       -Hc R G B
	      This specifies the color to draw in the hands with.

       -hc R G B
	      This specifies the color to draw the outlines of the hands.   If
	      it  is  not  given,  no  outlines	 are drawn on the edges of the
	      hands.

       -tc R G B
	      This specifies the color of the text above the clock.   It  only
	      has effect if a text height (-ty) is supplied.

       -Tc R G B
	      This  specifies  the color of a background field to place behind
	      the text.	 If omitted, no background  (zero  alpha  channel)  is
	      drawn.

EXAMPLES
       rleClock
	      Generates	 a transparent clock face showing the current time and
	      no digital representation.

       rleClock -ty 32
	      Generates	 a  current-time  clock	 with  digital	representation
	      above.

       rleClock	 -Fc  255 0 0 -Hc 0 0 255 -lw 3 -ty 96 -tc 0 255 0 -Tc 128 128
       128
	      Generates a clock with a red inside,  white  face,  blue	hands,
	      wide  lines,  tall  text	field, green test, and grey text back‐
	      ground.

       rleClock -ty 32 -bs 10 -bv 4.51 -ls 100 -lv 45.1 -tf "%2l.%2.2B"
	      Generates a clock with the scale of the big hand set to  10  and
	      it's  value  at  4.51, the scale and value of the little hand as
	      100 and 45.1, and the format for the digital  portion  formatted
	      as %2d.%2.2f to print the integer little hand value (two spaces)
	      and the floating point big hand value.

SEE ALSO
       urt(1), RLE(5).

AUTHOR
       Robert L. Brown, RIACS, NASA Ames Research Center

BUGS
       Not thoroughly checked when the line width is  cranked  up.   May  dump
       core.

4th Berkeley Distribution	 Dec 11, 1987			   RLECLOCK(1)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net