ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/src/cv/mgflib/mgfdoc.tr
(Generate patch)

Comparing src/cv/mgflib/mgfdoc.tr (file contents):
Revision 1.1 by greg, Fri May 12 14:26:12 1995 UTC vs.
Revision 1.9 by greg, Wed Nov 22 12:23:27 1995 UTC

# Line 431 | Line 431 | Since the arguments are concise and self-explanatory,
431   sufficient.
432   The following transformation flags and
433   parameters are defined:
434 < .TS I
434 > .TS
435 > center;
436   l l.
437   -t dx dy dz     translate objects along the given vector
438   -rx degrees     rotate objects about the X-axis
# Line 546 | Line 547 | Detailed MGF Example
547   The following example of a simple room with a single door
548   and six file cabinets shows MGF in action, with copious comments to
549   help explain what's going on.
550 + .LP
551   .DS
552   # "ceiling_tile" is a diffuse white surface with 75% reflectance:
553   # Create new named material context and clear it
# Line 744 | Line 746 | o door
746          o
747   o
748  
747 –        i cubfurn.inc -mx -t 405 133.5 0
748 – o
749 –
749   # Six file cabinets (36" wide each)
750   # ("filecab.inc" was given as an earlier example in Section 1.2)
751   o filecab.x
# Line 772 | Line 771 | There are currently 28 entities in the MGF specificati
771   For ease of reference we have broken these into five categories:
772   .IP 1.
773   General
774 < .TS I
774 > .TS
775   lw(.75i) lw(1.75i) lw(3i).
776   #       [anything ...]  a comment
777   o       [name]  begin/end object context
# Line 782 | Line 781 | ies    pathname [-m f][xform]  include IES luminaire (with
781   .TE
782   .IP 2.
783   Color
784 < .TS I
784 > .TS
785   lw(.75i) lw(1.75i) lw(3i).
786   c       [id [= [template]]]     get/set color context
787   cxy     x y     set CIE (x,y) chromaticity for current color
# Line 1267 | Line 1266 | corresponds to the measurement at
1266   Values in between are separated by
1267   .I "(l_max-l_min)/(N-1)"
1268   nanometers.
1269 < All values must be non-negative, and the spectrum outside of the
1269 > All values should be non-negative unless defining a component for
1270 > complementary color mixing, and the spectrum outside of the
1271   specified range is assumed to be zero.
1272   (The visible range is 380 to 780 nm.)\0
1273   The actual units and scale of the measurements do not matter,
# Line 2226 | Line 2226 | o stylus
2226                  p 0 0 .005
2227          v vend =
2228                  p 0 0 .05
2229 <        cyl vtip1 .0015
2229 >        cyl vtip1 .0015 vend
2230          sph vend .0015
2231          cone vtip0 0 vtip1 .0015
2232   o
# Line 2388 | Line 2388 | ring - create a circular ring with inner and outer rad
2388   .SH
2389   SYNOPSIS
2390   .LP
2391 < .B cyl
2391 > .B ring
2392   .I "vc rmin rmax"
2393   .SH
2394   DESCRIPTION
# Line 2567 | Line 2567 | In the first form, a single integer is given for the
2567   of MGF that is to be produced.
2568   Since MGF is in its first major release, this is not yet a useful
2569   form, but it will be when the second major release comes out.
2570 + This has the necessary side-effect of expanding all included files.
2571 + (See the
2572 + .UL i
2573 + entity.)\0
2574   .LP
2575   In the second form,
2576   .I mgfilt
# Line 2591 | Line 2595 | mgfilt f,v,p,xf input.mgf > flatpoly.mgf
2595   .SH
2596   SEE ALSO
2597   .LP
2598 < mgf2rad, rad2mgf
2598 > i, mgf2rad, rad2mgf
2599   .ds RH MGF2RAD
2600   .bp
2601   .SH
# Line 2695 | Line 2699 | Greg Ward
2699   SEE ALSO
2700   .LP
2701   ies2rad(1), mgf2meta(1), obj2rad(1), oconv(1), rad2mgf(1), xform(1)
2702 < .ds RH
2699 < RAD2MGF
2702 > .ds RH RAD2MGF
2703   .bp
2704   .SH
2705   NAME
# Line 2985 | Line 2988 | char   **av;
2988  
2989          if (ac < 4)                     /* check # arguments */
2990                  return(MG_EARGC);
2991 <        printf("face\n");               /* begin face output */
2991 >        printf("face\\\\n");            /* begin face output */
2992          for (i = 1; i < ac; i++) {
2993                  if ((vp = c_getvert(av[i])) == NULL)    /* vertex from name */
2994                          return(MG_EUNDEF);
2995                  xf_xfmpoint(vert, vp->p);                       /* apply transform */
2996 <                printf("%15.9f %15.9f %15.9f\n",
2996 >                printf("%15.9f %15.9f %15.9f\\\\n",
2997                          vert[0], vert[1], vert[2]);                     /* output vertex */
2998          }
2999 <        printf(";\\n");                 /* end of face output */
2999 >        printf(";\\\\n");                       /* end of face output */
3000          return(MG_OK);                  /* normal exit */
3001   }
3002  
# Line 3122 | Line 3125 | following:
3125   #define MG_E_CMIX               4               /* cmix */
3126   #define MG_E_CSPEC              5               /* cspec        */
3127   #define MG_E_CXY                6               /* cxy          */
3128 < #define MG_E_CYL                7               /* cyl  */
3128 > #define MG_E_CYL                7               /* cyl          */
3129   #define MG_E_ED         8               /* ed           */
3130   #define MG_E_FACE               9               /* f            */
3131   #define MG_E_INCLUDE    10              /* i            */
3132   #define MG_E_IES                11              /* ies          */
3133 < #define MG_E_IR         12              /* ir           */
3133 > #define MG_E_IR                 12              /* ir           */
3134   #define MG_E_MATERIAL   13              /* m            */
3135   #define MG_E_NORMAL     14              /* n            */
3136   #define MG_E_OBJECT     15              /* o            */
# Line 3267 | Line 3270 | and return one of the non-zero values from "parser.h"
3270   #define MG_EUNK         1               /* unknown entity */
3271   #define MG_EARGC                2               /* wrong number of arguments */
3272   #define MG_ETYPE                3               /* argument type error */
3273 < #define MG_EILL         4               /* illegal argument value */
3273 > #define MG_EILL                         4               /* illegal argument value */
3274   #define MG_EUNDEF               5               /* undefined reference */
3275   #define MG_ENOFILE              6               /* cannot open input file */
3276   #define MG_EINCL                7               /* error in included file */
3277   #define MG_EMEM         8               /* out of memory */
3278   #define MG_ESEEK                9               /* file seek error */
3279   #define MG_EBADMAT      10              /* bad material specification */
3280 + #define MG_ELINE                11              /* input line too long */
3281  
3282 < #define MG_NERRS        11
3282 > #define MG_NERRS        12
3283   .DE
3284   If it is inappropriate to send output to standard error, the calling
3285   program should use the routines listed under
# Line 3289 | Line 3293 | listed above in the native country's language.
3293   .SH
3294   SEE ALSO
3295   .LP
3296 < mg_fgetpos, mg_handle, mg_init
3296 > mg_fgetpos, mg_handle, mg_init, mg_open
3297   .ds RH MG_OPEN
3298   .bp
3299   .SH
# Line 3359 | Line 3363 | The
3363   function reads the next input line from the current file,
3364   returning the number of characters in the line, or zero if the
3365   end of file is reached or there is a file error.
3366 + If the last character read in the input line is not a newline,
3367 + then the input line was too long, and you
3368 + should return an MG_ELINE error.
3369   The function skips over escaped newlines, and keeps track of the
3370   line number in the current file context
3371   .I mg_file,
# Line 4275 | Line 4282 | mg_init, mg_load, obj_handler, xf_xfmpoint
4282   .SH
4283   NAME
4284   .LP
4285 < xf_xfmpoint xf_xfmvect, xf_rotvect, xf_scale - apply current
4285 > xf_xfmpoint, xf_xfmvect, xf_rotvect, xf_scale - apply current
4286   transformation
4287   .SH
4288   SYNOPSIS
# Line 4304 | Line 4311 | to the point
4311   .I pold,
4312   scaling, rotating and moving it to its proper location, which is put in
4313   .I pnew.
4314 < (The two arguments may point to the same vector.)\0
4314 > (As for
4315 > .I xf_xfmvect
4316 > and
4317 > .I xf_rotvect,
4318 > the two arguments may point to the same vector.)\0
4319   .LP
4320   The
4321   .I xf_xfmvect
# Line 4312 | Line 4323 | routine applies the current transformation to the vect
4323   .I vold,
4324   scaling and rotating it to its proper location, which is put in
4325   .I vnew.
4315 – (The two arguments may point to the same vector.)\0
4326   The only difference between
4327   .I xf_xfmpoint
4328   and
# Line 4325 | Line 4335 | routine rotates the vector
4335   .I nold
4336   using the current transformation, and stores the result in
4337   .I nnew.
4328 – (The two arguments may point to the same vector.)\0
4338   No translation or scaling is applied, which is the appropriate
4339   action for surface normal vectors for example.
4340   .LP
# Line 4486 | Line 4495 | and adopt the following code to convert between CIE an
4495   #define  CIE_y_w                0.3333
4496   #endif
4497  
4498 < #define CIE_D           (       CIE_x_r*(CIE_y_g - CIE_y_b) + \\\\
4499 <                                CIE_x_g*(CIE_y_b - CIE_y_r) + \\\\
4498 > #define CIE_D           (       CIE_x_r*(CIE_y_g - CIE_y_b) + \\
4499 >                                CIE_x_g*(CIE_y_b - CIE_y_r) + \\
4500                                  CIE_x_b*(CIE_y_r - CIE_y_g)     )
4501 < #define CIE_C_rD        ( (1./CIE_y_w) * \\\\
4502 <                                ( CIE_x_w*(CIE_y_g - CIE_y_b) - \\\\
4503 <                                  CIE_y_w*(CIE_x_g - CIE_x_b) + \\\\
4501 > #define CIE_C_rD        ( (1./CIE_y_w) * \\
4502 >                                ( CIE_x_w*(CIE_y_g - CIE_y_b) - \\
4503 >                                  CIE_y_w*(CIE_x_g - CIE_x_b) + \\
4504                                    CIE_x_g*CIE_y_b - CIE_x_b*CIE_y_g     ) )
4505 < #define CIE_C_gD        ( (1./CIE_y_w) * \\\\
4506 <                                ( CIE_x_w*(CIE_y_b - CIE_y_r) - \\\\
4507 <                                  CIE_y_w*(CIE_x_b - CIE_x_r) - \\\\
4505 > #define CIE_C_gD        ( (1./CIE_y_w) * \\
4506 >                                ( CIE_x_w*(CIE_y_b - CIE_y_r) - \\
4507 >                                  CIE_y_w*(CIE_x_b - CIE_x_r) - \\
4508                                    CIE_x_r*CIE_y_b + CIE_x_b*CIE_y_r     ) )
4509 < #define CIE_C_bD        ( (1./CIE_y_w) * \\\\
4510 <                                ( CIE_x_w*(CIE_y_r - CIE_y_g) - \\\\
4511 <                                  CIE_y_w*(CIE_x_r - CIE_x_g) + \\\\
4509 > #define CIE_C_bD        ( (1./CIE_y_w) * \\
4510 >                                ( CIE_x_w*(CIE_y_r - CIE_y_g) - \\
4511 >                                  CIE_y_w*(CIE_x_r - CIE_x_g) + \\
4512                                    CIE_x_r*CIE_y_g - CIE_x_g*CIE_y_r     ) )
4513  
4514   #define CIE_rf          (CIE_y_r*CIE_C_rD/CIE_D)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines