home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / povray / Docs / pvray05 < prev    next >
Text File  |  1991-09-17  |  16KB  |  457 lines
  1.    Persistence of Vision Raytracer 
  2.    Version 0.5 BETA Documentation
  3. -----------------------------------------
  4.  
  5.  For general documentation see PVDOC.ZIP.
  6. Also see whatsnew.txt, texture.doc, docformt.txt, pvteam.txt, etc.
  7. These docs are fairly sparse this time around. We're working on better
  8. ones now.
  9.  
  10. This is a BETA version, so please keep those bug reports comin'! 
  11.  
  12.  INTERPOLATE keyword added for bump and image maps.
  13.  Syntax: interpolate 2 or interpolate 4
  14.          2 == Bilinear Interpolation
  15.          4 == Normalized Distance Interpolation
  16.  USE_COLOUR keyword added for maps.
  17.  USE_INDEX keyowrd added for maps.
  18.  END_MAP keyword added for maps.
  19.  
  20.  IMPORTANT Case sensitivity 
  21.  --------------------------
  22.   Case sensitive keywords and command line option added.
  23.    > case_sensitive_yes -- All words checked for exact case. Keywords must be
  24.                            in upper case. (*Old DKB Style*)
  25.    > case_sensitive_no  -- Case is ignored for all words.
  26.    > case_sensitive_opt -- DEFAULT - All words checked for exact case except
  27.                            keywords. Keywords will be accepted in upper and/or
  28.                            lower case. 
  29.  - The declared colors Red, Green, and Blue in colors.dat are now CRed, CBlue,
  30.    CGreen.
  31.  - The declared quadric Sphere in shapes.dat is now QSphere.
  32.  - The texture Sky is now Blue_Sky
  33.  
  34.  COMMAND LINE Options  
  35.  --------------------  
  36.  > Case sensitivity -- /ty = yes, /tn = no, /to = opt (see above)
  37.  
  38.  +vO will enable old style terse verbose, line number only.
  39.  +v0 will enable old new style verbose.
  40.  +v1 (default) will enable new improved style verbose.
  41.  
  42.  
  43.  New IBM-PC display options
  44.  --------------------------
  45.  +dxy enables display adapter type x, with palette option y.
  46.  
  47.    Supported Display Adapter Types:
  48.  
  49.      0 - (default) Autodetect display adapter from types below:
  50.      1 - Basic, Plain Vanilla VGA 320x200
  51.      2 - MVGA (Mode 13X) Tweaked VGA 360x480 (if > 320x200)
  52.      3 - Tseng Labs 3000 SVGA 640x350, 640x480, 800x600
  53.      4 - Tseng Labs 4000 SVGA 640x350, 640x400, 640x480, 800x600, 1024x768
  54.      5 - AT&T VDC600 SVGA 640x400 (with cheesy autodetect)
  55.      6 - Oak Technologies OTI-067 SVGA 640x480
  56.      7 - Video 7 SVGA, VRAM FastRAM 640x480
  57.      8 - Video 7 Vega VGA, Cirrus Chip (uses Mode 1 or 2 above)
  58.      9 - Paradise SVGA 640x480
  59.      A - Ahead Systems Version A SVGA 640x480
  60.      B - Ahead Systems Version B SVGA 640x480
  61.      C - Chips And Technologies SVGA 640x480
  62.      D - ATI VGA Wonder 640x480
  63.      E - Everex SVGA 640x480
  64.      F - Trident SVGA 640x480
  65.      G - VESA Standard SVGA 640x400, 640x480, 800x600, 1024x768, 1280x1024
  66.  
  67.      H - N reserved, unassigned (S)VGA adapter types
  68.  
  69.      O - TIGA/Hercules Graphics Workstation 16-bit
  70.      P - TIGA/Hercules Graphics Workstation 24-bit
  71.  
  72.      Q - Z reserved, unassigned True-Color adapter types
  73.  
  74.    Supported Palette Options:
  75.  
  76.      0 - (default) HSV->RGB method
  77.      3 - 3-3-2 RGB method
  78.      G - Grey Scale (optimized 64-shade palette for IBM PC's)
  79.      H - Sierra High Color pallete DAC
  80.  
  81.  
  82. TEXTURES
  83. -------- 
  84.  
  85. We don't have documentation for ONION & LEOPARD yet, but their syntax
  86. is the same as GRANITE or MARBLE. They do require a COLOR_MAP.
  87. Try them out.
  88.  
  89.  
  90. MAPTYPE - Works with imagemap, bumpmap and material map.
  91. New stuff is a set of new image projection types.  To specify an
  92. imagemap, an additional parameter is optional, i.e.
  93.  
  94.    IMAGEMAP MAPTYPE 1 GIF "xxx.gif" END_MAP
  95.  
  96. Gives a spherical image map.  The types of imagemaps that are now
  97. defined are:
  98.  
  99.    0) (default) Planar map - this is the one that was already there.
  100.    
  101.    1) Spherical map - wraps the image around a sphere.
  102.    2) Cylindrical map - wraps the image around a cylinder (works good for
  103.       hyperboloids, cones, and paraboloids too).
  104.    5) Torus map - wraps the image around a torus.  For this map you need
  105.       to put the major radius of the torus into the first parameter of the
  106.       gradient vector.
  107.  
  108.    3-4) Parabolic and Hyperbolic maps - these are not implemented yet, but
  109.       will be tailored for mapping to the respective types.  The reason for
  110.       having these in addition to the cylindrical types is that these shapes
  111.       deflect differently than a cylinder.    
  112.    
  113.    NOTE: Gradient only effects planar mapping.
  114.  
  115. For all of these image mappers it is assumed that the imagemap will work
  116. in the interval 0 <= Y <= 1.  This means that you need to use the shapes:
  117. QUADRIC QSphere, QUADRIC Cylinder_Y, QUADRIC Hyperbola_Y, etc.  If the default
  118. Planar mapping is used, no object dimensions or coordinates need be changed.
  119.  
  120. See the file "mapper.dat" and the associated gif file "mapper0.gif" for an
  121. example of how the new various types of mappers work.  This file wraps the
  122. picture "rough.gif" around various shapes.
  123.  
  124.  
  125. KEYWORD: MATERIAL_MAP
  126.  
  127. BRIEFLY:
  128.  MATERIAL_MAP maps textures onto an object indexed via a bit-mapped image.
  129.  
  130. SYNTAX:
  131.  MATERIAL_MAP <orientation> Image-Type "imagefilename" (ONCE) (TURBULENCE 0.0)
  132.   (MAPTYPE #)
  133.   TEXTURE ... END_TEXTURE
  134.   TEXTURE ... END_TEXTURE
  135.   (up to 256 textures)  
  136.  
  137.  END_MATERIAL_MAP 
  138.  
  139. DESCRIPTION:
  140.   MATERIAL_MAP is a lot like IMAGE_MAP. Image map takes a picture and 
  141.   projects it onto an image. Like gluing a picture onto a sphere. Material
  142.   map does the same, but instead of changing the color of the sphere it 
  143.   actually changes the texture of the sphere based on the color in the image.
  144.   When it finds a point that would have color number 0 projected on it, it
  145.   changes that point to the first texture in the MATERIAL_MAP definition. 
  146.   Color index number 1 will become texture number 2 and so on.
  147.  
  148. EXAMPLE:
  149.  OBJECT
  150.    SPHERE <0.0  25.0  0.0>  50.0 END_SPHERE
  151.  
  152.    TEXTURE        { X-Y oriented bitmap image }
  153.     MATERIAL_MAP <1.0 -1.0 0.0> GIF "pvmap.gif" 
  154.     
  155.       TEXTURE 
  156.        COLOR Yellow       
  157.        SPECULAR 0.75
  158.        SCALE <7.0 1.5 3.0> 
  159.       END_TEXTURE
  160.       TEXTURE
  161.        Mirror      
  162.        SPECULAR 0.75
  163.       END_TEXTURE
  164.       TEXTURE
  165.        Dark_Wood
  166.        SPECULAR 0.75
  167.       END_TEXTURE
  168.       TEXTURE
  169.         Jade
  170.         SPECULAR 0.75 
  171.       END_TEXTURE
  172.      
  173.      END_MATERIAL_MAP
  174.      ROTATE <0.0 35.0 0.0>
  175.      SCALE < 15.0 15.0 15.0 >   
  176.    END_TEXTURE
  177. END_OBJECT
  178.  
  179.  
  180. KEYWORD: BUMPMAP
  181.  
  182. BRIEFLY:
  183.  BUMPMAP maps surface "bumps" onto an object indexed via a bit-mapped image.
  184.  
  185. SYNTAX:
  186.  BUMPMAP (<orientation>) Image-Type "imagefilename" (ONCE) (TURBULENCE 0.0)
  187.  (BUMPSIZE Height or Depth) (USE_COLOR) (USE_INDEX)
  188.  (INTERPOLATE 2 or 4)
  189.  (MAPTYPE #)
  190.  END_MAP
  191.  
  192. DESCRIPTION:
  193.   BUMPMAP is a lot like IMAGEMAP.  IMAGEMAP takes a picture and projects it
  194.   onto an image, like gluing a picture onto a sphere.  BUMPMAP does the same,
  195.   but instead of changing the color of the sphere it actually changes the
  196.   orientation of the surface normal based on the colors in the image.
  197.   When it finds a point that would have color number 0 projected on it, it
  198.   leaves that point's surface normal alone.  Color index number 1 will become
  199.   "bumped" out from the flat surface, color number 2 further still, and so on.
  200.   Try using one of FRACTINT's continuous potential fractals for interesting
  201.   BUMPMAP effects! BUMPSIZE can be negative. Try USE_COLOUR and INTERPOLATION.
  202.  
  203. EXAMPLE:
  204.  OBJECT
  205.    SPHERE <0.0  25.0  0.0>  50.0 END_SPHERE
  206.  
  207.    TEXTURE        { X-Y oriented bitmap image }
  208.       BUMPMAP <1.0 -1.0 0.0> GIF "bumpy.gif"
  209.       BUMPSIZE 3.0  {Try values from negative to very high }
  210.       INTERPOLATE 2
  211.       END_MAP
  212.       AMBIENT 0.2
  213.       DIFFUSE 0.8
  214.       SPECULAR 1.0
  215.    END_TEXTURE
  216.  
  217.    ROTATE <0.0 35.0 0.0>
  218.    SCALE < 15.0 15.0 15.0 >
  219.    END_TEXTURE
  220. END_OBJECT
  221.  
  222.  
  223. KEYWORD: GOUGEMAP
  224.  
  225. BRIEFLY:
  226.  GOUGEMAP maps indentations into an object indexed via a bit-mapped image.
  227.  
  228. SYNTAX:
  229.  GOUGEMAP <orientation> Image-Type "imagefilename" (ONCE) (TURBULENCE 0.0)
  230.  (GOUGESIZE Depth or BUMPSIZE Depth )
  231.  END_MAP
  232.  
  233. DESCRIPTION:
  234.   GOUGEMAP is a lot like IMAGEMAP.  IMAGEMAP takes a picture and projects it
  235.   onto an image, like gluing a picture onto a sphere.  GOUGEMAP does the same,
  236.   but instead of changing the color of the sphere it actually changes the
  237.   orientation of the surface normal based on the colors in the image.
  238.   When it finds a point that would have color number 0 projected on it