home *** CD-ROM | disk | FTP | other *** search
/ Hot Stuff 2 / hot_stuff_2.zip / hot_stuff_2 / PROGRAMS / POVRAY / POVIBM.ZIP / IBMPCEXE.DOC < prev    next >
Text File  |  1992-08-19  |  13KB  |  295 lines
  1.  
  2.             IBM-PC executable notes for POV-Ray Ver 1.00  
  3. -----------------------------------------------------------------------------
  4.  
  5. See IBMPC.DOC for IBM-PC specific command line options and file conversion
  6. information.
  7.  
  8.      ----------------------------
  9.             General Notes
  10.      ----------------------------
  11.  
  12. This is a 32 bit protected mode version of POV-Ray. It has been compiled for 
  13. 32 bit protected mode with Intel's 386/486 Code Builder Kit. 
  14. Please Note: It *ABSOLUTELY REQUIRES* the following:
  15.  
  16.   80386SX, 80386DX or 80486(SX) Based machine. This version will run on any
  17.   machine with, or without, a CoProcessor. If no CoProcessor is detected a
  18.   protected mode 387 emulator will be loaded and used. If a CoProcessor is
  19.   detected the emulator will not be loaded and the CoPro will be utilized.
  20.  
  21. An 80387SX, 80387DX or a 487SX will give a significant boost in speed however. 
  22. It can be as much as 10x faster or even more. 
  23.  
  24.   For those that are curious about the speed difference between coprocessor
  25.   and no coprocessor you can force the use of the floating point emulator
  26.   linked into POV-Ray by typing   SET NO87=NO COPROCESSOR  <enter>  at the 
  27.   DOS command line. The coprocessor in your machine will not be used for 
  28.   traces while this is set. After enough torture you can re-enable the 
  29.   coprocessor by typing   SET NO87=  <enter>  at the DOS command line.
  30.   (With <enter> being the "enter" or "return" key on your keyboard.)
  31.  
  32.   AT LEAST 2 Megs of RAM, preferably 4Megs. (The more the better though,) 
  33.                                             (it'll use it all.          )
  34.   (Note: I have been told that some people have been unable to run the  )
  35.   (       program with only 2 Megs of RAM installed in their machine.   )
  36.  
  37.  
  38.   A Hard Disk is Preferred. Since a Virtual Memory Manager is linked into the
  39. program the disk can be used as swap space much like what Windows 3.x (TM)
  40. does to add additional "memory". (See POVMOD.DOC for notes on how to modify
  41. the amount of hard disk space that will be used by the Virtual Memory
  42. Manager. This is *NOT* dynamic and must be adjusted according to your
  43. individual systems available resources.) 
  44.  
  45. The program *WILL NOT RUN* on 8088, 8086 or 80286 based systems!
  46.  
  47. If you get a large message at start-up about an incompatible extended program
  48. in operation and recommending reboot, *REBOOT* your machine IMMEDIATELY, 
  49. -- Don't continue! 
  50. File corruption can result if you continue. (This according to Intel
  51. Doc's) Then re-start with a "bare" system, I.E. no TSR's & no memory
  52. managers.
  53.  
  54.   This version of POV-Ray was compiled with Intel's "Code Builder Kit" version
  55. 1.1. There have been several enhancements to the compiler since version 1.0.
  56. The most important being that POV-Ray 1.0 will now run with most XMS/EMS
  57. memory managers loaded. In most cases it will run with QEMM, 386^MAX, EMM386
  58. HIMEM as well as DOS 5.0's DOS=HIGH.
  59.  
  60.   Being a 32 bit protected mode program, this compile of POV-Ray will
  61. somtimes expose problems with systems that wont show up under normal
  62. DOS usage. One common problem is machine lockups or stopping with 
  63. a "parity error" message. This is most often caused by defective or 
  64. marginal RAM in the "extended" portion of memory. DOS normaly dosent use 
  65. this area and will often work fine even though some of your machines RAM
  66. is bad. There are several memory testing utilities on the market that will
  67. test RAM quite well. (Checkit etc.) Generaly the commercial programs will
  68. be more effective in id'ing bad RAM than shareware. Sometimes the
  69. problem can also be that the RAM "wait states" are set too low for the 
  70. access speed of the RAM used. Occasionally it can be something as simple
  71. as oxidation of the connection pads on SIMM units that causes problems.
  72.  
  73.   Some VCPI applications may still be incompatible with POV-Ray. It will not
  74. run under DesqView. DesqView is a VCPI application & requires that *it*
  75. have full control of the system.
  76.  
  77.  
  78.      ---------------------------------
  79.               OS/2 2.0 Notes
  80.      ---------------------------------
  81.  
  82.   A CoProcessor *MUST* be installed in your machine to run this program
  83. under OS/2 2.0. The FPU Emulator linked into POV-Ray cannot be used &
  84. OS/2's "built in" emulator is unavailable in a VDM.
  85.  
  86.   To run the program under IBM's OS/2 2.0 set DPMI_MEMORY_LIMIT under the 
  87. DOS SETTINGS for the session (Windowed or Full Screen) to a value GREATER 
  88. THAN or EQUAL to the REGION SIZE set in the POV-Ray executable. (See 
  89. POVMOD.DOC for more information on setting the region size.) POV-Ray can 
  90. be run in a DOS window under OS/2 2.0 if the render to screen support is 
  91. disabled. Use the "current line being rendered" (+v1) text reporting to 
  92. track the progress of your image.
  93.   The render to screen support CAN be used in a FULL SCREEN DOS session, 
  94. however, you will *most likely* have video sync and/or color problems if 
  95. you attempt to switch to another task during the render, especially when
  96. using HiColor modes. POV-Ray addresses the video HW directly, bypassing 
  97. all of OS/2 2.0's video support, thus OS/2 cant track what has been done 
  98. and gets "lost". 
  99.  
  100.  
  101.  
  102.      -----------------------------
  103.             Windows Notes
  104.      -----------------------------
  105.  
  106. POV-Ray will run under Windows 3.x as a DOS task in 386 ENHANCED MODE.
  107. (See the OS/2 comments above for Video restrictions.)
  108.  
  109. IMPORTANT: A CoProcessor *MUST* be installed in your machine to run this 
  110.            program stand alone under Windows 3.x. Windows traps the 
  111.            interrupt the emulator uses and will not allow it to run.
  112.  
  113. In order to run POV-Ray under Windows 3.x in a machine with NO COPROCESSOR
  114. installed in it a windows support file must be added to your system. 
  115. Locate the VEMD.386 file included with POV-Ray. This file must be copied 
  116. to your Windows directory and Windows must be configured to use it.
  117. Your SYSTEM.INI file (found in your Windows directory) needs a 
  118. device=path\vemd.386 statement. (Where path is the drive and path to the
  119. directory containing VEMD.386) Do the following to add this support:
  120.  
  121.   Edit your SYSTEM.INI file in the following way to add the statement in
  122.   the [386Enh] section of the SYSTEM.INI file. For example if VEMD.386
  123.   is in your Windows directory on your C: drive you would look for [386Enh]
  124.   and add this after it but before any further [xxxx] definitions:
  125.  
  126.           device=C:\Windows\Vemd.386
  127.  
  128.   Case is not significant. The statement can be added anywhere in the
  129.   [386Enh] section of your SYSTEM.INI file.
  130.  
  131. When running under Windows 3.x the program will work fine as a background
  132. task. You must set the program up to use the +v option though. The render
  133. to screen (+dxx) will not work, in a window, under Windows. Render to screen
  134. may be used in a full screen session. (See OS/2 notes about possible video
  135. problems.) Also, since Windows timeslices to run multiple programs "at the 
  136. same time", the trace time reported at the end of the run may not accurately
  137. reflect the time it took to actually create the image.
  138.  
  139.  
  140.       -----------------------------
  141.              Display Notes
  142.       -----------------------------
  143.  
  144. The display options seem to work for most cards using the autodetect mode.
  145. It has only been verified on Tseng 3000/4000 based cards, an ATI VGA 
  146. Wonder and an ATI XL at this time however. See the IBMPC.DOC file for more 
  147. information on the video hardware supported.
  148.  
  149. ** SUPPORTS DIRECT RENDER TO SCREEN IN 32,768 COLORS on TSENG 4000
  150.    based cards with the Sierra HiColor DAC! Use +d0H in POVRAY.DEF to 
  151.    enable autodetect and the HiColor modes. --- Note: Some cards may have
  152.    problems running HiColor modes at less than 640x480 resolution. My revision
  153.    C5 Diamond Computers SpeedSTAR+ HiColor works fine in the 320x200 mode,
  154.    most cards *do* seem to, although it's not an "advertised" mode for some
  155.    vendors.
  156.  
  157. ** Also now supports ATI XL HiColor modes with +dH as the display option 
  158.    enabled in POVRAY.DEF.
  159.  
  160. NOTE: Due to the unavailability of a protected mode TIGA driver LIB,
  161.       this version of POV-Ray does *NOT* support any TIGA/Truecolor 
  162.       boards at present.
  163.  
  164.  
  165.  
  166. The following should work under most conditions, although some machines
  167. seem to have problems with certain combinations of these products:
  168.  
  169.      ----------------------------------
  170.      Compatibility With Memory Managers
  171.      ----------------------------------
  172.      
  173.      POV-Ray can execute with the following memory managers and 
  174.      configurations active:
  175.      
  176.           Qualitas' 386MAX V6.0/V6.01d
  177.           DOS 5.0's EMM386
  178.           DOS 5.0's DOS=HIGH
  179.           Quarterdeck's QEMM-386 V6.00 and higher
  180.           Helix Software's NETROOM V2.2
  181.      
  182.      
  183.      ------
  184.      386MAX
  185.      ------
  186.      
  187.      If you use the EMS=n option, set n to a value greater than 0 to enable
  188.      services required by POV-Ray.
  189.      
  190.      If you use the EXT=n option, set n to a value greater than 0 because
  191.      extended memory is required to run POV-Ray.
  192.      
  193.      -------
  194.      DOS 5.0
  195.      -------
  196.      
  197.      You can run under the DOS 5.0 DOSSHELL without the Task Swapper
  198.      enabled.  If you attempt to execute when the Task Swapper is enabled,
  199.      you receive the following message:
  200.      
  201.           DOS Extender:  Error X0116:  Cannot execute with DOSSHELL's task
  202.           swapper enabled.
  203.      
  204.      If you use the DOS=HIGH configuration, be sure to use a memory
  205.      manager, such as EMM386, QEMM-386, NETROOM, Windows, or 386MAX, to
  206.      ensure proper handling of the A20 address line.
  207.      
  208.      Some systems (mostly Intel486(TM) processor-based) can exhibit
  209.      problems relating to proper handling of the A20 address line when
  210.      executing under DOS 5.0 with DOS=HIGH and the HIMEM.SYS memory
  211.      manager.  To work around these problems, use the /machine:2 option in
  212.      the device=HIMEM.SYS command in your config.sys file; if problems
  213.      still exist, remove the DOS=HIGH configuration.
  214.      
  215.      --------
  216.      QEMM-386
  217.      --------
  218.      
  219.      Because extended memory is required to run POV-Ray, do not use the 
  220.      NOXMS option.
  221.      
  222.      If you use the DOS=HIGH configuration for DOS 5.0, do not use the
  223.      QEMM-386 OFF option:  this option disables services necessary for
  224.      proper handling of the A20 address line, as explained above.  Note
  225.      that the QEMM-386 RAM option overrides the OFF option.
  226.  
  227.      Note: Quarterdeck's recently released DPMI server for QEMM may give 
  228.            a slight improvement in rendering speed on some machines when 
  229.            installed.
  230.      
  231.      ----------------------------------------
  232.      Compatibility With Disk-caching Programs
  233.      ----------------------------------------
  234.      
  235.      POV-Ray can execute with the following disk-caching programs:
  236.      
  237.           Microsoft's SMARTDrive
  238.           Multisoft's Super PC-KWIK
  239.           Qualitas' QCache
  240.           HyperWare's HyperDisk
  241.  
  242.  
  243.      --------------------------------------
  244.      Floating-point Emulator Error Messages
  245.      --------------------------------------
  246.      
  247.      The floating-point emulator can emit the following error messages.
  248.           
  249.           NPX Emulator: Error X0000:  Not supported under this DPMI host
  250.                See Section 1 in these release notes for a list of supported
  251.                memory managers.  This message formerly read "The emulator
  252.                is not supported under this DPMI host yet!"
  253.           
  254.           NPX Emulator: Error X0001:  VEMD.386 not installed - Unable to
  255.           install emulator
  256.                VEMD.386 Emulator not installed. Check for proper setup 
  257.                explained earlier in this doc file.
  258.                This message formerly read "VEMD.386 not installed; unable 
  259.                to install the emulator!"
  260.           
  261.           NPX Emulator: Error X0002:  DPMI Host Get Coprocessor Status
  262.           failed
  263.  
  264.  
  265. Have fun!
  266.  
  267. Bill Pulver
  268.  
  269. CIS:      70405,1152                 <---- Most often used.
  270. Internet: 70405.1152@compuserve.com
  271. Prodigy:  NCCJ93A
  272. Genie:    B.Pulver
  273. Delphi:   BILLP
  274.  
  275. 8/15/92
  276.  
  277. Parts of this document are from the Code Builder support docs.
  278.  
  279.           From Intel Document number 485213-001.
  280.           Copyright 1992, Intel Corporation.  All rights reserved.
  281.           
  282.           Code Builder and Intel486 are trademarks and Intel is a
  283.                registered trademark of Intel Corporation.
  284.           Borland and Turbo Assembler are registered trademarks of
  285.                 Borland International, Inc.
  286.           Microsoft is a registered trademark and Windows is a
  287.                trademark of Microsoft Corporation.
  288.           QEMM-386 is a trademark of Quarterdeck Office Systems.
  289.           NETROOM is a registered trademark of Helix Software Company.
  290.           Qualitas and 386MAX are registered trademarks and QCache is a
  291.                 trademark of Qualitas, Inc.
  292.           Easy-OMF is a trademark of Phar Lap Software, Inc.
  293.           PC-KWIK is a registered trademark of Multisoft Corporation.
  294.           HyperWare and HyperDisk are trademarks of Roger Cross.
  295.