1 |
greg |
1.5 |
.\" RCSid "$Id: replmarks.1,v 1.4 2004/04/21 15:01:46 greg Exp $" |
2 |
greg |
1.1 |
.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 |
greg |
1.3 |
| |
19 |
|
|
.B "\-I mesh" |
20 |
greg |
1.1 |
} |
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 |
greg |
1.3 |
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 |
greg |
1.4 |
One of these three options must appear on the command line, along with |
48 |
greg |
1.1 |
.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 |
greg |
1.5 |
replmarks \-x knob.rad knobs input > output |
114 |
greg |
1.1 |
.PP |
115 |
|
|
To use instances of ``tree.oct'' with scaling set to three times the |
116 |
|
|
tree marker length: |
117 |
|
|
.IP "" .2i |
118 |
greg |
1.5 |
replmarks \-s 3 \-i tree.oct tree input > output |
119 |
greg |
1.1 |
.SH AUTHOR |
120 |
|
|
Greg Ward |
121 |
|
|
.SH "SEE ALSO" |
122 |
|
|
arch2rad(1), ies2rad(1), xform(1) |