home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 16 / CD_ASCQ_16_0994.iso / news / 2555 / povhlp / comments.hlp < prev    next >
Encoding:
Text File  |  1994-07-04  |  1.2 KB  |  29 lines

  1.     Comments are text in the scene file included to make the scene file
  2.  easier to read or understand.  They are ignored by the ray tracer and are
  3.  there for humans to read.  There are two types of comments in POV-Ray.
  4.  
  5.     Two slashes are used for single line comments.  Anything on a line after
  6.  a double slash // is ignored by the ray tracer.  For example:
  7.        // This line is ignored
  8.  
  9.     You can have scene file information on the line in front of the comment,
  10.  as in:
  11.        object { FooBar }          // This is an object
  12.  
  13.     The other type of comment is used for multiple lines.  This type of com-
  14.  ment starts with /* and ends with */ everything in-between is ignored.  For
  15.  example:
  16.        /* These lines Are ignored
  17.           By the Raytracer  */
  18.  
  19.     This can be useful if you want to temporarily remove elements from a
  20.  scene file.  /*...*/ comments can "comment out" lines containing the other
  21.  // comments, and thus can be used to temporarily or permanently comment out
  22.  parts of a scene.  /*..*/ comments can be nested, the following is legal:
  23.        /* This is a comment
  24.        // This too
  25.        /* This also */    */
  26.  
  27.     Use comments liberally and generously.  Well used, they really improve
  28.  the readability of scene files.
  29.