home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Raytrace & Morphing / SOS-RAYTRACE.ISO / programm / utility / windows / objrep / obj_rep.dat < prev    next >
Encoding:
Text File  |  1994-02-21  |  5.2 KB  |  160 lines
  1. #######################################                                     
  2. Object Replicator for Windows    
  3. Version 1.3             
  4. 02/21/94    John Kolesar       
  5. Compuserve ID: 70511,3007      
  6. #######################################
  7.  
  8.  This is a quick POV 2.0 scene generator for creating multiple copies of an 
  9. object you already have defined, and translates them randomly in an area you 
  10. define.  It can also add random Rotation, Pigment color and Size.
  11.  
  12.  Did you ever create an object and want to use multiple instances of it in 
  13. your scene, but dreaded typing in all the repeating code necessary?  
  14. Especially if you wanted them each to have different colors, rotations etc.  
  15. Now you can see what your object looks like scattered all over the place, and 
  16. have many different colors, sizes and rotations, with little or NO typing of 
  17. code!  
  18.  
  19.  All you need is an include file containing your declared object with 
  20. texture (Replicator won't create any textures for you...yet). You don't even 
  21. need a camera, light_sources, floors etc. There's a file BASIC.POV included 
  22. that Object Replicator can add to. Don't modify it though, so Replicator 
  23. always has a clean default file. Modify a copy of the file if you want to 
  24. use it. The basic scene file has a camera, 2 light_sources, a floor 
  25. (checker of course), and a sky sphere. The scene is set up for Replicator's 
  26. Area Limits defaults and Random Object Sizes defaults.  Its best if your 
  27. object is scaled to <1.0, 1.0, 1.0>, so the screen won't be TOO cluttered.  
  28.     
  29.  If you want to use your own scene file, you can have Replicator append its 
  30. output to it. Just make sure the declared object (with texture) is in your
  31. file somewhere (or in an include file off of yours). 
  32.  
  33.  
  34. QuickStart:
  35. ===========
  36.  
  37. If you don't have a file to append to:
  38. ------------------------------------------------
  39.  
  40. Select the 'Create' option.
  41. Rename the 'Filename to Create' if you need to.
  42. Select your 'Include Filename' using the menu or double-click in the box.
  43. Type the Object's name in the box to Replicate.
  44. Type the # of Replications in the box (test it with 10 or 20 first).
  45. Use Defaults for everything else.
  46. Click the 'Replicate!' button.
  47. Render your scene.
  48. Say WOW, that was easy...
  49.  
  50.  
  51. If you do have a file to append to:
  52. ---------------------------------------------
  53.  
  54. Select the 'Append' option.
  55. Select your 'Append to' file using the menu or double-click in the box.
  56. Type the Object's name in the box to Replicate.
  57. Type the # of Replications in the box (test it with 10 or 20 first).
  58. Set the Area Limits to where your camera is looking at.
  59. Use Defaults for everything else.
  60. Click the 'Replicate!' button.
  61. Render your scene.
  62. Say WOW, that was easy too...
  63.  
  64.  
  65. Some guidelines to follow:
  66. ==========================
  67.  
  68. When you type in additional Texture modifiers in the box within Replicator, 
  69. you can put anything in that box that you would normally put inside:   
  70. texture{.....}.     (Don't actually type the 'texture' keyword or its 
  71. braces '{}' in the box, Replicator will do that for you). 
  72.  
  73. If you don't want random colors, you can choose the color for all 
  74. Replications.  For now, you are limited to the color choices in the color 
  75. pick-list.  There are 100 of the colors defined in the COLORS.INC that came 
  76. with POV.
  77.  
  78. When typing the name of your Object, remember it's case-sensitive.
  79.  
  80. If you de-select 'Random Object Rotation', it will be oriented just the way 
  81. you created it, with no additional rotation.
  82.  
  83. Remember 'Random Object Sizes' Scales in addition to what you already scaled 
  84. it to. That's why its best to start with an object scaled to <1.0, 1.0, 1.0>.
  85.  
  86. Try to create your objects at < 0 0 0 >, so Replicator can translate them 
  87. correctly.
  88.  
  89. 'Area Limits' work the same way as the box in POV.  The two Vectors are 
  90. opposing corners of the Area, or box.
  91.  
  92.  
  93.  
  94.  
  95.  
  96. Last but not least, I know all Replicator does is output some text, but
  97. anyway:
  98.  
  99.  
  100.  
  101. DISCLAIMER
  102. =============
  103.  
  104. 'Object Replicator' (and its accompanying files) is a freeware software
  105. package.  If you use Object Replicator, you agree to
  106. the following:
  107.  
  108. The software package 'Object Replicator' is provided as is
  109. without any guarantees or warranty.  The Author is not
  110. responsible for any damage or losses of any kind caused by the
  111. use or misuse of this software package.
  112.  
  113.  
  114.  
  115. Hey, whad'ya expect for free?
  116.  
  117.  
  118. I created Object Replicator in my 'spare' time with Visual Basic 3.0.  
  119. Let me know what you think of it, and if it needs any additional features.  
  120. My Compuserve ID is 70511,3007.
  121.  
  122. Please upload Object Replicator to your favorite BBS's where POV can
  123. be found.
  124.  
  125.  
  126. Rev. History
  127. --------------------
  128.  
  129. 1.2 2/17/94 Added missing file VBDB300.DLL
  130.  
  131. 1.3 2/21/94 Changed program so it doesn't require ANY database related files.
  132.  
  133.  
  134.  
  135. Possible future revisions:
  136. ------------------------------------
  137. (if any interest arises)
  138.  
  139.  
  140. Ability to add custom colors to the database within Replicator.
  141.  
  142. Options for selective X, Y or Z rotation.
  143.  
  144. Options for selective X, Y or Z scale.
  145.  
  146. Option for random Texture modifiers.
  147.  
  148. Ability to select different floors & skies from a list.
  149.  
  150.  
  151.  
  152. One final note:
  153. --------------------
  154.  
  155. Don't want money; Want a job in computer graphics :)
  156.  
  157.  
  158.  
  159.  
  160.