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
configuration: 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 portion) 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
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 generated with no inside-face
background (by use of the alpha
channel).
-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.
9
digital representation above.
0 255 0 -Tc 128 128 128
rleClock -Fc 255 0 0 -Hc 0 0 255 -lw 3 -ty 96 -tc
Generates a clock with a red inside,
white face, blue hands, wide lines, tall
text field, green test, and grey text
background.
-tf ``%2l.%2.2B''
rleClock -ty 32 -bs 10 -bv 4.51 -ls 100 -lv 45.1
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.
9
- 4 Formatted: July 31, 1996