home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / graphics / blob1.zip / READ.ME < prev    next >
Text File  |  1994-02-15  |  8KB  |  277 lines
  1. BLOB SCULPTOR ( BS ) version 1.0 
  2. by Alfonso Hermida and Steve Anger    2/15/94
  3.  
  4. This program helps you manipulate and model 3D objects thru the use of
  5. blobs.
  6.  
  7.     THIS PROGRAM IS FREEWARE...BUT, USE AT YOUR OWN RISK.
  8.  
  9.  
  10.  
  11. ------------------------------------------------
  12. Requirements:  386 or better with coprocessor
  13.            VGA graphics card
  14.            mouse
  15. ------------------------------------------------
  16.  
  17. You can reach us at:
  18.  
  19. TGA BBS (510)524-2780
  20. Pi Square BBS (301)725-9080     (Alfonso's the Sysop)
  21. CompuServe: GraphDev forum
  22.  
  23. Thanks to:
  24.  
  25.        * Dan Farmer for the interest and enormous amount of feedback.
  26.        * Ronald Praver for speeding up suggestions.
  27.        * David K. Mason for the program's name.
  28.  
  29. -------------------------------------------------------------------------
  30. DEFINITION :   LMB  = Left Mouse Button
  31.            RMB  = Right Mouse Button
  32. -------------------------------------------------------------------------
  33.  
  34. *** I should put some info on blobs here....I'll do it later ****
  35.  
  36.  
  37. BS's display consists of 3 principal views:
  38.  
  39.                        Vertical Axis    Horizontal Axis
  40.    Top    (upper left window)               Z                 X 
  41.    Front  (lower left window)               Y                 X
  42.    Side   (lower right window)              Y                 Z
  43.  
  44. A preview window (upper right window reffered to as ISO) which can be 
  45. modified thru the CAMERA command.  Finally the right side is the MENU area.
  46.  
  47. The mouse horizontal and vertical coordinates are shown in the MENU area, 
  48. also the first letter of the view (or ISO for the preview window) where the
  49. mouse is currently located is displayed below the coordinates.
  50.  
  51.  
  52.               SUMMARY
  53.  
  54. Here's a summary of the commands.  After each command the letters
  55. F, S , T and Iso are used to define which views can be used in this command.
  56. If no letters are present, this doesn't apply.
  57.  
  58. BS saves the previous command.  To execute the previous command, click the 
  59. LMB. (Some of the commands can't be repeated - this is done either for
  60. convenience or for safety)
  61.  
  62.  
  63. LOAD & SAVE
  64.  
  65. BS reads and writes ASCII files with the following format:
  66.  
  67. threshold
  68. x y z strength radius
  69. x y z strength radius 
  70. x y z strength radius                                                                 
  71. x y z strength radius                                                                 
  72. ....etc....                                                                
  73.  
  74. Example: (file HAND.BLB)
  75.  
  76. 0.6
  77. -0.413502 0.0253165 0 1 1.50823
  78. 0.43038 -0.00843882 0 1 1.59972
  79. -0.548523 -1.18987 0 1 1.45752
  80. 0.700422 -1.20675  0 1 1.4348
  81. 1.49367 -0.548523 0 1 0.983246
  82. 1.72996 0.109705  0 1 0.747382
  83. 1.79747 0.683544  0 1 0.683805
  84. 1.82278 1.21519   0 1 0.676372
  85. 0.759494 0.911392 0 1 0.714533
  86. 0.742616 1.50211 0 1 0.676372
  87. 0.691983 2.16034 0 1 0.749914
  88. 0.599156 2.79325 0 1 0.708316
  89. 0.43038 3.50211 0 1 0.718941
  90. -0.21097 1.08861 0 1 0.679169
  91. -0.312236 1.74684 0 1 0.714533
  92. -0.464135 2.42194 0 1 0.629936
  93. -0.666667 3.09705 0 1 0.698434
  94. -0.919831 3.80591 0 1 0.715417
  95. -1.0211 1.0211 0 1 0.640875
  96. -1.30802 1.64557 0 1 0.621859
  97. -1.57806 2.23629 0 1 0.670744
  98. -1.86498 2.84388 0 1 0.620842
  99. -1.4346 -0.151899 0 1 1.21077
  100. -1.33333 -1.26582 0 1 1.24168
  101. -2.04219 0.691983 0 1 0.670743
  102. -2.4135 1.29958 0 1 0.674501
  103. 1.80591 1.90717 0 1 0.78531
  104. -2.75105 1.77215 0 1 0.555298
  105.  
  106. This file creates a 3D hand.
  107.  
  108. NEW
  109.  
  110. Deletes the whole database - fresh start!
  111.  
  112.  
  113. CREATE (F, T, S)
  114.  
  115. This command creates a blob component on any of the 3 principal views. 
  116. After selecting this command, click the LMB to define the center of the
  117. component.  Next, move the mouse to define the radius.  Press LMB to accept
  118. or RMB to CANCEL.
  119.  
  120. MOVE  (F, T, S)
  121.  
  122. You may move a component to another location at anytime by selecting the
  123. MOVE command.  To select the component to be moved, click on any part of the
  124. circle.  The circle will be highlighted (yellow color).  Now, move the mouse
  125. to the view where you want to do the move and press the LMB.  A ghost image
  126. will appear in case you want to locate it in it's original place.  Press LBM
  127. to accept the new location or RMB to CANCEL.
  128.  
  129. This command is different from most others because sometimes it's easier
  130. to select a component in a view different from the one where the move will be
  131. performed.
  132.  
  133.  
  134. COPY (F, T, S)
  135.  
  136. The COPY command behaves the same way as the MOVE command but doesn't delete
  137. the original component.
  138.  
  139.  
  140. RESIZE (F, T, S)
  141.  
  142. You may resize a component at anytime by selecting the RESIZE command.  To
  143. select the component to be resized, click on any part of the circle.  The
  144. circle will be highlighted and a beep will indicate that you may resize
  145. the component.  A ghost image will appear in case you want resize it to
  146. it's original size.  Press LBM to accept the new location or RMB to CANCEL.
  147.  
  148.  
  149. REDRAW 
  150.  
  151. This command refreshes ALL the views. Negative components are drawn in red.
  152.  
  153.  
  154. POVRAY, POLYRAY, RAW
  155.  
  156. Selecting any of these command will save the current scene in the appropriate
  157. format.  BS saves the scene with the name BLOB.?  where is
  158.  
  159.     BLOB.POV     for POVRAY
  160.     BLOB.PI      for POLYRAY
  161.     BLOB.RAW     for RAW data
  162.  
  163. If you have previews files with the same names they will be overwritten!
  164. If you need DXF output there are various utilities that can help you such
  165. as RAW_DXF. Read the end of this document.
  166.  
  167.  
  168. ZOOM (F, T, S, Iso)
  169.  
  170. To zoom In or Out, click on any of the views.  The mouse button will
  171. determine the zooming operation:
  172.  
  173.             LMB     Zoom In
  174.             RMB     Zoom Out
  175.  
  176.  
  177. DELETE (F, T, S)
  178.  
  179. To delete a component, click the LMB on any part of the circle.  You'll be
  180. asked if you want to continue.  To delete the object click on [OK].
  181.  
  182.  
  183. PAN (F, T, S)
  184.  
  185. You may perform panning by clicking on the PAN command.  By clicking
  186. on any of the 3 principal views, the point will become the center of that
  187. scene.  If the view gets out of limits and you can't return it back, reset
  188. it using the ORIGIN command.
  189.  
  190. ORIGIN (F, T, S)
  191.  
  192. This command puts the origin back in the center of the selected view. Click
  193. on the ORIGIN icon then click on one of the principal views....the 3D axis
  194. will appear in the center.
  195.  
  196.  
  197. CAMERA ( Iso )
  198.  
  199. Changes the From, At and Up vectors for the Iso view.
  200.  
  201. PREVIEW (Iso )
  202.  
  203. NOTE: Be sure that you have saved your data before previewing it!  This is
  204.       an experimental program.
  205.  
  206. Generates a wireframe representation of the current scene.  BS tries to
  207. display a hidden line representation, but some triangles may not show up.
  208. This doesn't affect the scene if it is saved as RAW data.  When saved as
  209. RAW data all the triangles will be written.
  210.  
  211. DENSITY (F, T, S)
  212.  
  213. Select a component to change it's strength(density) value.  The value can
  214. be positive or negative.  To accept the default value press [Enter].
  215.  
  216. DETAIL
  217.  
  218. This value, between 20 and 50 determines the resolution in the algorithm used
  219. to evaluate the blob surfaces.  The values affect the program in this way:
  220.  
  221.         20     fastest,  least resolution, uses less memory
  222.         :
  223.         :
  224.         50     slowest,  best resolution,  uses more memory
  225.  
  226. For PREVIEWing, it's good to have a small number, between 20 and 30.  For the
  227. final image generation, 30 and up is good (unless you like the resolution
  228. given by lower numbers).
  229.  
  230. Needless to say, the higher the number, the greater the number of triangles
  231. that will be generated when creating RAW data output.
  232.  
  233.  
  234. THRESHOLD
  235.  
  236. Changes the Threshold value for the blobs.
  237.  
  238.  
  239. SNAP
  240.  
  241. Turns On/Off the SNAP feature.
  242.  
  243. Grid  &  ROW/COL
  244.  
  245. The GRID command enables the grid.  The grid is redrawn with every redraw.
  246. The ROW/COL command sets the number of divisions (# of rows = # columns) in
  247. the grid.
  248.  
  249.  
  250. QUIT
  251.  
  252. Exit the program.
  253.  
  254. WHO
  255.  
  256. Tells you who the authors are! Click the mouse to erase the Info box.
  257.  
  258. ------------------------------------------------------------------------
  259.  
  260. ADDITIONAL INFO:
  261.  
  262. * THRESHOLD          default value 0.6
  263. * STRENGTH (DENSITY) default value 1.0
  264. * Maximum number of components is 100
  265. * ROW/COL value      default value 20
  266. -------------------------------------------------------------------------
  267.  
  268.  
  269.             RAW TO DXF TRANSLATOR
  270.  
  271. Included is a simple QBasic/QuickBasic program to translate RAW data to
  272. DXF format.  The triangles are saved as 3DFACE entities.  The source code
  273. is included so you can tweek it.
  274.  
  275.  
  276.  
  277.