home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / code / graphics / povibm / ibmpcexe.doc < prev    next >
Encoding:
Text File  |  1995-05-19  |  11.2 KB  |  257 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 *ABSOLOUTELY 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.   dectected 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 startup 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.   Some VCPI applications may still be incomatible with POV-Ray. It will not
  61. run under DesqView. DesqView is a VCPI application & requires that *it*
  62. have full control of the system.
  63.  
  64.  
  65.      ---------------------------------
  66.               OS/2 2.0 Notes
  67.      ---------------------------------
  68.  
  69.   To run the program under IBM's OS/2 2.0 set DPMI_MEMORY_LIMIT under the 
  70. DOS SETTINGS for the session (Windowed or Full Screen) to a value GREATER 
  71. THAN or EQUAL to the REGION SIZE set in the POV-Ray executable. (See 
  72. POVPRMOD.DOC for more information on setting the region size.) PoVPRAY can 
  73. be run in a DOS window under OS/2 2.0 if the render to screen support is 
  74. disabled. Use the "current line being rendered" text reporting to track 
  75. the progress of your image.
  76.   The render to screen support CAN be used in a FULL SCREEN DOS session, you
  77. will *most likely* have video sync and/or color problems if you attempt to 
  78. switch to another task during the render however. POV-Ray addresses the 
  79. video HW directly, bypassing all of OS/2 2.0's video support, thus OS/2 
  80. cant track what has been done and gets "lost". 
  81.  
  82.  
  83.  
  84.      -----------------------------
  85.             Windows Notes
  86.      -----------------------------
  87.  
  88. POV-Ray will run under Windows 3.x as a DOS task in 386 ENHANCED MODE.
  89. (See the OS/2 comments above for Video restrictions.)
  90.  
  91. IMPORTANT: A CoProcessor *MUST* be installed in your machine to run this 
  92.            program stand alone under Windows 3.x. Windows traps the 
  93.            interrupt the emulator uses and will not allow it to run.
  94.  
  95. In order to run POV-Ray under Windows 3.x in a machine with NO COPROCESSOR
  96. installed in it a windows support file must be added to your system. 
  97. Locate the VEMD.386 file included with POV-Ray. This file must be copied 
  98. to your Windows directory and Windows must be configured to use it.
  99. Your SYSTEM.INI file (found in your Windows directory) needs a 
  100. device=path\vemd.386 statement. (Where path is the drive and path to the
  101. directory containing VEMD.386) Do the following to add this support:
  102.  
  103.   Edit your SYSTEM.INI file in the following way to add the statement in
  104.   the [386Enh] section of the SYSTEM.INI file. For example if VEMD.386
  105.   is in your Windows directory on your C: drive you would look for [386Enh]
  106.   and add this after it but before any further [xxxx] definitions:
  107.  
  108.           device=C:\Windows\Vemd.386
  109.  
  110.   Case is not significant. The statement can be added anywhere in the
  111.   [386Enh] section of your SYSTEM.INI file.
  112.  
  113. When running under Windows 3.x the program will work fine as a background
  114. task. You must set the program up to use the +V option though. The render
  115. to screen (+dxx) will not work under Windows. Also, since Windows 
  116. timeslices to run multiple programs "at the same time", the trace time 
  117. reported at the end of the run may not be accurate.
  118.  
  119.  
  120.  
  121.       -----------------------------
  122.              Display Notes
  123.       -----------------------------
  124.  
  125. The display options seem to work for most cards using the autodetect mode.
  126. It has only been verified on Tseng 3000/4000 based cards and an ATI VGA 
  127. Wonder and an ATI XL at this time however. See the POV.DOC files for more 
  128. information on the video hardware supported.
  129.  
  130. ** SUPPORTS DIRECT RENDER TO SCREEN IN 32,768 COLORS on TSENG 4000
  131.    based cards with the Sierra HiColor DAC! Use +d0H in POV-Ray.DEF to 
  132.    enable autodetect and the HiColor modes. --- Note: Some cards may have
  133.    problems running HiColor modes at less than 640x480 resolution. My revision
  134.    C5 Diamond Computers SpeedSTAR+ HiColor works fine in the 320x200 mode,
  135.    most cards *do* seem to, although it's not an "advertised" mode.
  136.  
  137. ** Also now supports ATI XL HiColor modes with +dH as the display option 
  138.    enabled in POV-Ray.DEF.
  139.  
  140. NOTE: Due to the unavailability of a protected mode TIGA driver LIB,
  141.       this version of POV-Ray does *NOT* support any TIGA/Truecolor 
  142.       boards at present.
  143.  
  144.  
  145.      ----------------------------------
  146.      Compatibility With Memory Managers
  147.      ----------------------------------
  148.      
  149.      POV-Ray can execute with the following memory managers and 
  150.      configurations active:
  151.      
  152.           Qualitas' 386MAX V6.0/V6.01d
  153.           DOS 5.0's EMM386
  154.           DOS 5.0's DOS=HIGH
  155.           Quarterdeck's QEMM-386 V6.00 and higher
  156.           Helix Software's NETROOM V2.2
  157.      
  158.      
  159.      ------
  160.      386MAX
  161.      ------
  162.      
  163.      If you use the EMS=n option, set n to a value greater than 0 to enable
  164.      services required by POV-Ray.
  165.      
  166.      If you use the EXT=n option, set n to a value greater than 0 because
  167.      extended memory is required to run POV-Ray.
  168.      
  169.      -------
  170.      DOS 5.0
  171.      -------
  172.      
  173.      You can run under the DOS 5.0 DOSSHELL without the Task Swapper
  174.      enabled.  If you attempt to execute when the Task Swapper is enabled,
  175.      you receive the following message:
  176.      
  177.           DOS Extender:  Error X0116:  Cannot execute with DOSSHELL's task
  178.           swapper enabled.
  179.      
  180.      If you use the DOS=HIGH configuration, be sure to use a memory
  181.      manager, such as EMM386, QEMM-386, NETROOM, Windows, or 386MAX, to
  182.      ensure proper handling of the A20 address line.
  183.      
  184.      Some systems (mostly Intel486(TM) processor-based) can exhibit
  185.      problems relating to proper handling of the A20 address line when
  186.      executing under DOS 5.0 with DOS=HIGH and the HIMEM.SYS memory
  187.      manager.  To work around these problems, use the /machine:2 option in
  188.      the device=HIMEM.SYS command in your config.sys file; if problems
  189.      still exist, remove the DOS=HIGH configuration.
  190.      
  191.      --------
  192.      QEMM-386
  193.      --------
  194.      
  195.      Because extended memory is required to run POV-Ray, do not use the 
  196.      NOXMS option.
  197.      
  198.      If you use the DOS=HIGH configuration for DOS 5.0, do not use the
  199.      QEMM-386 OFF option:  this option disables services necessary for
  200.      proper handling of the A20 address line, as explained above.  Note
  201.      that the QEMM-386 RAM option overrides the OFF option.
  202.      
  203.      ----------------------------------------
  204.      Compatibility With Disk-caching Programs
  205.      ----------------------------------------
  206.      
  207.      POV-Ray can execute with the following disk-caching programs:
  208.      
  209.           Microsoft's SMARTDrive
  210.           Multisoft's Super PC-KWIK
  211.           Qualitas' QCache
  212.           HyperWare's HyperDisk
  213.  
  214.  
  215.      --------------------------------------
  216.      Floating-point Emulator Error Messages
  217.      --------------------------------------
  218.      
  219.      The floating-point emulator can emit the following error messages.
  220.           
  221.           NPX Emulator: Error X0000:  Not supported under this DPMI host
  222.                See Section 1 in these release notes for a list of supported
  223.                memory managers.  This message formerly read "The emulator
  224.                is not supported under this DPMI host yet!"
  225.           
  226.           NPX Emulator: Error X0001:  VEMD.386 not installed - Unable to
  227.           install emulator
  228.                VEMD.386 Emulator not installed. Check for proper setup 
  229.                explained earlier in this doc file.
  230.                This message formerly read "VEMD.386 not installed; unable 
  231.                to install the emulator!"
  232.           
  233.           NPX Emulator: Error X0002:  DPMI Host Get Coprocessor Status
  234.           failed
  235.  
  236. Bill Pulver 70405,1152
  237. 6/19/92
  238.  
  239. Parts of this document are from the Code Builder support docs.
  240.  
  241.           From Intel Document number 485213-001.
  242.           Copyright 1992, Intel Corporation.  All rights reserved.
  243.           
  244.           Code Builder and Intel486 are trademarks and Intel is a
  245.                registered trademark of Intel Corporation.
  246.           Borland and Turbo Assembler are registered trademarks of
  247.                 Borland International, Inc.
  248.           Microsoft is a registered trademark and Windows is a
  249.                trademark of Microsoft Corporation.
  250.           QEMM-386 is a trademark of Quarterdeck Office Systems.
  251.           NETROOM is a registered trademark of Helix Software Company.
  252.           Qualitas and 386MAX are registered trademarks and QCache is a
  253.                 trademark of Qualitas, Inc.
  254.           Easy-OMF is a trademark of Phar Lap Software, Inc.
  255.           PC-KWIK is a registered trademark of Multisoft Corporation.
  256.           HyperWare and HyperDisk are trademarks of Roger Cross.
  257.