home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / code / graphics / povibm / povmod.doc < prev    next >
Encoding:
Text File  |  1995-05-19  |  4.1 KB  |  97 lines
  1.  
  2.                                  POVMOD
  3.                     Virtual Memory Utility for POV-Ray 1.0
  4. ------------------------------------------------------------------------------
  5.                      
  6.  
  7. This file contains a utility program for the POV-Ray IBM-PC protected mode
  8. executable.  It's purpose is to expand (or reduce) the amount of memory 
  9. available to POV-Ray during it's operation. 
  10.  
  11. The "region size" consists of the physical RAM *PLUS* the amount of disk 
  12. space allocated to a swapfile for POV-Ray. The unmodified POV-Ray will 
  13. render approx. a 15,000 triangle file. (Supports 3072K of memory. In a 
  14. machine with less than 4 megs of RAM the VMM may be used to raise it to
  15. that amount. In a machine with *more* than 3072K of RAM it will go ahead and
  16. use it.) 
  17.  
  18. To expand the virtual memory available, more Hard Disk space
  19. must be allocated to POV-Ray. POVMOD will list the amount of physical RAM 
  20. available in the machine PLUS the free space on the hard disk. Any or all of 
  21. this can be allocated for POV-Ray's use during a trace.  
  22.  
  23. Use of POVMOD.  
  24. --------------
  25. Place POVMOD in the same directory as POVRAY.EXE. From the command
  26. line type:
  27.  
  28. POVMOD POVRAY.EXE  <enter>
  29.  
  30. The program will run and present a list of the current parameters that 
  31. POV-Ray operates under. The number in the upper right corner of the table
  32. (The one labeled "Region Size:") is the amount of memory (Both virtual 
  33. and physical combined AT THAT TIME.) that POV-Ray can use. I.E. The  current
  34. setting. 
  35.  
  36. Press the (M)odify key to change the parameters. You can then manualy 
  37. enter the amount of memory you want the program to use. The (A)ccept key 
  38. will configure the region size for the largest reasonable swap file size.
  39.  
  40. *** Remember you need enough free disk space to write out your image ***
  41. *** file as it is created though!!!                                  ***
  42.  
  43. For a 32,000 triangle image you need about 6000K of memory available. 
  44. The POV-Ray executable file will then be modified to reflect your choices. 
  45. Since much of this "memory" is usually a swap file on your hard disk you 
  46. will get *much* better performance with a recently de-fragmented disk. 
  47. The program will NOT allow you to allocate a larger region size than can 
  48. be created AT THAT TIME. I.E. if you have 6 Megs of combined RAM/Hard Disk 
  49. space avail. you cannot make the region size any larger than that. Also if 
  50. the region size is set to a particular amount and your hard disk is later 
  51. filled to the point that the free disk space is not large enough for the 
  52. required swap file to be created, the program will *NOT* run. It will error 
  53. with an insufficient memory message. You will need to modify the region 
  54. size to accomodate the smaller amount of disk space available. 
  55.  
  56. An environment variable is used to "point" to the location of the swap
  57. file. The DEFAULT swap file is C:\XMSWAP.TMP. To set it to another 
  58. location the following must be added to your AUTOEXEC.BAT file:
  59.  
  60. SET SWAP=d:\[subdir]\XMSWAP.TMP 
  61.  
  62. Where d: is the drive and [subdir] is the subdirectory you wish to use
  63. for the swapfile. You will need to reboot the machine for this parameter
  64. to take effect.
  65.  
  66. (Note: The test triangle files refered to were generated with FRGEN 1.1.)
  67.  
  68.  
  69.  
  70. --------------------------------
  71.         OS/2 2.0 Note
  72. --------------------------------
  73.  
  74. When running POV-Ray under OS/2 2.0 you need to set the DPMI_MEMORY_LIMIT
  75. value under the DOS SETTINGS for the session to a value GREATER than or
  76. EQUAL to the Region Size you set in the POVRAY executable with this program. 
  77. POV-Ray can run in a Window with the render to screen option disabled. 
  78. I.E. Use the text disply to track the current line being traced. Render 
  79. to screen will work in a full screen DOS session. Note however that you 
  80. will *most likely* expirence video color and/or sync difficulties when 
  81. switching to other programs during the trace. PoVRAY addresses the video 
  82. hardware directly, bypassing all of OS/2's video protection. When the 
  83. trace is finished POV-Ray resets the video to standard text mode, OS/2 
  84. can usually recover the video at that point.  
  85.  
  86.  
  87.  
  88. Bill Pulver    CIS: 70405,1152              
  89. 7/3/92
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.