home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Raytrace & Morphing / SOS-RAYTRACE.ISO / programm / raytrace / smodel3d / molecule.doc < prev    next >
Encoding:
Text File  |  1991-11-29  |  4.3 KB  |  87 lines
  1. Ken Van Camp  9/21/90       MOLECULE.DOC
  2.  
  3. This is a rather complex example of how to use PREPROC in an
  4. object-oriented approach to create an intricate model for SURFMODL.  
  5. You will need about 470KB of free disk space to create this model,
  6. although when you are done you can throw away all but about 160KB
  7. of that.  There are two ways to construct the model from scratch.  
  8. The easy way is to use the MKAPPLE.BAT file by typing:
  9.   MKAPPLE
  10. from the main SURFMODL directory.  If you have Borland's MAKE utility 
  11. and you want to get fancy, copy the provided MAKEFILE into this directory 
  12. and type:
  13.   MAKE
  14. They both take just as long to run, but the advantage to the makefile
  15. approach is that it uses a dependency list to automatically recreate
  16. files as they are needed.  This is only an issue if you want to play
  17. around with the model to change parameters.
  18.  
  19. When you are done, you can throw away all the output files except
  20. the one called APPLE.SRF.  You can now view APPLE.SRF with SURFMODL, in the
  21. usual way.
  22.  
  23. If you would like to make a movie for use with the PLAYBACK utility,
  24. you will find several .INI files provided: APPLE1.INI, APPLE2.INI,
  25. etc.  These files are all the same, except that they have slightly
  26. varying view points.  The MKMOVIE.BAT file uses these .INI files
  27. to create several views so you can save the screens to disk.
  28. To run it, type:
  29.   MKMOVIE
  30. As each new image is displayed on the screen, it is automatically
  31. saved to disk and then the next image is created.  When you are done, 
  32. you can play it all back by typing:
  33.   PLAYBACK APPLE.PLY
  34. and be impressed with the movie!
  35.  
  36. NOTE: This is a big model, so be prepared to wait a few minutes for
  37. some of these steps.  (On a VGA system in 256-color mode, the entire
  38. process may take more than an hour on some systems!)  Also, you will 
  39. need versions of both SURFMODL and PREPROC that have been compiled with 
  40. the BIGMEM option to allow many nodes and surfaces.  (This is now the 
  41. default that I ship as standard on the installation disks, so this is 
  42. probably what you have.)  Finally, please note that PLAYBACK has to have 
  43. enough free memory to read ALL the images into RAM before it will start the
  44. animation.  This is especially a problem if you are using one of
  45. the high-resolution VGA modes, which can require more than 64KB for
  46. a single image!  If PLAYBACK reports that you do not have enough
  47. memory for the animation, you have a few options:
  48.  
  49.   1. Remove any large memory-resident (TSR) programs that you may
  50. have loaded.
  51.  
  52.   2. If you have extended memory in your system, you may want to
  53. install the HIMEM.SYS extended memory manager (provided with the
  54. SURFMODL distribution disks), or a compatible memory manager like
  55. QEMM or 386-Max.  This allows PLAYBACK to store images in extended
  56. memory.  Unfortunately, PLAYBACK animations are somewhat slower when
  57. using extended memory, due to the extra memory moving involved.
  58. Therefore, you will not see the smooth animations that are possible
  59. when only using standard RAM.  Also, please note the possible bug
  60. in PLAYBACK when using extended memory, as documented in 300NOTES.TXT.
  61.  
  62.   3. Edit the APPLE.PLY file so there are not so many images in the
  63. animation.  This will cut down on RAM usage, since RAM usage is
  64. proportional to the number of images.
  65.  
  66.   4. You can re-run SURFINST and select a lower-resolution graphics
  67. mode, or one with fewer colors.  If you have a VGA, you may want
  68. to use one of the EGA modes or (gasp!) even a CGA mode.  Of course,
  69. the pictures will not look as sharp but at least you can see the
  70. animation.
  71.  
  72. One last note.  Of all of the above fixes, only #4 requires you to
  73. re-run MKMOVIE.BAT.  If you do re-run it, keep in mind that a whole
  74. new set of picture files will be created; it will not overwrite the
  75. old ones.  That is, the first time you ran it you created APPLE.1,
  76. APPLE.2, and so on up to APPLE.9.  If you do not delete these files,
  77. and run MKMOVIE.BAT again, you will now create new files called
  78. APPLE.10, APPLE.11, and so on.  Not only will you be wasting disk
  79. space, but you will never even see the results of re-running MKMOVIE!
  80. That is because the names APPLE.1, APPLE.2, etc. are specifically
  81. used in the APPLE.PLY file.  So make sure you delete all nine of the
  82. old files before re-running MKMOVIE.BAT.
  83.  
  84. Hope you find this adventure enjoyable!
  85.  
  86. ..KVC
  87.