home *** CD-ROM | disk | FTP | other *** search
/ Fujiology Archive / fujiology_archive_v1_0.iso / !MAGS / !BONUS / COVERDSK / STFORMAT / STF34.ZIP / STF34A.MSA / VOLUME / VOLUME.DOC < prev    next >
Text File  |  1992-02-06  |  8KB  |  195 lines
  1.             VOLUME.PRG  created by     XAVIER LAMBRECHT
  2.                                     67, VOIE DE L'ARDENNE
  3.                                         4053 EMBOURG
  4.                                            BELGIUM
  5.  
  6. To run VOLUME, you need VOLUME.PRG and ANIME.PRG (no more)
  7. On the disk, there are many examples of what you can do with VOLUME.
  8. This program only work in low res.
  9.  
  10. 1.INTRODUCTION
  11. --------------
  12.      VOLUME is a public domain program. It's very useful to draw 
  13. revolution's volumes and to color them.
  14. The only thing you have to do is to define a profile and an outline
  15. (for the revolution) or many outlines if you want a complex volume.
  16. Then you can orientate the created volume.
  17. The window with compute options is only available if the volume is 
  18. correctly defined (i.e. the "QUIT" button of the editor is green).
  19.     Then, you have to click with mouse's left button on the 
  20. "ORIENT + LIGHTING" button (orientation and lighting are then computed)
  21. or just on "ORIENT" button (if you want another view of the volume 
  22. with the same lighting) or on "LIGHTING" (if you want to see the volume
  23. with the same orientation but with a different lighting).
  24.  
  25.  
  26. 2.THE VOLUME EDITOR
  27. -------------------
  28.     After you have clicked on "EDIT VOLUME", the editor appears.
  29. On the left you have the profile editor which contains a grid to 
  30. draw the profile, a button "CLEAR" to delete all the profile and a 
  31. button "SPLINE" to have a  smooth profile.
  32.  
  33. 2.1 PROFILE EDITOR
  34. ------------------
  35. 2.1.1 GRID
  36.  
  37.     If you click in the grid with the left Mbutton, a point 
  38. appears. If you click in an other place, a line appears between 
  39. the two points.By this way, you can draw a profile. If you click 
  40. on the right Mbutton you start a second profile (you can do that 
  41. five times)    
  42.  
  43. 2.1.2 CLEAR
  44.  
  45.     The "CLEAR" button deletes the profile (to use very carefully!).
  46.  
  47. 2.1.3 SPLINE
  48.  
  49.     This function uses the cubic splines method.
  50. On the right of the screen, there is a SPLINE cursor which 
  51. displays the number of faces you'll have after you spline your 
  52. profile. The new profile is then displayed on the grid.
  53. You're not obliged to use this function.
  54.  
  55. 2.2 OUTLINE EDITOR
  56. ------------------
  57.     On the right of the screen, you can see 8 buttons, the SPLINE 
  58. cursor, a place where the current outline id displayed and a 
  59. vertical cursor to select the desired outline. There are 40 
  60. outlines. The five first ones are already defined but you can 
  61. redefine them.
  62.  
  63. 2.2.1 DEFINE OUTLINE
  64.  
  65.     Clicking on this button with the right Mbutton redefines the 
  66. fist five outlines according to the program library (there are 3
  67. basic sets of outlines). 
  68. When you click on this button with left Mbutton, a new circular 
  69. grid appears on the screen and you can define the current 
  70. outline.
  71. Then you draw the outline the same way you drew the profile. The 
  72. buttons SPLINE and CLEAR are still usable. Press ESC if you want to
  73. quit without defining the outline. You are obliged to click SPLINE 
  74. to end outline definition.
  75.  
  76. 2.2.2 SPLINE OUTLINE
  77.  
  78.     You can use this function to compute the intermediate outlines 
  79. between the first and the last defined ones, So that you have smooth 
  80. variations along the Z axis.
  81.  
  82. 2.2.3 SELECT OUTLINE
  83.  
  84.     If you click this button with the left Mbutton, all the points of 
  85. the profile will be linked to the current outline and the 
  86. volume will thus be defined with the current outline.
  87. But if you have used "SPLINE OUTLINE" before, you can automatically
  88. link all the points of the profile to the computed outlines by 
  89. clicking the right Mbutton (even if the number of points is different
  90. than the number of computed outlines, thus effectively using the
  91. Z-axis variation of outlines
  92.  
  93. 2.2.4 VERTICAL CURSOR
  94.  
  95.     Use the left Mbutton to select the desired outline.
  96. Use the Right Mbutton to copy an outline: when the cursor is on 
  97. the desired outline, click on it and move it to an other outline 
  98. and the first will be copied on the second.
  99.  
  100. 2.2.5 MULTIPLE OUTLINE
  101.  
  102.    You can link each point of the profile to one of the 40 outlines.
  103. A little square appears around the first point of the profile.
  104. Select an outline using the vertical cursor, then click on 
  105. "SELECT OUTLINE" to link the outline to the point and the square goes
  106. to the next point.
  107. During this operation, all the functions about outlines are usable.
  108.  
  109. 2.2.6 CLEAR
  110.  
  111.     You can delete the current outline by clicking the "CLEAR" 
  112. button with the left Mbutton. WARNING:if you click it with the 
  113. right button, all the outlines will be deleted...
  114.  
  115. 2.2.7 LOAD, SAVE
  116.  
  117.     You can load 3 things: 1. PROFILE (.PRF) Save just your profile
  118.             save           2. VOLUME (.VOL)  Save defined volume
  119.                            3. OUTLINE (.OUT) 
  120.  
  121. When you save an outline, you save the current one
  122. WHEN you load an outline, you load it on the current one
  123.  
  124. 2.2.8 QUIT
  125.  
  126.     If the button is red, the volume isn't well defined and you 
  127. will not be able to compute it. If the button is green, all is
  128. OK.
  129.  
  130. 3.MAIN SCREEN
  131. -------------
  132.      Now, suppose that the volume is well defined. You can see five 
  133. windows on the screen.
  134.  
  135. 3.1 EDIT WINDOW
  136. ---------------
  137. On the first, there are two button: 1.EDIT VOLUME
  138.                                     2.EDIT PARAMETERS
  139. If you click the second, a new screen appears.Just see all the 
  140. cursors and buttons:it's very easy to use.
  141.  1.OUTLINE(used to define the characteristics of the revolution drawing)
  142.  2.LIGHTING(used to define the coordinates of the light source)
  143.  3.VOLUME(used to move or scale the volume)
  144.  4.PERSPECTIVE(use to define the coordinate of the observer; z being
  145.                the distance between the object and the drawing plane
  146.                and (x,y) being the coordinate in the drawing plane)
  147.  
  148. Changing parameters in 3. or 4. need no other computation just click
  149. on "DO VOLUME".
  150. You can choose the type of drawing (COLOR,FILL,LINE) and the type of 
  151. faces (RECTANGULAR or TRIANGULAR).
  152. Color modifies the faces color according to an exterior light source,
  153. FILL draw all the faces in one color, LINE is a wireframe representation
  154. (transparent faces).
  155. If you change the type of faces, you will have to do a new computation.
  156.  
  157. 3.2 COMPUTE WINDOW
  158. ------------------
  159. If the volume is not yet computed, click on "ORIENT + LIGHTING" 
  160. or "ORIENT" or "LIGHTING".
  161. You can select the color of the volume: Red, Green, Blue.
  162. When the computation is ended, a new button appears on the DRAW WINDOW;
  163. "DO VOLUME".
  164. You can also realize an animation with "ANIMATE".
  165. A new screen appears. First choose the animation's parameters then
  166. either try the animation (without saving it on disk) or start it
  167. (it is then saved on disk).
  168. The program will create (you can stop it by pressing ESC) many
  169. pictures(.PI1). You will have to use ANIME.PRG to see the animation.
  170.  
  171. 3.3 DRAW WINDOW
  172. ---------------
  173.     Clicking on "DO VOLUME" starts to draw the volume.
  174. If you click on "SEE VOLUME", you can see what currently is in the 
  175. drawing screen.
  176. "LOAD" a picture (.PI1) on the drawing screen.
  177. "SAVE" the drawing screen on disk (.PI1).
  178. "PRINT" makes a hardcopy of the drawing screen.
  179.  
  180. 3.4 ORIENTATION WINDOW
  181. ----------------------
  182.     You can choose the orientation of the volume (using spheric 
  183. coordinates plus spin around the initial Z axis)
  184. Then you have to compute to have the new volume.
  185.  
  186. 3.5 CONTROL WINDOW
  187. ------------------
  188.     "GOTO GEM" allows you to use an accessory (loaded before you start 
  189. VOLUME.PRG) like SNAPSHOT. But this option doesn't yet work very well...
  190. "INFO" gives you the volume specifications and memory free on disk.
  191. "QUIT" Bye, bye.
  192.  
  193. PS: This program is probably not BUGS free (nobody is perfect!!!).
  194.     I hope you a good work.
  195.