1 |
.\" RCSid "$Id: replmarks.1,v 1.3 2004/01/29 22:20:31 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) |