[ViewVC] Diff of: radiance/src/cv/mgflib/mgfdoc.tr

Comparing src/cv/mgflib/mgfdoc.tr (file contents):
Revision 1.1 by greg, Fri May 12 14:26:12 1995 UTC vs.
Revision 1.12 by greg, Mon Dec 4 12:27:04 1995 UTC

+sufficient.
+The following transformation flags and
+parameters are defined:
-<
+.TS I
->
+.TS
->
+center;
+l l.
+-t dx dy dz     translate objects along the given vector
+-rx degrees     rotate objects about the X-axis
+The following example of a simple room with a single door
+and six file cabinets shows MGF in action, with copious comments to
+help explain what's going on.
-+
+.LP
+.DS
+# "ceiling_tile" is a diffuse white surface with 75% reflectance:
+# Create new named material context and clear it
-–
+        i cubfurn.inc -mx -t 405 133.5 0
-–
+o
-–
+# Six file cabinets (36" wide each)
+# ("filecab.inc" was given as an earlier example in Section 1.2)
+o filecab.x
+For ease of reference we have broken these into five categories:
+.IP 1.
+General
-<
+.TS I
->
+.TS
+lw(.75i) lw(1.75i) lw(3i).
+#       [anything ...]  a comment
+o       [name]  begin/end object context
+.TE
+.IP 2.
+Color
-<
+.TS I
->
+.TS
+lw(.75i) lw(1.75i) lw(3i).
+c       [id [= [template]]]     get/set color context
+cxy     x y     set CIE (x,y) chromaticity for current color
+Values in between are separated by
+.I "(l_max-l_min)/(N-1)"
+nanometers.
-<
+All values must be non-negative, and the spectrum outside of the
->
+All values should be non-negative unless defining a component for
->
+complementary color mixing, and the spectrum outside of the
+specified range is assumed to be zero.
+(The visible range is 380 to 780 nm.)\0
+The actual units and scale of the measurements do not matter,
+                p 0 0 .005
+        v vend =
+                p 0 0 .05
-<
+        cyl vtip1 .0015
->
+        cyl vtip1 .0015 vend
+        sph vend .0015
+        cone vtip0 0 vtip1 .0015
+.SH
+SYNOPSIS
+.LP
-<
+.B cyl
->
+.B ring
+.I "vc rmin rmax"
+.SH
+DESCRIPTION
+.NH
+MGF Translators
+.LP
-<
+Initially, there are four translators for MGF data, but only
-<
+one of these is distributed with the MGF parser itself,
-<
+.I mgfilt.
->
+Initially, there are five translators for MGF data, but only
->
+two of these are distributed with the MGF parser itself,
->
+.I mgfilt
->
+and
->
+.I mgf2inv.
+Two of the other translators,
+.I mgf2rad
+and
+nestor.epfl.ch, or by WWW from
+"http://radsite.lbl.gov/radiance/HOME.html"
+.FE
-<
+A third translator,
->
+The fifth translator,
+.I mgf2meta,
+converts to a 2-dimensional line plot, and is also
+distributed with Radiance.
+In future releases of MGF, this utility will also be handy for
+taking new entities and producing older versions of MGF for
+translators that have not yet been updated properly.
-+
+.LP
-+
+Mgf2inv converts from MGF to Inventor or VRML format.
-+
+Some information is lost, because these formats do not support
-+
+physical light sources or materials.
+.ds LH Translators
+.ds RH MGFILT
+.bp
+of MGF that is to be produced.
+Since MGF is in its first major release, this is not yet a useful
+form, but it will be when the second major release comes out.
-+
+This has the necessary side-effect of expanding all included files.
-+
+(See the
-+
+.UL i
-+
+entity.)\0
+.LP
+In the second form,
+.I mgfilt
+.SH
+SEE ALSO
+.LP
-<
+mgf2rad, rad2mgf
->
+i, mgf2inv, mgf2rad, rad2mgf
->
+.ds RH MGF2INV
->
+.bp
->
+.SH
->
+NAME
->
+.LP
->
+mgf2inv - convert from MGF to Inventor or VRML format
->
+.SH
->
+SYNOPSIS
->
+.LP
->
+.B mgf2inv
->
+[
->
+.B "-1|-2|-vrml"
->
+]
->
+[
->
+.B input ..
->
+]
->
+.SH
->
+DESCRIPTION
->
+.LP
->
+.I Mgf2inv
->
+takes one or more MGF input files and converts it to
->
+Inventor or VRML format.
->
+If the
->
+.I \-1
->
+option is used, then Inventor 1.0 ASCII output is produced.
->
+If the
->
+.I \-2
->
+option is used, then Inventor 2.0 ASCII output is produced.
->
+(This is the default.)\0
->
+If the
->
+.I \-vrml
->
+option is used, then VRML 1.0 ASCII output is produced.
->
+.LP
->
+This converter does not work properly for light sources, since
->
+the output formats do not support IES-type luminaires with recorded
->
+distributions.
->
+Also, some material information may be lost because Inventor lacks
->
+a physically valid reflectance model.
->
+.SH
->
+EXAMPLES
->
+.LP
->
+To take an MGF file and convert it to VRML format:
->
+.IP
->
+mgf2inv -vrml myscene.mgf > myscene.iv
->
+.SH
->
+SEE ALSO
->
+.LP
->
+mgf2rad, mgfilt, rad2mgf
+.ds RH MGF2RAD
+.bp
+.SH
+SEE ALSO
+.LP
+ies2rad(1), mgf2meta(1), obj2rad(1), oconv(1), rad2mgf(1), xform(1)
-<
+.ds RH
-<
+RAD2MGF
->
+.ds RH RAD2MGF
+.bp
+.SH
+NAME
+        if (ac < 4)                     /* check # arguments */
+                return(MG_EARGC);
-<
+        printf("face\n");               /* begin face output */
->
+        printf("face\\\\n");            /* begin face output */
+        for (i = 1; i < ac; i++) {
+                if ((vp = c_getvert(av[i])) == NULL)    /* vertex from name */
+                        return(MG_EUNDEF);
+                xf_xfmpoint(vert, vp->p);                       /* apply transform */
-<
+                printf("%15.9f %15.9f %15.9f\n",
->
+                printf("%15.9f %15.9f %15.9f\\\\n",
+                        vert[0], vert[1], vert[2]);                     /* output vertex */
-<
+        printf(";\\n");                 /* end of face output */
->
+        printf(";\\\\n");                       /* end of face output */
+        return(MG_OK);                  /* normal exit */
+#define MG_E_CMIX               4               /* cmix */
+#define MG_E_CSPEC              5               /* cspec        */
+#define MG_E_CXY                6               /* cxy          */
-<
+#define MG_E_CYL                7               /* cyl  */
->
+#define MG_E_CYL                7               /* cyl          */
+#define MG_E_ED         8               /* ed           */
+#define MG_E_FACE               9               /* f            */
+#define MG_E_INCLUDE    10              /* i            */
+#define MG_E_IES                11              /* ies          */
-<
+#define MG_E_IR         12              /* ir           */
->
+#define MG_E_IR                 12              /* ir           */
+#define MG_E_MATERIAL   13              /* m            */
+#define MG_E_NORMAL     14              /* n            */
+#define MG_E_OBJECT     15              /* o            */
+#define MG_EUNK         1               /* unknown entity */
+#define MG_EARGC                2               /* wrong number of arguments */
+#define MG_ETYPE                3               /* argument type error */
-<
+#define MG_EILL         4               /* illegal argument value */
->
+#define MG_EILL                         4               /* illegal argument value */
+#define MG_EUNDEF               5               /* undefined reference */
+#define MG_ENOFILE              6               /* cannot open input file */
+#define MG_EINCL                7               /* error in included file */
+#define MG_EMEM         8               /* out of memory */
+#define MG_ESEEK                9               /* file seek error */
+#define MG_EBADMAT      10              /* bad material specification */
-+
+#define MG_ELINE                11              /* input line too long */
-+
+#define MG_ECNTXT               12              /* unmatched context close */
-<
+#define MG_NERRS        11
->
+#define MG_NERRS        13
+.DE
+If it is inappropriate to send output to standard error, the calling
+program should use the routines listed under
+.SH
+SEE ALSO
+.LP
-<
+mg_fgetpos, mg_handle, mg_init
->
+mg_fgetpos, mg_handle, mg_init, mg_open
+.ds RH MG_OPEN
+.bp
+.SH
+function reads the next input line from the current file,
+returning the number of characters in the line, or zero if the
+end of file is reached or there is a file error.
-<
+The function skips over escaped newlines, and keeps track of the
->
+If the value returned equals MG_MAXLINE-1,
->
+then the input line was too long, and you
->
+should return an MG_ELINE error.
->
+The function keeps track of the
+line number in the current file context
+.I mg_file,
+which also contains the line that was read.
+.SH
+NAME
+.LP
-<
+xf_xfmpoint xf_xfmvect, xf_rotvect, xf_scale - apply current
->
+xf_xfmpoint, xf_xfmvect, xf_rotvect, xf_scale - apply current
+transformation
+.SH
+SYNOPSIS
+.I pold,
+scaling, rotating and moving it to its proper location, which is put in
+.I pnew.
-<
+(The two arguments may point to the same vector.)\0
->
+(As for
->
+.I xf_xfmvect
->
+and
->
+.I xf_rotvect,
->
+the two arguments may point to the same vector.)\0
+.LP
+The
+.I xf_xfmvect
+.I vold,
+scaling and rotating it to its proper location, which is put in
+.I vnew.
-–
+(The two arguments may point to the same vector.)\0
+The only difference between
+.I xf_xfmpoint
+and
+.I nold
+using the current transformation, and stores the result in
+.I nnew.
-–
+(The two arguments may point to the same vector.)\0
+No translation or scaling is applied, which is the appropriate
+action for surface normal vectors for example.
+.LP
+#define  CIE_y_w                0.3333
+#endif
-<
+#define CIE_D           (       CIE_x_r*(CIE_y_g - CIE_y_b) + \\\\
-<
+                                CIE_x_g*(CIE_y_b - CIE_y_r) + \\\\
->
+#define CIE_D           (       CIE_x_r*(CIE_y_g - CIE_y_b) + \\
->
+                                CIE_x_g*(CIE_y_b - CIE_y_r) + \\
+                                CIE_x_b*(CIE_y_r - CIE_y_g)     )
-<
+#define CIE_C_rD        ( (1./CIE_y_w) * \\\\
-<
+                                ( CIE_x_w*(CIE_y_g - CIE_y_b) - \\\\
-<
+                                  CIE_y_w*(CIE_x_g - CIE_x_b) + \\\\
->
+#define CIE_C_rD        ( (1./CIE_y_w) * \\
->
+                                ( CIE_x_w*(CIE_y_g - CIE_y_b) - \\
->
+                                  CIE_y_w*(CIE_x_g - CIE_x_b) + \\
+                                  CIE_x_g*CIE_y_b - CIE_x_b*CIE_y_g     ) )
-<
+#define CIE_C_gD        ( (1./CIE_y_w) * \\\\
-<
+                                ( CIE_x_w*(CIE_y_b - CIE_y_r) - \\\\
-<
+                                  CIE_y_w*(CIE_x_b - CIE_x_r) - \\\\
->
+#define CIE_C_gD        ( (1./CIE_y_w) * \\
->
+                                ( CIE_x_w*(CIE_y_b - CIE_y_r) - \\
->
+                                  CIE_y_w*(CIE_x_b - CIE_x_r) - \\
+                                  CIE_x_r*CIE_y_b + CIE_x_b*CIE_y_r     ) )
-<
+#define CIE_C_bD        ( (1./CIE_y_w) * \\\\
-<
+                                ( CIE_x_w*(CIE_y_r - CIE_y_g) - \\\\
-<
+                                  CIE_y_w*(CIE_x_r - CIE_x_g) + \\\\
->
+#define CIE_C_bD        ( (1./CIE_y_w) * \\
->
+                                ( CIE_x_w*(CIE_y_r - CIE_y_g) - \\
->
+                                  CIE_y_w*(CIE_x_r - CIE_x_g) + \\
+                                  CIE_x_r*CIE_y_g - CIE_x_g*CIE_y_r     ) )
+#define CIE_rf          (CIE_y_r*CIE_C_rD/CIE_D)

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines (old)
->
+Changed lines (new)

Comparing src/cv/mgflib/mgfdoc.tr (file contents): Revision 1.1 by greg, Fri May 12 14:26:12 1995 UTC vs. Revision 1.12 by greg, Mon Dec 4 12:27:04 1995 UTC

Diff Legend

Comparing src/cv/mgflib/mgfdoc.tr (file contents):
Revision 1.1 by greg, Fri May 12 14:26:12 1995 UTC vs.
Revision 1.12 by greg, Mon Dec 4 12:27:04 1995 UTC