home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 16 / CD_ASCQ_16_0994.iso / news / 2555 / povhlp / povmod.hlp < prev    next >
Encoding:
Text File  |  1994-07-07  |  4.4 KB  |  87 lines
  1.     This section contains a utility program for the POV-Ray IBM-PC protected
  2.  mode executable compiled with Intel's 'Code Builder Kit' 32-bit 'C' compi-
  3.  ler.  It is not of any use for exectuables compiled with any other compiler.
  4.  It's purpose is to expand (or reduce) the amount of virtual memory available
  5.  to POV-Ray during it's operation.
  6.  
  7.     NOTE: If you get a message about running out of memory (allocation fai-
  8.  lure...., memory exhausted......, insufficient memory....  etc...), you
  9.  should use this utility.  It's unneeded until your image models become com-
  10.  plex enough to require more than the 3072K of virtual memory that POV-Ray
  11.  uses as it's distribution default.
  12.  
  13.     The 'region size' consists of the physical RAM *PLUS* the amount of disk
  14.  space allocated to a swapfile for POV-Ray.  The unmodified POV-Ray will ren-
  15.  der approximately a 15,000 triangle file.  (Supports 3072K of memory.  In a
  16.  machine with less than 4 megs of RAM the VMM may be used to raise it to that
  17.  amount.  In a machine with *more* than 3072K of RAM it will go ahead and use
  18.  it, if available, when run 'stand alone'.  I.E.  when not running under a
  19.  DPMI host such as Windows, OS/2 2.x or QEMM w/ QDPMI installed.)
  20.  
  21.     To expand the amount of virtual memory available, more Hard Disk space
  22.  must be allocated to POV-Ray.  POVMOD will list the amount of physical RAM
  23.  available in the machine PLUS the free space on the hard disk.  Any or all
  24.  if this can be allocated for POV-Ray's use during a trace.
  25.  
  26.     NOTE: These amounts may not reflect the actual amount installed in the
  27.  machine when running under a DPMI Host.  They are the amounts reported by
  28.  the host and must be configured in the setup of the host.  For instance the
  29.  amount of XMS and DPMI memory is set under the DOS SETTINGS for an OS/2 2.x
  30.  DOS session.
  31.  
  32.  
  33.  Use of POVMOD:
  34.  
  35.     Place POVMOD in the same directory as POVRAY.EXE.  From the command line
  36.  type:
  37.        POVMOD POVRAY.EXE  <enter>
  38.  
  39.     The program will run and present a list of the current parameters that
  40.  POV-Ray operates under.  The number in the upper right corner of the table
  41.  (the one labeled 'Region Size:') is the amount of memory (both virtual and
  42.  physical combined AT THAT TIME.) that POV-Ray can use.
  43.  
  44.     Press (M)odify to change the parameters.
  45.  
  46.     Press (E)nter to alter the region size.  You can then manually enter the
  47.  amount of memory you would like to have available for the program to use.
  48.  Generally a value of 6M to 10M will cover all but the most complex images.
  49.  
  50.     The (A)ccept key will configure the region size for the largest possible
  51.  swap file size.
  52.  
  53.     NOTE: Accept is not the best choice in most cases.  If there is a large
  54.  amount of free space on your HD it could result in a very large swap file.
  55.  
  56.     The (C)reate option will create a -permanent- swap file.
  57.  
  58.     REMEMBER: You need enough free disk space to write out your image file as
  59.  it is created though!!!
  60.  
  61.     The POV-Ray executable file will then be modified to reflect your choi-
  62.  ces.  Since much of this 'memory' is usually a swap file on your hard disk
  63.  you will get much better performance with a recently defragmented disk.  The
  64.  program will NOT allow you to allocate a larger region size than can be
  65.  created AT THAT TIME.  For example: If you have 6 Megs of combined RAM/Hard
  66.  Disk space available you cannot make the region size any larger than that.
  67.  Also if the region size is set to a particular amount and your hard disk is
  68.  later filled to the point that the free disk space is not large enough for
  69.  the required swap file to be created, the program will NOT run.  It will
  70.  error with an insufficient memory message.  You will need to modify the re-
  71.  gion size to accommodate the smaller amount of disk space available.
  72.  
  73.     An environment variable is used to 'point' to the location of the swap
  74.  file.  The DEFAULT swap file is C:\XMSWAP.TMP.  To set it to another loca-
  75.  tion the following must be added to your AUTOEXEC.BAT file:
  76.        SET SWAP=d:\[subdir]\XMSWAP.TMP
  77.  where d: is the drive and [subdir] is the subdirectory you wish to use for
  78.  the swap file.  You will need to reboot the machine for this parameter to
  79.  take effect.
  80.  
  81.  
  82. OS/2 2.x Note:
  83.  
  84.     When running POV-Ray under OS/2 2.x you need to set the DPMI_MEMORY_LIMIT
  85.  value under the DOS SETTINGS for the session to a value GREATER than or
  86.  EQUAL to the Region Size you set in the POVRAY executable with this program.
  87.