home *** CD-ROM | disk | FTP | other *** search
/ Hot Stuff 2 / hot_stuff_2.zip / hot_stuff_2 / PROGRAMS / POVRAY / POVIBM.ZIP / IBMPC.DOC < prev    next >
Text File  |  1992-08-17  |  6KB  |  137 lines
  1.                   Persistence of Vision Raytracer
  2.                           Version 1.0 
  3.                     IBM-PC Specific Intructions
  4.                   -------------------------------
  5.  
  6. This file contains the documentation specific to the IBM-PC version of
  7. POV-Ray. See POVRAY.DOC for general program info and installation
  8. instructions.
  9.  
  10.   The executable POVRAY.EXE was compiled using the Intel Code Builder   
  11. 32 bit protected mode compiler. A 386 or 486 and at least 2 meg of RAM
  12. are required to run this program. A math co-processor and VGA display
  13. are recommended.
  14.  
  15. See IBMPCEXE.DOC for more info.
  16.  
  17. -----------------------------------------------------------------------------
  18.  
  19. Running POV-Ray:
  20. ----------------   
  21.    POV-Ray is run from the command line by typing the program name,
  22.    povray.exe followed by command line options. 
  23.    For example,
  24.      
  25.      C:\POVRAY>povray +isimple.pov +osimple.tga +w160 +h120 +d -v +x
  26.    
  27.    Options may also be specified in a separate file, the name of which
  28.    is placed on the command line. (The default options file POV-Ray will
  29.    look for is POVRAY.DEF) Or they may be specified in the environment 
  30.    variable, POVRAYOPT, as in:
  31.    
  32.    set POVRAYOPT=+w160 +h120 +x +d0 -v
  33.    
  34.    The environment variable is good for setting global default options
  35.    that will be in effect no matter what directory you're working in.
  36.    Options on the command line override the environment variable.
  37.    It is recommended to set the environment variable in your AUTOEXEC.BAT
  38.    file and to add the directory containing POVRAY.EXE to your path
  39.    statement in your AUTOEXEC.BAT file.
  40.    
  41.    There is also at least one third-party utility available
  42.    that runs POV-Ray from within Micorsoft Windows and provides an 
  43.    easy interface for picking files and setting options. 
  44.    
  45.    POV-Ray outputs Targa (.TGA) files which need to be converted before
  46.    they can be viewed on a standard VGA. See file section below for more
  47.    info.
  48.  
  49. ----------------------------------------------------------------------------
  50.    
  51. Command Line Display Options:
  52. -----------------------------
  53. POV-Ray can display a rough version of the scene file while it creates
  54. the image by using the options listed below. To learn how to see the file 
  55. in its final form, see the files section below.
  56.  
  57. +d   = Alone, will autodetect the display type and display the image 
  58.        to the screen as it's being worked on. Try specifying the display
  59.        type explicitly if autodetect doesn't work. +d? will invoke a
  60.        message to report what display POV-Ray is detecting.
  61.  
  62. -v   =  Usually, you should use -v in conjunction with +d. This 
  63.         will turn off the line number text display. It will work
  64.         with some display options. You can experiment to see which.
  65.  
  66. +d#p = The first character after d is the display type, resolution is 
  67.        automatically selected. The second character is the palette type
  68.        or color selection method.
  69.  
  70. Some Examples
  71. --------------
  72. +d0h = Autodetect the VGA display type
  73.        and display the image to the screen
  74.        as it's being worked on.
  75.        Use the Sierra HiColor chip and
  76.        dithering to display more than 32,000
  77.        colors on screen. Looks great!
  78. +d1  = Display to standard VGA screen 320x200.
  79.        Try this if your SVGA display is not supported.
  80. +dG0 = Display to a VESA VGA adapter and
  81.        use the HSV palette option.
  82. +dG3 = Display to a VESA VGA adapter and use 
  83.        the 332 palette option.
  84. +d4  = Display to a TSENG 400 chipset VGA using
  85.        the 332 palette option.
  86.  
  87. If your card isn't autodetected correctly try all the options. 
  88. If no option works, just use +d1 for standard VGA.
  89.  
  90. DISPLAY OPTIONS:
  91.     +d0     Autodetect (S)VGA type (Default)
  92.     +d1     Standard VGA 320x200
  93.     +d2     Standard VGA 360 x 480
  94.     +d3     Tseng Labs 3000 SVGA 640x480
  95.     +d4     Tseng Labs 4000 SVGA 640x480
  96.     +d5     AT&T VDC600 SVGA 640x400
  97.     +d6     Oak Technologies SVGA 640x480
  98.     +d7     Video 7 SVGA 640x480
  99.     +d8     Video 7 Vega (Cirrus) VGA 360x480
  100.     +d9     Paradise SVGA 640x480
  101.     +dA     Ahead Systems Ver. A SVGA 640x480
  102.     +dB     Ahead Systems Ver. B SVGA 640x480
  103.     +dC     Chips & Technologies SVGA 640x480
  104.     +dD     ATI SGVA 640x480
  105.     +dE     Everex SVGA 640x480
  106.     +dF     Trident SVGA 640x480
  107.     +dG     VESA Standard SVGA Adapter 640x480
  108.     +dH     ATI XL display card
  109.  
  110. PALETTE OPTIONS:
  111.     +d?3 Use 332 palette with dithering 
  112.         (Default and best for VGA systems)
  113.     +d?h Use Sierra HiColor option. Displays 
  114.          32,000+ colors with dithering. Looks great!
  115.     +d?0 Use HSV palette option for VGA display
  116.     +d?G Use Grayscale palette option for VGA display
  117.     +d?T For Truecolor 24 bit cards. Use 24 bit color.
  118.  
  119. -----------------------------------------------------------------------
  120.  
  121. File Formats:
  122. -------------
  123.    The default file format for the IBM-PC is Targa (+ft). This format 
  124. is a 24 bit color image allowing over 16 million colors to be created.
  125. Most IBM-PC systems do not have the capability to directly display
  126. Targa images. They must be converted to 256 color GIF images so they
  127. can be viewed on a VGA or SVGA display. To convert a TGA file to a GIF
  128. file, get a copy of  PICLAB or Image Alchemy which can be found from
  129. the same source as the POV-Ray files. The program documentation
  130. of these programs describes how to convert a TGA to a GIF.
  131.  
  132.   Many SVGA cards now have a Sierra HiColor chip for 16 bit color.
  133. Get a copy of the program TGVIEW and you can see your rendered images
  134. in "almost" full color without converting them to a GIF file.
  135.  
  136.    
  137.