Section 3.2.2
INI Files

There were more options used in these renderings than just the switches +I , +D , and +L that you specify. When you run the program, POV- Ray automatically looks for the file povray.ini in whatever directory that povray.exe is in. The povray.ini file contains many options that control how POV-Ray works. We have set this file up so that it is especially easy to run your first scene with minimal problems. The file should be placed in the same directory as povray.exe and it will automatically read when POV-Ray is run. If you ever move povray.exe to a different directory, be sure to move povray.ini too.

Complete details on all of the available switches and options that can be given on the command line or in povray.ini are given in "POV-Ray Options" .

You may also create INI files of your own with switches or options similar to povray.ini . If you put a file name on the command line without a plus or minus sign before it, POV-Ray reads it as an INI file. Try this... 

  POVRAY RES120 +ISHAPES +D1

This causes POV-Ray to look for a file called res120.ini which we have provided. It sets your resolution to 120 by 90 pixels for a quick preview. The following INI files have been provided for you.

RES120.INI Sets resolution to 120 by 90.
RES320.INI Sets resolution to 320 by 200.
RES640.INI Sets resolution to 640 by 480.
RES800.INI Sets resolution to 800 by 600.
RES1K.INI Sets resolution to 1024 by 768.
LOW.INI Sets low quality at 120 by 90.
SLOW.INI Turns on radiosity and anti-aliasing; very slow but beautiful.
TGAFLI.INI TGAFLC.INI Create an FLI/FLC animation from TGA images.
PNGFLI.INI PNGFLC.INI Create an FLI/FLC animation from DTA images.
ZIPFLI.INI ZIPFLC.INI Create an FLI/FLC animation from zipped images. See "ANIMATION TIPS" below.

You can create your own custom INI's which can contain any command in the reference guide.

Section 3.2.3
Alternatives to POVRAY.INI

The povray.ini file is supposed to hold your favorite global default options that you want to use all the time. You should feel free to edit it with new options that suit your needs. However it must be located in the same directory as povray.exe or it won't be found. The dos path isn't searched nor will +L commands help because povray.ini is processed before any command line switches.

If your povray.exe resides on a CD-ROM then you can't edit the povray.ini on the CD. There is an alternative. You may use an environment variable to specify an alternative global default.

In your autoexec.bat file add a line similar to this: 

  set POVINI=D:\DIRECT\FILE.INI

which sets the POVINI environment variable to whatever drive, directory and INI file you choose. If you specify any POVINI environment variable then povray.ini is not read . This is true even if the file you named doesn't exist. Note that you are specifying an entire path and file name. This is not a pointer to a directory containing povray.ini . It is a pointer to the actual file itself.

Note that the POVRAYOPT environment variable in previous versions of POV-Ray is no longer supported.

Section 3.2.4
Batch Files

We've already described how the file runpov.bat can be used as an alternative to running POV-Ray directly. runpov.bat also has one other use. It uses the +GI switch to create a file called rerun.ini . This makes it very easy to run the same file over again with the same parameters. When creating your own scene files you will probably make dozens of test renders. This is a very valuable feature. Here is how it works... Suppose you render a scene as follows: 

  RUNPOV +IMYSCENE +D1 RES120

This renders myscene.pov at 120 by 90 resolution. Note there is no such scene. This is hypothetical. After viewing it, you noticed a mistake which you fixed with your text editor. To rerun the scene type: 

  RERUNPOV

and that's all. It will rerun the same scene you just ran. Suppose you want more detail on the next run. You can add more switches or INI files. For example: 

  RERUNPOV RES320

will rerun at higher resolution. Subsequent uses of rerunpov will be at 320 by 200 until you tell it differently. As another example, the +A switch turns on anti-aliasing. Typing " rerunpov +A " reruns with anti- aliasing on. All subsequent reruns will have it on until you do a " rerunpov -A " to turn it off. Note if you do another runpov it starts over from your povray.ini defaults and it overwrites the old rerun.ini .

Two other batch files are included. runphelp.bat is only used as an alternative way to run povhelp from another directory. If you used installation plan two then use runphelp.bat rather than povhelp.exe . This batch file serves no other purpose.

