home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / graphics / utility / zplotter / zplotter.doc < prev    next >
Encoding:
Text File  |  1985-11-19  |  5.7 KB  |  125 lines
  1.  
  2.      Version 2.0                                   April 1987
  3.                          Z-Plotter Documents
  4.                          -------------------
  5.  
  6.           Zplotter is a three-dimensional plotting program that
  7. allows you to choose an equation and plug in various ranges for
  8. the X, Y, and Z axis. The maximum and minimum ranges for the X,
  9. Y, and Z axis are used as a virtual "telescope", allowing for a
  10. local sighting or a worldly view of a specified graph. A graph
  11. can be plotted in various resolutions by changing its resolution
  12. factor. This is not the same as the Atari ST's Low, Medium, and
  13. High resolutions! The resolution factor changes the graph's
  14. roughness, giving it a less detailed graph in a less amount of
  15. time, and it's smoothness, giving it a more detailed and more
  16. realistic graph, but in a much longer time period.
  17.  
  18.           To run Zplotter, load ZPLOTTER.PRG using the GEM
  19. Desktop or a Command Line Interpretor. Once booted, Zplotter
  20. will acknowledge itself by bringing up a dialog box giving it's
  21. name and other various information. From here, click on the
  22. 'Zplotter' box using the mouse, or just hit the RETURN key.
  23. Once the 'Zplotter' dialog box has banished from sight, move
  24. the mouse up to the 'Parameters' title on the menu bar. From
  25. here, select the 'Formula' index. A 'Formula' dialog box should
  26. appear. Choose a formula by typing its corisponding number at
  27. the prompt then hit the RETURN key or select the 'OK' button.
  28. Next, select 'Parameters' under the 'Parameters' menu bar and
  29. type in the ranges that the dialog box asks for. Hit RETURN or
  30. click the 'OK' button when finished. If you have selected a
  31. formula and filled in all the ranges then go to the 'Graph'
  32. title on the menu bar. Select 'Plot'. The screen should clear
  33. and the graph you selected should start plotting. When the graph
  34. is completely finished plotting you can re-enter another graph
  35. by depressing the left mouse button. Depressing the right
  36. mouse button while the graph is still on the screen will cause
  37. a box to be drawn around the graph. This will help bring out the
  38. three-dimensional effect. If you wish to view the title screen
  39. again, just go to the 'Desk' and select 'Z-Plotter'. If you so
  40. happen to ( Heaven Forbid! ) get tired of Zplotter and wish to
  41. quit, just select 'I Wanna Quit!' under the 'Tired?' menu.   
  42.  
  43.  
  44.                          COLD EQUATIONS
  45.                          --------------
  46.  
  47.           In converting this program from BASIC to Pascal,
  48. various problems had arisen. The major problem is the limitation
  49. of the amount of formulas to chose from. In the BASIC version,
  50. the user would only have to type in the formula at the given
  51. prompt. The formula would be forced into the actual program
  52. for later references for the plotting routines to use.
  53. Unfortunately, accomplishing this feet isn't that simple in Pascal.
  54. Using a VAL function, such as that used in Turbo Pascal, might
  55. work, but the current Personal Pascal language I'm using does
  56. not have that function. If anyone knows an easy way of converting
  57. a formula stored into a STRING into a REAL number please leave
  58. me a message on Al's Used BBS [513-433-6815], Late Night BBS
  59. [513-293-5448], or CompuServe [76316,154].
  60.  
  61.                   
  62.                          LITTLE BOOGERS                    
  63.                          --------------
  64.  
  65.           Here are a few of the known bugs in the 2.0 version of
  66. Zplotter.
  67.  
  68.      Number One: Try to avoid placing zeros in the maximum and
  69. minimum ranges at the same time. This may cause the program to
  70. divide by zero, resulting in a program shutdown.
  71.  
  72.      Number Two: The toggling between the create/uncreate box
  73. feature happens so quickly that it will toggle through several
  74. times before you let off the right mouse button once! Try to 
  75. bear with it for now, please.
  76.  
  77.      Number Three: Try to avoid using Application files with
  78. Zplotter. Zplotter does not know when an application has been
  79. activated, therefore, not knowing when to activate its redraw
  80. events.
  81.  
  82.           These bugs will soon be destroyed and new features will
  83. be added to the existing version of Z-PLOTTER - along with some
  84. more of those little boogers.
  85.  
  86.  
  87.                      TRY THESE PARAMETERS FOR SIZE
  88.                      -----------------------------
  89.  
  90.         Formula                 Z(low)  Z(upp)  x/y(low)  x/y(upp)
  91.         -------                 ------  ------  --------  --------
  92.      Z=sin(x)*cos(y)              -1       1       0          6
  93.      Z=(y-1)*(x+2)*x*x            -4       4      -3          3
  94.      Z=ln(abs(x))+ln(abs(y))      -6       1      -2          2
  95.      Z=abs(x)-abs(y)              -3       3      -3          3
  96.      Z=abs(cos(x)+cos(y))          0       2      -8          8
  97.      Z=1+x*x-y*y                   0       6      -3          3
  98.  
  99.  
  100.                             NOT TO BE SOLD
  101.                             --------------
  102.  
  103.                 Z-PLOTTER is Public Domain - Not to be sold!
  104.  
  105.      Portions of this product are Copyright (c) 1986, OSS and CCD.
  106.                       Used by permission of OSS.
  107.  
  108.  
  109.                    CREDIT - WHERE CREDIT IS SURELY DUE
  110.                    -----------------------------------
  111.  
  112.           This pascal version of Zplotter could not have been
  113. programed without the help of the BASIC version of Zplotter
  114. created by David Bader ( This version appeared in the May 1985
  115. issue of A.N.A.L.O.G Computing Magazine. ), and Peter Lee
  116. Poon-Hang's "Three-Dimensional Plotting" which appeared in the 
  117. April 1982 issue of Creative Computing. I suggest getting these
  118. two magazines ( somehow ) if you are interested in more information
  119. on three-diminsional graphing.
  120.   
  121.  
  122.                                             - Sean Barnes -
  123.  
  124.  
  125.