man/man1/genclock.1

.\" RCSid "$Id: genclock.1,v 1.3 2004/01/01 19:31:44 greg Exp $"
.TH GENCLOCK 1 4/9/97 RADIANCE
.SH NAME
genclock - generate a RADIANCE description of a clock
.SH SYNOPSIS
.B genclock
[
.B "\-f face_mat"
][
.B "\-c case_mat"
][
.B "\-n name"
]
{
.B HH:MM
|
.B hours
}
.SH DESCRIPTION
.I Genclock
produces a RADIANCE scene description of an analog clock showing the
given hour.
The hour may either be given as
.I HH:MM
or decimal
.I hours.
.PP
The face of the clock will have a radius of 1.0 units, with the
surrounding case 1.1 (2.2 diameter).
The origin is at the center of the back, and the face looks in the
positive X-direction.
The 12 o'clock direction corresponds to the positive Z-axis.
(The Y-axis direction is 3 o'clock.)\0
The
.I xform(1)
command may be used to resize and relocate the clock as desired.
.PP
Normally,
.I genclock
produces all of the materials necessary for its own description, but
options are provided to specify alternate materials for the face and
case.
The numbers on the face are in dark lettering, so the face material
must be relatively light for them to show up well.
By default, the clock is given the name "clock," but this may be
changed with the
.I \-n
option.
.SH EXAMPLE
To produce a 12 inch diameter clock showing 10:35
and hang it at 60 on a wall facing the Y-direction at Y=10:
.IP "" .2i
genclock 10:35 | xform \-s 6 \-rz 90 \-t 20 10 60
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
genbox(1), genrev(1), gensurf(1), genworm(1), rpict(1), rvu(1), xform(1)
Revision:	1.4
Committed:	Tue Sep 4 17:36:40 2007 UTC (18 years, 1 month ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad5R3, rad5R0, rad5R1, rad4R2, rad6R0, rad4R1, rad4R0, rad3R9, rad4R2P1, rad4R2P2, HEAD
Changes since 1.3:	+2 -2 lines
Log Message:	Added backslashes in front of hyphens (thanks to Bernd Zeimetz for his effort)
#	User	Rev	Content
1	greg	1.4	.\" RCSid "$Id: genclock.1,v 1.3 2004/01/01 19:31:44 greg Exp $"
2	greg	1.1	.TH GENCLOCK 1 4/9/97 RADIANCE
3			.SH NAME
4			genclock - generate a RADIANCE description of a clock
5			.SH SYNOPSIS
6			.B genclock
7			[
8			.B "\-f face_mat"
9			][
10			.B "\-c case_mat"
11			][
12			.B "\-n name"
13			]
14			{
15			.B HH:MM
16			\|
17			.B hours
18			}
19			.SH DESCRIPTION
20			.I Genclock
21			produces a RADIANCE scene description of an analog clock showing the
22			given hour.
23			The hour may either be given as
24			.I HH:MM
25			or decimal
26			.I hours.
27			.PP
28			The face of the clock will have a radius of 1.0 units, with the
29			surrounding case 1.1 (2.2 diameter).
30			The origin is at the center of the back, and the face looks in the
31			positive X-direction.
32			The 12 o'clock direction corresponds to the positive Z-axis.
33			(The Y-axis direction is 3 o'clock.)\0
34			The
35			.I xform(1)
36			command may be used to resize and relocate the clock as desired.
37			.PP
38			Normally,
39			.I genclock
40			produces all of the materials necessary for its own description, but
41			options are provided to specify alternate materials for the face and
42			case.
43			The numbers on the face are in dark lettering, so the face material
44			must be relatively light for them to show up well.
45			By default, the clock is given the name "clock," but this may be
46			changed with the
47			.I \-n
48			option.
49			.SH EXAMPLE
50			To produce a 12 inch diameter clock showing 10:35
51			and hang it at 60 on a wall facing the Y-direction at Y=10:
52			.IP "" .2i
53	greg	1.4	genclock 10:35 \| xform \-s 6 \-rz 90 \-t 20 10 60
54	greg	1.1	.SH AUTHOR
55			Greg Ward
56			.SH "SEE ALSO"
57	greg	1.3	genbox(1), genrev(1), gensurf(1), genworm(1), rpict(1), rvu(1), xform(1)