ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/mgf2meta.1
Revision: 1.1
Committed: Tue Mar 11 19:20:21 2003 UTC (21 years, 2 months ago) by greg
Branch: MAIN
CVS Tags: rad3R5
Log Message:
Added documentation to repository

File Contents

# User Rev Content
1 greg 1.1 .\" RCSid "$Id"
2     .TH MGF2META 1 11/20/95 RADIANCE
3     .SH NAME
4     mgf2meta - convert Materials and Geometry Format file to Metafile graphics
5     .SH SYNOPSIS
6     .B mgf2meta
7     [
8     .B "-t threshold"
9     ]
10     .B "{x|y|z} xmin xmax ymin ymax zmin zmax"
11     [
12     .B input ..
13     ]
14     .SH DESCRIPTION
15     .I Mgf2meta
16     converts one or more Materials and Geometry Format (MGF)
17     files to a 2-D orthographic projection along the selected axis in the
18     .I metafile(1)
19     graphics format.
20     All geometry is clipped to the specified bounding box, and the
21     resulting orientation is as follows:
22     .sp .5
23     .nf
24     Projection Orientation
25     ========== ===========
26     x Y-axis right, Z-axis up
27     y Z-axis right, X-axis up
28     z X-axis right, Y-axis up
29     .fi
30     .PP
31     If multiple input files are given, the first file prints in black,
32     the second prints in red, the third in green and the fourth in blue.
33     If more than four input files are given, they cycle through the
34     colors again in three other line types: dashed, dotted and
35     dot-dashed.
36     .PP
37     The
38     .I \-t
39     option may be used to randomly throw out line segments that are
40     shorter than the given
41     .I threshold
42     (given as a fraction of the plot width).
43     Segments are included with a
44     probability equal to the square of the line length over the square
45     of the threshold.
46     This can greatly reduce the number of lines in the drawing (and
47     therefore improve the drawing speed) with only a modest loss in
48     quality.
49     A typical value for this parameter is 0.005.
50     .PP
51     All MGF material information is ignored on the input.
52     .SH EXAMPLE
53     To project two MGF files along the Z-axis and display them under
54     X11:
55     .IP "" .2i
56     mgf2meta z 0 10 0 15 0 9 building1.mgf building2.mgf | x11meta -r
57     .PP
58     To convert a RADIANCE scene to a line drawing in RADIANCE picture
59     format:
60     .IP "" .2i
61     rad2mgf scene.rad | mgf2meta x `getbbox -h scene.rad` | meta2tga |
62     ra_t8 -r > scene.pic
63     .SH AUTHOR
64     Greg Ward
65     .SH "SEE ALSO"
66     getbbox(1), meta2tga(1), metafile(5), mgf2rad(1), pflip(1),
67     protate(1), psmeta(1), ra_t8(1), rad2mgf(1), t4014(1), x11meta(1)
68     .PP
69     MGF web site "http://radsite.lbl.gov/mgf/HOME.html"