home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / code / graphics / povdoc / bugs.doc next >
Encoding:
Text File  |  1995-05-19  |  3.9 KB  |  87 lines
  1.                   Persistence of Vision Raytracer
  2.                           Version 1.0 
  3.                           Bug Reports
  4.                   -------------------------------
  5.                  
  6. This document describes the best method for reporting problems and
  7. then list some known problems with POV-Ray. 
  8.  
  9. -------------------------------------------------------------------
  10. Reporting Problems
  11. -------------------------------------------------------------------
  12.  
  13. The best method for reporting problems is to create the smallest 
  14. possible scene file that duplicates your problem and post it as
  15. a message in CompuServe's COMART forum section 16 along with a 
  16. description of the problem. All of the POV-Team regularly checks
  17. in there, as well as many other intelligent, talented people who
  18. love to help out. Most problems are solved very quickly this way.
  19. Alternately, you may send mail to any of the primary authors
  20. listed in POVRAY.DOC, "Contacting the Authors".
  21.  
  22. We receive many great letters with compliments, suggestions, and 
  23. problem reports. The problem reports are often very vague and 
  24. difficult to pin down. POV-Ray is a very complex program and it runs
  25. on many different computers. To find the cause of a problem, we
  26. need as much specific information as possible and hopefully, a 
  27. small scene file that demonstrates the problem. Here's a list
  28. of info that would be helpful to send to us when reporting a problem:
  29.  
  30.   1: What is your computer setup?
  31.     1a: What is the software and hardware configuration of your computer
  32.     1b: Have you tried using the simplest configuration of your computer
  33.         to test the problem? (ie. no memory resident software, no tricky
  34.         utilities loaded.)
  35.     1c: What version of the software are you using? (ie. 1.0ibc 1.0tc5)
  36.   
  37.   2: Have you experienced this problem on another computer?
  38.   
  39.   3: Have you heard other reports of this problem?
  40.   
  41.   4: Has this always been a problem or did it ever work correctly before?
  42.   
  43.   5: Can you pinpoint the problem to a certain line or block of 
  44.      lines in a scene file?
  45.      
  46.   6: Can you reliably duplicate the problem and describe the steps to 
  47.      duplicate it?
  48.  
  49.   7: Have you experienced the problem in more than one scene file?
  50.   
  51.   8: Are you experiencing the problem with one of the executables released
  52.      by the POV-Team, or is this your own compiled executable?
  53.      
  54.   9: If you have modified your personal copy of the source, can you
  55.      duplicate the problem with an unmodified copy of the source? 
  56.  
  57. --------------------------------------------------------------------------
  58. Known Problems
  59. --------------------------------------------------------------------------
  60.  
  61.  :: Height fields used as clipping shapes may cause the program to 
  62.     abort with an error. Height fields are not meant to be used as
  63.     clipping shapes currently, so this problem is low priority.
  64.     
  65.  :: Roughness 0 will cause the program to abort with a math error.
  66.  
  67.  :: Very low values of roughness ( <.001 ) will cause math errors
  68.     on some computers, notably the Amiga. 
  69.  
  70.  :: Scaling any component by zero (scale <2 0 3>) will cause the program
  71.     to abort with a math error.
  72.  
  73.  :: The IBM-PC display code autodetect is not perfect. Try using 
  74.     different display modes described if IBMPC.DOC if +d0 doesn't
  75.     work correctly for you.
  76.     
  77.  :: Error messages are often cryptic. See POVERR.DOC for help with this.
  78.  
  79.  :: Blobs and quartics will not always render correctly. Noise appears on
  80.     the screen or holes in the shape. This is caused by numberical 
  81.     inaccuracies in your computer. Try adding the sturm keyword to the
  82.     shape's definition to use a more accurate, but slower method of
  83.     computing the shape. This won't always work, either, and you
  84.     may just have to use a different shape.
  85.  
  86.  :: Layered textures don't work correctly with tiles or material_maps
  87.