home *** CD-ROM | disk | FTP | other *** search
/ Avalon - 3D Objects & Resources / Avalon.iso / misc / mac / pov_rayd / bugs.doc < prev    next >
Text File  |  1995-01-01  |  4KB  |  173 lines
  1.                   Persistence of Vision Raytracer
  2.  
  3.                           Version 1.0 
  4.  
  5.                           Bug Reports
  6.  
  7.                   -------------------------------
  8.  
  9.                  
  10.  
  11. This document describes the best method for reporting problems and
  12.  
  13. then list some known problems with POV-Ray. 
  14.  
  15.  
  16.  
  17. -------------------------------------------------------------------
  18.  
  19. Reporting Problems
  20.  
  21. -------------------------------------------------------------------
  22.  
  23.  
  24.  
  25. The best method for reporting problems is to create the smallest 
  26.  
  27. possible scene file that duplicates your problem and post it as
  28.  
  29. a message in CompuServe's COMART forum section 16 along with a 
  30.  
  31. description of the problem. All of the POV-Team regularly checks
  32.  
  33. in there, as well as many other intelligent, talented people who
  34.  
  35. love to help out. Most problems are solved very quickly this way.
  36.  
  37. Alternately, you may send mail to any of the primary authors
  38.  
  39. listed in POVRAY.DOC, "Contacting the Authors".
  40.  
  41.  
  42.  
  43. We receive many great letters with compliments, suggestions, and 
  44.  
  45. problem reports. The problem reports are often very vague and 
  46.  
  47. difficult to pin down. POV-Ray is a very complex program and it runs
  48.  
  49. on many different computers. To find the cause of a problem, we
  50.  
  51. need as much specific information as possible and hopefully, a 
  52.  
  53. small scene file that demonstrates the problem. Here's a list
  54.  
  55. of info that would be helpful to send to us when reporting a problem:
  56.  
  57.  
  58.  
  59.   1: What is your computer setup?
  60.  
  61.     1a: What is the software and hardware configuration of your computer
  62.  
  63.     1b: Have you tried using the simplest configuration of your computer
  64.  
  65.         to test the problem? (ie. no memory resident software, no tricky
  66.  
  67.         utilities loaded.)
  68.  
  69.     1c: What version of the software are you using? (ie. 1.0ibc 1.0tc5)
  70.  
  71.   
  72.  
  73.   2: Have you experienced this problem on another computer?
  74.  
  75.   
  76.  
  77.   3: Have you heard other reports of this problem?
  78.  
  79.   
  80.  
  81.   4: Has this always been a problem or did it ever work correctly before?
  82.  
  83.   
  84.  
  85.   5: Can you pinpoint the problem to a certain line or block of 
  86.  
  87.      lines in a scene file?
  88.  
  89.      
  90.  
  91.   6: Can you reliably duplicate the problem and describe the steps to 
  92.  
  93.      duplicate it?
  94.  
  95.  
  96.  
  97.   7: Have you experienced the problem in more than one scene file?
  98.  
  99.   
  100.  
  101.   8: Are you experiencing the problem with one of the executables released
  102.  
  103.      by the POV-Team, or is this your own compiled executable?
  104.  
  105.      
  106.  
  107.   9: If you have modified your personal copy of the source, can you
  108.  
  109.      duplicate the problem with an unmodified copy of the source? 
  110.  
  111.  
  112.  
  113. --------------------------------------------------------------------------
  114.  
  115. Known Problems
  116.  
  117. --------------------------------------------------------------------------
  118.  
  119.  
  120.  
  121.  :: Height fields used as clipping shapes may cause the program to 
  122.  
  123.     abort with an error. Height fields are not meant to be used as
  124.  
  125.     clipping shapes currently, so this problem is low priority.
  126.  
  127.     
  128.  
  129.  :: Roughness 0 will cause the program to abort with a math error.
  130.  
  131.  
  132.  
  133.  :: Very low values of roughness ( <.001 ) will cause math errors
  134.  
  135.     on some computers, notably the Amiga. 
  136.  
  137.  
  138.  
  139.  :: Scaling any component by zero (scale <2 0 3>) will cause the program
  140.  
  141.     to abort with a math error.
  142.  
  143.  
  144.  
  145.  :: The IBM-PC display code autodetect is not perfect. Try using 
  146.  
  147.     different display modes described if IBMPC.DOC if +d0 doesn't
  148.  
  149.     work correctly for you.
  150.  
  151.     
  152.  
  153.  :: Error messages are often cryptic. See POVERR.DOC for help with this.
  154.  
  155.  
  156.  
  157.  :: Blobs and quartics will not always render correctly. Noise appears on
  158.  
  159.     the screen or holes in the shape. This is caused by numberical 
  160.  
  161.     inaccuracies in your computer. Try adding the sturm keyword to the
  162.  
  163.     shape's definition to use a more accurate, but slower method of
  164.  
  165.     computing the shape. This won't always work, either, and you
  166.  
  167.     may just have to use a different shape.
  168.  
  169.  
  170.  
  171.  :: Layered textures don't work correctly with tiles or material_maps
  172.  
  173.