home *** CD-ROM | disk | FTP | other *** search
/ AP Professional Graphics CD-ROM Library / AP Professional Graphics CD-ROM Library.iso / pc / unix / appendix / errata3.txt < prev    next >
Encoding:
Text File  |  1994-12-13  |  7.4 KB  |  213 lines
  1. Errata to _Graphics Gems III_, first edition, edited by David Kirk
  2. (dk@egg.gg.caltech.edu), Academic Press 1992.  Code available online in
  3. princeton.edu:pub/Graphics/GraphicsGems/GemsIII.
  4.  
  5. compiled by Eric Haines (erich@eye.com) from author and reader contributions
  6.  
  7. version 1.6
  8. date:  12/13/94
  9.  
  10. -----
  11.  
  12. Errors in the text:
  13.  
  14. p. 285, third paragraph, first sentence:  change "with the complement of the
  15.     residency mask" to "with the residency mask".
  16.  
  17. -----
  18.  
  19. The following are errors in the code listings (corrected in the online code at
  20. princeton.edu:pub/Graphics/GraphicsGems/GemsIII).  Note that many of the code
  21. listings online are different in minor and major ways from the code in the
  22. book (see Addenda, at the end, for new code not in the book).
  23.  
  24.  
  25. Serious errors (ones your compiler cannot or may not catch):
  26.  
  27. p. 330, Equation (4):  put a minus sign just before the 1/2pi term.
  28.  
  29. p. 394: Delete FLOOR and CEILING macros (they're more like truncations).
  30.     Change ROUND macro to (i.e. add parentheses around "a"):
  31.     #define ROUND(a)    ((a)>0 ? (int)((a)+0.5) : -(int)(0.5-(a)))
  32.     Change SGN macro to (i.e. change positive condition result to "1"):
  33.     #define SGN(a)        (((a)<0) ? -1 : 1)
  34.  
  35. p. 401, line 9:  in V3Combine change last "result->y" to "result->z".
  36.  
  37. p. 422, third from last line:  change "tmp->xsize" to "dst->ysize".
  38.  
  39. p. 425-427:  bitbuf is used before being set; initialized bitbuf = 0 before
  40.     use in the three scale_bitmap_* routines.
  41.  
  42. p. 430, line 8:  change "uranx" to "urany" in the "jittery" macro.
  43.  
  44. p. 474:  the variable "rho" is not used, delete it.
  45. p. 477, next to last two lines:  call sq_ellipsoid_tensor with five "1."'s and
  46.     sq_toroid_tensor with six "1."'s.
  47.  
  48. p. 498, lines 53-54:  put "&" in front of a1,b1,c1 and a2,b2,c2.
  49. p. 499, lines 27-28:  put "&" in front of xa,ya and xb,yb.
  50.  
  51. p. 547, beginning:  add line "#include <math.h>"
  52.  
  53. p. 570, line 49:  change to "major = V3New(0.0, 0.0, 1.0);"
  54.  
  55. p. 580, line 19:  change "f+= acos(VDOT(s, t)) * VDOT(sxt, Ns);" to
  56.     "f-= acos(VDOT(s, t)) * VDOT(sxt, Nr);", i.e. "Ns" becomes "Nr".
  57.     "Ns" can be removed from the list of calling parameters for
  58.     "computeUnoccludedFormFactor()".
  59.  
  60. p. 606, beginning:  add "#include <string.h>"
  61.  
  62. -----
  63.  
  64. Syntax errors (ones that are not usually harmful, or are easily caught):
  65.  
  66. p. 396-404, throughout:  replace "};" with "}" to make lint happy
  67. p. 402, gcd():  the variable "k" is set but not used - remove it
  68.  
  69. p. 411, top:  for ANSI compatibility, add procedure declarations:
  70.     void RectStretch(long xs1,long ys1,long xs2,long ys2,long xd1,long yd1,
  71.         long xd2,long yd2) ;
  72.     void Stretch(long x1,long x2,long y1,long y2,long yr,long yw) ;
  73.     void CircleStretch(long SBMINX,long SBMAXX,long xc,long yc,long r) ;
  74.     void Stretch2Lines(long x1,long x2,long y1,long y2,long yr1,long yw1,
  75.         long yr2,long yw2) ;
  76.  
  77. p. 411-413:  cast expressions inside "abs()" calls to type "(int)".
  78.  
  79. p. 414-424:  replace "ceiling" with "ceil" (on some machines)
  80. p. 416, lines 18-19:  remove "char *p;" and "int width, height;" declarations;
  81.     unused.
  82. p. 420-421:  replace "(*filter)" with "(*filterf)" to avoid redeclaration of
  83.     "filter".
  84. p. 423, line 23:  remove "register char *p;" declaration; unused.
  85.  
  86. p. 425, line 33 and p. 426, line 51:  remove declaration of "i", as it is
  87.     unused.
  88.  
  89. p. 427, line 29:  remove declarations for "*p" and "*q"; unused.
  90.  
  91. p. 428, line 35:  remove declarations for "i" and "j"; unused.
  92.  
  93. p. 441, line 37:  remove "nx" declaration; unused.
  94. p. 443, line 2:  remove "xl, xr, yt, yb" declarations; unused.
  95. p. 443, lines 3-4:  remove "k" and "ptb" declarations; unused.
  96.  
  97. p. 472, line 19:  remove "result" declaration; unused.
  98. p. 474, lines 17-18:  remove "iworld" and "R" declarations; unused.
  99. p. 477, line 32:  remove "x" declaration; unused.
  100. p. 476-477:  note that sqellipsoidposn() and sqtoroidposn() are not
  101.     particularly useful in their current forms; they do not return any
  102.     values, e.g. x,y,z are computed but not returned.
  103.  
  104. p. 489, line 50:  cast "intsct" to "(void *)" to make lint happy.
  105.  
  106. p. 496, line 10:  remove global "r, p1, p2, p3, p4" declarations.
  107. p. 496, line 10 and p. 499, throughout:  change "v1" to "gv1" and "v1" to
  108.     "gv2".
  109. p. 497, line 31:  remove "xt" and "yt" declarations; unused.
  110. p. 498, line 27:  remove "t" and "u" declarations; unused.
  111.  
  112. p. 500, line 25:  remove "temp" declaration; unused.
  113. p. 500, line 26:  remove "x3lo,x3hi" and "y3lo,y3hi" declarations; unused.
  114.  
  115. p. 513, line 17:  add the declarations for the static routines:
  116.     static void computePlaneEq() ;
  117.     static Node *insertPlaneEq() ;
  118.     static int comparePlaneEqs() ;
  119.  
  120. p. 522, line 5:  remove "vect23, vect31" declarations; unused.
  121.  
  122. p. 543, line 45:  change "malloc" to "(StackPtr)malloc"
  123. p. 544, line 54:  change "malloc" to "(BinNodePtr)malloc"
  124. p. 546, line 17:  change "malloc" to "(BinNodePtr)malloc"
  125.  
  126. p. 551-554:  Note that this code uses definitions and subroutines that are
  127.     found in Rayshade.  Most are easy enough to understand and code (or
  128.     use Steve Hollasch's vector macros on pages 405-407).
  129.  
  130. p. 559, line 22:  remove "tmp" declaration; unused.
  131.  
  132. p. 570, line 9:  remove "j" declaration; unused.
  133. p. 572, line 18:  remove "a, b, c" and "x1, y1, z1" declarations; unused (i.e.
  134.     replace line with "double d;".
  135. p. 573, lines 15 and 28:  remove "i" declarations; unused.
  136.  
  137. p. 577, line 12:  add the declarations for the static routines:
  138.     static float computeFormFactor() ;
  139.     static float computeUnoccludedFormFactor() ;
  140.     static void splitQuad() ;
  141.     static float quadArea() ;
  142.  
  143. p. 579, last line:  remove "j" declaration, as "j" is not used.
  144.  
  145. p. 607, line 40:  change to "memset((void *)acc, ..." to make lint happy.
  146.  
  147. -----
  148.  
  149. The following are typographical errors in the comments:
  150.  
  151. p. 429, line 24:  change "varables" to "variables"
  152.  
  153. p. 431, line 7:  change "Cyshosz" to "Cychosz"
  154.  
  155. p. 443, line 54:  change "seqment" to "segment"
  156.  
  157. p. 454, line 3:  change "architechture" to "architecture"
  158.  
  159. p. 458, line 21:  change "consistancy" to "consistency"
  160.  
  161. p. 484, line 46:  change "Inplementation" to "Implementation"
  162.  
  163. p. 493, lines 20 and 23:  change "subsegements" to "subsegments"
  164.  
  165. p. 539, line 18:  change "upto" to "up to"
  166.  
  167. p. 550, line 6:  change "parrallel" to "parallel"
  168.  
  169. p. 556, line 48:  change "miminum" to "minimum"
  170.  
  171. p. 572, line 7:  change "homogenous" to "homogeneous"
  172.  
  173. p. 578, line 15:  change "visiblity" to "visibility"
  174.  
  175. p. 606, line 32:  change "initialzed" to "initialized"
  176.  
  177. -----
  178.  
  179. Addenda:
  180.  
  181. There is test software (not in the text) for the "Fast n-Dimensional Extent
  182. Overlap Testing" (exthit), "Accurate Polygon Scan Conversion Using Half-Open
  183. Intervals" (accurate_scan), and "Partitioning a 3-D Convex Polygon with an
  184. Arbitrary Plane" (partition3d).
  185.  
  186. There is C code for Badouel and Wurthrich's Gem II.9 (ndline.c) in the code
  187. distribution (but not in the text).
  188.  
  189. There is more explanatory C code for Woo's Gem VII.1 in the code distribution.
  190.  
  191. There is an improved rgbvary.c included in the code distribution for Microsoft
  192. Windows named rgbvaryW.c.  On PC's this code takes up less space and is 8
  193. times faster.  It looks straightforward to regroove VaryDIB24() to other
  194. bitmap architectures.
  195.  
  196. Here is a little additional explanation to the "Use of Residency Masks..."
  197. gem on p. 284-287 from Joe Cychosz (note errata correction above):
  198.  
  199.     The process goes something like this:
  200.  
  201.     ray_mask = 0
  202.  
  203.     foreach (cell the ray passes through) {
  204.         foreach (object in the cell) {
  205.         if  (ray_mask & object_mask == 0) {
  206.             compute the ray-object intersection
  207.         }
  208.         }
  209.         update ray_mask marking for cell
  210.     }
  211.  
  212.     The important thing here is to mark the cell after it is processed.
  213.