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