man/man1/replmarks.1

.\" RCSid "$Id: replmarks.1,v 1.4 2004/04/21 15:01:46 greg Exp $"
.TH REPLMARKS 1 3/24/94 RADIANCE
.SH NAME
replmarks - replace triangular markers in a RADIANCE scene description
.SH SYNOPSIS
.B replmarks
[
.B \-e
][
.B "\-m newmod"
][
.B "\-s scale"
]
{
.B "\-x objfile"
|
.B "\-i octree"
|
.B "\-I mesh"
}
.B "modname .."
[
.B "file .."
]
.SH DESCRIPTION
.I Replmarks
replaces triangular markers identified by the modifier
.I modname
in each scene description
.I file
and writes the result to the standard output.
The
.I \-x
option indicates that each marker should be replaced by an appropriate
.I xform(1)
command on
.I objfile.
The
.I \-i
option indicates that each marker should be replaced by an instance of
.I octree.
The
.I \-I
option indicates that each marker should be replaced by an instance of
the Radiance mesh
.I mesh.
One of these three options must appear on the command line, along with
.I modname,
the modifier used by markers in the file.
.PP
Multiple modifiers may be given, as long as each one is preceded
by its own
.I \-x
or
.I \-i
option.
.PP
The transformation for each marker is determined by its location
and orientation.
A marker should be a right triangle pointing like a half-arrow in
the direction of the transformed x-axis, x'.
The longest side is the hypoteneuse, the second longest side is
the x'-axis, and the third longest side indicates the direction of
the y'-axis.
Any additional sides will be ignored (ie. a quadrilateral may be
used instead of a triangle if the extra side is small).
The z'-axis is determined by the cross product of the x' and y'
axes, and the origin is the common vertex between x' and y'.
.PP
The size of the marker is ignored unless the
.I \-s
option is used, where
.I scale
is a multiplier for the x'-axis length to indicate the total scale
factor.
For example, a
.I scale
value of 5 with a marker length of .5 would result in a total
scale factor of 2.5 to be used in the transformation.
.PP
The
.I \-e
option causes commands in the file to be expanded, and
is required to replace markers from commands in the input file.
Even with this option,
.I replmarks
will not examine objects for markers.
Specifically, an object included by
.I replmarks
as a result of a
.I \-x
expansion will be transferred verbatim, without regard
to any surfaces therein that might have been considered
as marks if they were on the main input.
.PP
The
.I \-m
option causes all replaced objects to be given the modifier
.I newmod.
Otherwise, the new object surfaces will use their originally defined
modifiers.
A different replacement modifier may be given for each marker type.
The marker modifier name itself is only used to identify markers,
and will not appear in the output in any form.
.PP
If no input
.I file
is given, the standard input is read.
.SH EXAMPLE
To replace all polygons with the modifier ``knobs'' in the file input
with a transformed ``knob.rad'' and write the result to output:
.IP "" .2i
replmarks \-x knob.rad knobs input > output
.PP
To use instances of ``tree.oct'' with scaling set to three times the
tree marker length:
.IP "" .2i
replmarks \-s 3 \-i tree.oct tree input > output
.SH AUTHOR
Greg Ward
.SH "SEE ALSO"
arch2rad(1), ies2rad(1), xform(1)
Revision:	1.5
Committed:	Tue Sep 4 17:36:41 2007 UTC (18 years, 2 months ago) by greg
Branch:	MAIN
CVS Tags:	rad6R0, rad5R4, rad5R3, rad5R2, rad5R1, rad5R0, rad4R2P2, rad4R2P1, rad4R2, rad4R1, rad4R0, rad3R9, HEAD
Changes since 1.4:	+3 -3 lines
Log Message:	Added backslashes in front of hyphens (thanks to Bernd Zeimetz for his effort)
#	Content
1	.\" RCSid "$Id: replmarks.1,v 1.4 2004/04/21 15:01:46 greg Exp $"
2	.TH REPLMARKS 1 3/24/94 RADIANCE
3	.SH NAME
4	replmarks - replace triangular markers in a RADIANCE scene description
5	.SH SYNOPSIS
6	.B replmarks
7	[
8	.B \-e
9	][
10	.B "\-m newmod"
11	][
12	.B "\-s scale"
13	]
14	{
15	.B "\-x objfile"
16	\|
17	.B "\-i octree"
18	\|
19	.B "\-I mesh"
20	}
21	.B "modname .."
22	[
23	.B "file .."
24	]
25	.SH DESCRIPTION
26	.I Replmarks
27	replaces triangular markers identified by the modifier
28	.I modname
29	in each scene description
30	.I file
31	and writes the result to the standard output.
32	The
33	.I \-x
34	option indicates that each marker should be replaced by an appropriate
35	.I xform(1)
36	command on
37	.I objfile.
38	The
39	.I \-i
40	option indicates that each marker should be replaced by an instance of
41	.I octree.
42	The
43	.I \-I
44	option indicates that each marker should be replaced by an instance of
45	the Radiance mesh
46	.I mesh.
47	One of these three options must appear on the command line, along with
48	.I modname,
49	the modifier used by markers in the file.
50	.PP
51	Multiple modifiers may be given, as long as each one is preceded
52	by its own
53	.I \-x
54	or
55	.I \-i
56	option.
57	.PP
58	The transformation for each marker is determined by its location
59	and orientation.
60	A marker should be a right triangle pointing like a half-arrow in
61	the direction of the transformed x-axis, x'.
62	The longest side is the hypoteneuse, the second longest side is
63	the x'-axis, and the third longest side indicates the direction of
64	the y'-axis.
65	Any additional sides will be ignored (ie. a quadrilateral may be
66	used instead of a triangle if the extra side is small).
67	The z'-axis is determined by the cross product of the x' and y'
68	axes, and the origin is the common vertex between x' and y'.
69	.PP
70	The size of the marker is ignored unless the
71	.I \-s
72	option is used, where
73	.I scale
74	is a multiplier for the x'-axis length to indicate the total scale
75	factor.
76	For example, a
77	.I scale
78	value of 5 with a marker length of .5 would result in a total
79	scale factor of 2.5 to be used in the transformation.
80	.PP
81	The
82	.I \-e
83	option causes commands in the file to be expanded, and
84	is required to replace markers from commands in the input file.
85	Even with this option,
86	.I replmarks
87	will not examine objects for markers.
88	Specifically, an object included by
89	.I replmarks
90	as a result of a
91	.I \-x
92	expansion will be transferred verbatim, without regard
93	to any surfaces therein that might have been considered
94	as marks if they were on the main input.
95	.PP
96	The
97	.I \-m
98	option causes all replaced objects to be given the modifier
99	.I newmod.
100	Otherwise, the new object surfaces will use their originally defined
101	modifiers.
102	A different replacement modifier may be given for each marker type.
103	The marker modifier name itself is only used to identify markers,
104	and will not appear in the output in any form.
105	.PP
106	If no input
107	.I file
108	is given, the standard input is read.
109	.SH EXAMPLE
110	To replace all polygons with the modifier ``knobs'' in the file input
111	with a transformed ``knob.rad'' and write the result to output:
112	.IP "" .2i
113	replmarks \-x knob.rad knobs input > output
114	.PP
115	To use instances of ``tree.oct'' with scaling set to three times the
116	tree marker length:
117	.IP "" .2i
118	replmarks \-s 3 \-i tree.oct tree input > output
119	.SH AUTHOR
120	Greg Ward
121	.SH "SEE ALSO"
122	arch2rad(1), ies2rad(1), xform(1)