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"