home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Raytrace & Morphing / SOS-RAYTRACE.ISO / programm / raytrace / smodel3d / 300notes.txt < prev    next >
Encoding:
Text File  |  1991-11-29  |  8.3 KB  |  178 lines
  1.  
  2. Surfmodl 3.00C  Release Notes.
  3.  
  4. These notes discuss the differences between SURFMODL 2.00c and 3.00C.
  5.  
  6. NEW FEATURES:
  7.  
  8.   Version 3.00C has the following changes:
  9.  
  10. -- Support for the full palette of the VGA and Super VGA adapters,
  11.    and several resolution modes.  Many thanks go to Jordan Hargrave,
  12.    who wrote the SVGA256 support now used.  (His contribution is
  13.    shareware, however, so users are encouraged to register with him -
  14.    see SVGA256.REG for details.)
  15. -- Fully dynamic memory allocation, so SURFMODL only uses as much
  16.    memory as it needs.  This also means there is no longer a need
  17.    for two versions of the program; everyone can use the big memory
  18.    version, regardless of how much memory their system has.
  19. -- Automated installation utility (SURFINST).
  20. -- Global configuration file (SURFMODL.CFG), created by SURFINST.
  21. -- A new symbolic command format in the .INI files, which makes them
  22.    easy to manually modify.
  23. -- Interactive file selector, so you don't have to type in file names
  24.    anymore.
  25. -- You can now save and play back screens in any graphics mode
  26.    (previously this did not work with screens that required more than
  27.    64 KBytes of memory to store).
  28. -- The PLAYBACK utility now supports extended memory (using XMS, alias
  29.    HIMEM.SYS), so it is possible to do very long animations.  (For some
  30.    of the high resolution Super VGA modes, you MUST have extended memory
  31.    because there isn't enough conventional memory to load even a single
  32.    screen.)  A job well done by Yuval Tal, wrote the XMS unit I used to
  33.    implement this.
  34. -- New looping options in PLAYBACK.
  35. -- Support for screen dumps to a color printer (using the shareware
  36.    utility Colour Snap).
  37. -- Support for the Amiga IFF format for saving SURFMODL images.
  38. -- Option to show surface borders.
  39. -- Support for an optional environment variable, SURFDIR, where SURFMODL
  40.    will look for all data files (default is the current directory).
  41. -- Performance statistics window.
  42. -- Saved screens are sequentially numbered, to avoid overwriting them.
  43. -- Several miscellaneous bugs tracked down and SQUASHED!
  44. -- Third optional command-line parameter, to allow automated scripts
  45.    that save the screen to disk.
  46.  
  47. COMPATIBILITY:
  48.  
  49.   Version 3.00C is written in Turbo Pascal 6.0.  It may still compile
  50. under versions 5.0 and 5.5, but definitely nothing earlier.  PLAYBACK
  51. requires version 6.0 because of the XMS unit.
  52.  
  53.   Version 3.00C reads all the old data files, but not the old .INI files.
  54. You must use the utility INICVT to convert your old-format .INI files
  55. into the new format.  The new format has symbolic commands, so it is
  56. very easy to read and modify.
  57.  
  58.   Whereas I used to name all of the SURFMODL data files with no file
  59. name extension, SURFMODL now requires that you use the extension of .SRF
  60. if you want to use the interactive file selector.  I recommend you use
  61. this extension for all your new data files, and rename your old data
  62. files to this extension.
  63.  
  64.  
  65. KNOWN BUGS:
  66.  
  67.   Much as I hate to admit it, there are still a few bugs in SURFMODL:
  68.  
  69. -- Shadowing still doesn't work quite right (it never did).
  70. -- If PLAYBACK encounters an error allocating memory, on some 
  71.    systems it leaves you in a graphics mode and you can not
  72.    read the error message.  You have to blindly type "MODE CO80"
  73.    to restore your screen to normal, but you may not know why
  74.    PLAYBACK kicked you out.  If you have extended memory available,
  75.    and HIMEM.SYS is loaded, a memory allocation can fail for two
  76.    reasons: (1) Not enough memory left; and (2) Ran out of handles.
  77.    This is why you will now get an extensive memory usage report at
  78.    the end of each PLAYBACK run if you use extended memory.  If you
  79.    have the above problem, I recommend you reduce the number of files
  80.    that are used in your animation until you get something to work.
  81.    Then you should have a readable memory report when the animation
  82.    finishes, and you will be able to tell whether you are closer to
  83.    running out of memory or out of handles.  Unfortunately, the copy
  84.    of HIMEM.SYS that I have does not allow you to increase the number
  85.    of handles.  If someone else knows how to, please let me know.
  86. -- The IBM 8514 has been removed from the system selection menu,
  87.    because the new VGA driver (SVGA256.BGI and VGA256.BGI) use the
  88.    same system number.  I don't know anyone who has an 8514, but I
  89.    would like to hear comments: Can you use the VGA drivers?
  90. -- IFF files generated by SURFIFF are not readable by all IFF file
  91.    viewers (see SURFIFF.DOC for details).
  92. -- PREPROC's EXTRUDE function mis-orders surfaces (not always following
  93.    the counter-clockwise rule), so you must use Nsides=2 if you use this
  94.    feature.
  95.  
  96.  
  97. FUTURE DIRECTIONS:
  98.  
  99. -- I am currently involved in a joint programming effort with Daniel
  100.    Hudgins, the author of DANCAD3D (a popular shareware CAD program).
  101.    We are trying to create an automated conversion utility to create
  102.    SURFMODL data files from DANCAD3D.  If we are successful, this will
  103.    make a very simple way to create new SURFMODL data files.
  104. -- GIF support for file saving.  I have actually already pretty much
  105.    got this working, but the files are not displayed properly by all
  106.    GIF viewers.  I don't want to release this unless it's working 100%.
  107. -- An option to over-ride SURFMODL's autoscaling of images.  I have
  108.    been planning to do this for quite some time, but just haven't found
  109.    the time.
  110.  
  111.  
  112. Notes for Programmers:
  113. ~~~~~~~~~~~~~~~~~~~~~
  114.   The program comes as a number of include files, several units, and the main
  115. program:
  116.  
  117.    *.BGI         -  Borland Graphics Interface device drivers.
  118.  
  119.    COMPILE.BAT   -  Uses the Turbo Pascal line mode to compile the program.
  120.  
  121.    BGI2OBJ.BAT   -  Converts .BGI files into .OBJ files suitable for linking
  122.                     into the final SURFMODL.EXE file.
  123.  
  124.    *.INC         -  Include files for the program and units
  125.  
  126.    SURFMODL.PAS  -  The SURFMODL program
  127.  
  128.    ANSICRT.PAS   -  A unit to emulate the CRT unit using ANSI.SYS escape
  129.                     sequences on machines which are not IBM compatible.
  130.                     It's emulation is incomplete, and some CRT
  131.                     unit functions are still used, especially WINDOW,
  132.                     KEYPRESSED, and READKEY.  You may have to modify
  133.                     this unit further to work on your system. Normally the
  134.                     Borland CRT unit is used and this unit is ignored.
  135.  
  136.    SURFBGI.PAS   -  A unit to provide Borland Graphics Interface support
  137.                     for VAXmate (and eventually other) computers.  It uses
  138.                     the Borland GRAPH unit, but also supplies equivalent
  139.                     BGI routines for devices not supported by the GRAPH
  140.                     unit.  It does not emulate the entire BGI system, just
  141.                     the parts which SURFMODL needs.  It is supplied in
  142.                     this version to demonstrate how to integrate other
  143.                     graphics systems, but you should not need to use it.
  144.  
  145.    SURFGRAF.PAS  -  Surfmodl Graphics primitives, implemented in BGI graphics.
  146.                     If a non BGI graphics device is being used (like the
  147.                     VAXmate) then this unit uses the SURFBGI unit.
  148.                     Otherwise SURFBGI is never used.
  149.  
  150.    PLAYBACK.PAS  -  A program to play back images saved with surfmodl.
  151.  
  152.    SURFINST.PAS  -  Automated installation utility.
  153.  
  154.    PLAYPAL.PAS   -  A program to allow you to experiment with the full
  155.                     palette of the VGA, to see what your SURFMODL files
  156.                     will look like before you run them.
  157.  
  158.   See also the file FILES.IDX for a more complete list of files.
  159.  
  160.  
  161. Customizing the Program:
  162. ~~~~~~~~~~~~~~~~~~~~~~~
  163.  
  164.   The file DEFINES.INC is used to customize your program.  It contains all
  165. the definitions for the built in Turbo Pascal pre-processor.  This file is
  166. included at the beginning of all the programs and units, so a change in
  167. this file forces the entire system to be re-compiled.
  168.  
  169.   Some of the options included are support of the 80x87 chip, control over
  170. linking .BGI files into the .EXE file, use of the large memory model,
  171. generation of debugging code, generation of shadow processing code,
  172. and generation of code for "external" graphics devices (the VAXmate and
  173. Amiga IFF).
  174.  
  175.   See the DEFINES.INC file for details.
  176.  
  177. ..Ken Van Camp
  178.