Finally t2g.bat invokes the tga2gif.exe program for converting TGA files to GIF files. You could run \FILE {tga2gif} directly but its default parameters do not generally produce the best results. If you use T2G instead, it adds some command line switches which work better. For a full list of switches available for tga2gif , type tga2gif with no parameters and it will display the available switches and options.

Section 3.2.5
Display Types

You have already seen how to turn on graphics preview using +D1 . Here are details on other variations of the +D switch. Use -D to turn the display off. If you use -D then you will probably want to add the +V switch to turn on verbose status messages so you can monitor the progress of the rendering while in progress.

The number "1" after the +D tells it what kind of video hardware to use. If you use +D alone or +D0 then POV-Ray will attempt to auto detect your hardware type. Use +D? to see a message about what type of hardware POV-Ray found.

You may also explicitly tell POV-Ray what hardware to use. The following chart lists all of the supported types.

+D0 Auto detect (S)VGA type (Default)
+D1 Standard VGA 320x200
+D2 Standard VGA 360 x 480
+D3 Tseng Labs 3000 SVGA 640x480
+D4 Tseng Labs 4000 SVGA
+D5 AT&T VDC600 SVGA 640x400
+D6 Oak Technologies SVGA 640x480
+D7 Video 7 SVGA 640x480
+D8 Video 7 Vega (Cirrus) VGA 360x480
+D9 Paradise SVGA 640x480
+DA Ahead Systems Ver. A SVGA 640x480
+DB Ahead Systems Ver. B SVGA 640x480
+DC Chips & Technologies SVGA 640x480
+DD ATI SGVA 640x480
+DE Everex SVGA 640x480
+DF Trident SVGA 640x480
+DG VESA Standard SVGA Adapter
+DH ATI XL display card
+DI Diamond Computer Systems SpeedSTAR 24X

The most common type is a VESA standard card which uses +DG . VESA is a standard software interface that works on a wide variety of cards. Those cards which do not have VESA support directly built-in, generally have a video driver that you can load to provide VESA support. The program UniVBE is a high quality universal VESA driver that may work for you. It can be found at http://www.povray.org or possibly other POV-Ray sites.

The options listed above had been tested worked under earlier versions of POV-Ray but there have been many changes in the program and we cannot guarantee these all still work. If you can use VESA then do so. It has been well tested and will give you the most flexibility.

After the +D and the type, you may specify a 3rd character that specifies the palette type.

+D?3 Use 332 palette with dithering (default and best for VGA systems). This is a fixed palette of 256 colors with each color consisting 3-bits of red data, 3-bits green and 2-bits blue.
+D?0 Use HSV palette option for VGA display. This is a fixed palette of 256 colors where colors are matched according to hue, saturation and intensity rather than the amount of red, green and blue.
+D?G Use fixed gray scale palette option for VGA display.
+D?H Use HiColor option. Displays more than 32,000 colors with dithering. Supported on VESA, SpeedSTAR 24X, ATI XL HiColor and Tseng 4000 based cards with high color 15 or 16 bit options.
+D?T For Truecolor 24 bit cards. Use 24 bit color. Supported on the Diamond SpeedSTAR 24X and cards with 24bit VESA support only.

Here are some examples: 

   +D0H Auto detect the VGA display type and display the image to the
        screen as it's being worked on. Use the 15-bit HiColor chip and
        dithering to display more than 32,000 colors on screen. 
   +D4  Display to a TSENG 4000 chipset VGA using the 332 palette option.
   +D4H Display to a TSENG 4000 chipset VGA using the HiColor option.
   +DG0 Display to a VESA VGA adapter and use the HSV palette option.
   +DG3 Display to a VESA VGA adapter and use the 332 palette option.
   +DGH Display to a VESA VGA adapter and use the HiColor option for
        over 32,000 colors.
   +DGT Display to a VESA VGA adapter and use the TrueColor option for 
        over 16 million colors.

Note that your VESA BIOS must support these options in order for you to use them. Some cards may support HiColor and/or TrueColor at the hardware level but not through their VESA BIOS.

Next Section
Table Of Contents