NAME

       rad2mgf - convert RADIANCE scene description to Materials and Geometry Format

SYNOPSIS

       rad2mgf [ -dU ] [ input ..  ]

DESCRIPTION

       Rad2mgf  converts  one  or  more  RADIANCE scene files to the Materials and Geometry Format (MGF).  Input
       units are specified with the -mU option, where U is one of 'm' (meters), 'c' (centimeters), 'f' (feet) or
       'i' (inches).  The assumed unit is meters, which is the required output unit for MGF (thus  the  need  to
       know).   If the input dimensions are in none of these units, then the user should apply xform(1) with the
       -s option to bring the units into line prior to translation.

       The MGF material names and properties for the  surfaces  will  be  those  assigned  in  RADIANCE.   If  a
       referenced  material  has  not  been  defined,  then  its  name will be invoked in the MGF output without
       definition, and the description will be incomplete.

LIMITATIONS

       Although MGF supports all of the geometric types and the most common material  types  used  in  RADIANCE,
       there  is  currently  no  support for advanced BRDF materials, patterns, textures or mixtures.  Also, the
       special types "source" and "antimatter" are not supported, and all light source materials  are  converted
       to  simple  diffuse  emitters (except "illum" materials, which are converted to their alternates).  These
       primitives are reproduced as comments in the output and must be replaced manually if necessary.

       The RADIANCE "instance" and "mesh" types aretreated specially.  Rad2mgf converts each instance or mesh to
       an MGF include statement, using the corresponding transformation and a file name derived from the  octree
       or  mesh name.  (The original octree/mesh suffix is replaced by ".mgf".)  For this to work, the user must
       separately create the referenced MGF files from the original RADIANCE descriptions.  The description file
       names can usually be determined using the getinfo(1) command run on the octrees in question.

EXAMPLE

       To convert three RADIANCE files (in feet) to one MGF file:

         rad2mgf -df file1.rad file2.rad file3.rad > scene.mgf

       To translate a RADIANCE materials file to MGF:

         rad2mgf materials.rad > materials.mgf

AUTHOR

       Greg Ward

SEE ALSO

       getinfo(1), ies2rad(1), mgf2meta(1), mgf2rad(1), obj2rad(1), oconv(1), xform(1)

       MGF web site "http://radsite.lbl.gov/mgf/HOME.html"

RADIANCE                                             5/15/95                                          RAD2MGF(1)