1 |
.\" RCSid "$Id" |
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 "modname .." |
20 |
[ |
21 |
.B "file .." |
22 |
] |
23 |
.SH DESCRIPTION |
24 |
.I Replmarks |
25 |
replaces triangular markers identified by the modifier |
26 |
.I modname |
27 |
in each scene description |
28 |
.I file |
29 |
and writes the result to the standard output. |
30 |
The |
31 |
.I \-x |
32 |
option indicates that each marker should be replaced by an appropriate |
33 |
.I xform(1) |
34 |
command on |
35 |
.I objfile. |
36 |
The |
37 |
.I \-i |
38 |
option indicates that each marker should be replaced by an instance of |
39 |
.I octree. |
40 |
One of these two options must appear on the command line, along with |
41 |
.I modname, |
42 |
the modifier used by markers in the file. |
43 |
.PP |
44 |
Multiple modifiers may be given, as long as each one is preceded |
45 |
by its own |
46 |
.I \-x |
47 |
or |
48 |
.I \-i |
49 |
option. |
50 |
.PP |
51 |
The transformation for each marker is determined by its location |
52 |
and orientation. |
53 |
A marker should be a right triangle pointing like a half-arrow in |
54 |
the direction of the transformed x-axis, x'. |
55 |
The longest side is the hypoteneuse, the second longest side is |
56 |
the x'-axis, and the third longest side indicates the direction of |
57 |
the y'-axis. |
58 |
Any additional sides will be ignored (ie. a quadrilateral may be |
59 |
used instead of a triangle if the extra side is small). |
60 |
The z'-axis is determined by the cross product of the x' and y' |
61 |
axes, and the origin is the common vertex between x' and y'. |
62 |
.PP |
63 |
The size of the marker is ignored unless the |
64 |
.I \-s |
65 |
option is used, where |
66 |
.I scale |
67 |
is a multiplier for the x'-axis length to indicate the total scale |
68 |
factor. |
69 |
For example, a |
70 |
.I scale |
71 |
value of 5 with a marker length of .5 would result in a total |
72 |
scale factor of 2.5 to be used in the transformation. |
73 |
.PP |
74 |
The |
75 |
.I \-e |
76 |
option causes commands in the file to be expanded, and |
77 |
is required to replace markers from commands in the input file. |
78 |
Even with this option, |
79 |
.I replmarks |
80 |
will not examine objects for markers. |
81 |
Specifically, an object included by |
82 |
.I replmarks |
83 |
as a result of a |
84 |
.I \-x |
85 |
expansion will be transferred verbatim, without regard |
86 |
to any surfaces therein that might have been considered |
87 |
as marks if they were on the main input. |
88 |
.PP |
89 |
The |
90 |
.I \-m |
91 |
option causes all replaced objects to be given the modifier |
92 |
.I newmod. |
93 |
Otherwise, the new object surfaces will use their originally defined |
94 |
modifiers. |
95 |
A different replacement modifier may be given for each marker type. |
96 |
The marker modifier name itself is only used to identify markers, |
97 |
and will not appear in the output in any form. |
98 |
.PP |
99 |
If no input |
100 |
.I file |
101 |
is given, the standard input is read. |
102 |
.SH EXAMPLE |
103 |
To replace all polygons with the modifier ``knobs'' in the file input |
104 |
with a transformed ``knob.rad'' and write the result to output: |
105 |
.IP "" .2i |
106 |
replmarks -x knob.rad knobs input > output |
107 |
.PP |
108 |
To use instances of ``tree.oct'' with scaling set to three times the |
109 |
tree marker length: |
110 |
.IP "" .2i |
111 |
replmarks -s 3 -i tree.oct tree input > output |
112 |
.SH AUTHOR |
113 |
Greg Ward |
114 |
.SH "SEE ALSO" |
115 |
arch2rad(1), ies2rad(1), xform(1) |