home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / graphics / lissajous_1 / !Lissajous / !Help < prev    next >
Text File  |  1994-10-05  |  5KB  |  126 lines
  1.   ________________________________________________________________________
  2.  /                                                                        \
  3. |                !Lissajous v1.00: Lissajous Function Plotter              |
  4. |                              January 1992                                |
  5. |                             by Mike Curnow                               |
  6.  \________________________________________________________________________/ 
  7.  
  8. Quick Start
  9. ===========
  10. Double click on !Lissajous to load, then press menu over the icon bar icon
  11. and select draw. The default Lissajous figure will be drawn. Use the cursor
  12. keys to alter the plot and Return to restore the plot values. Return to the
  13. desktop by clicking any mouse button. Click on the Lissajous icon to open
  14. the Edit window to allow the Lissajous function to be changed.
  15.  
  16. Introduction
  17. ============
  18. !Lissajous is a desktop application for plotting different Lissajous curves.
  19. Lissajous curves were investigated by the man of the same name back
  20. in 1857. They are most familiar in their appearance on oscilliscope
  21. displays. In essence a Lissajous curve is the graphed result of a function
  22. of SIN or COS. The variety of displays are produced by plotting different x
  23. & y values against each other. 
  24.  
  25. !Lissajous allows you to try out different functions and to dynamically
  26. control the plot. The resulting functions can be saved and used within
  27. !TidyDesk's screen blanker.
  28.  
  29. Draw
  30. ====
  31. To enter draw mode, select draw from the menu or click on Draw in the Edit
  32. panel. The screen is cleared and the plot commences. Use the following keys
  33. to control the plot:
  34.    ⇦ decreases the x plot
  35.    ⇨ increases the x plot
  36.    ⇩ decreases the y plot
  37.    ⇧ increases the y plot
  38.    Return restores the x/y values to their settings
  39. Press any mouse button to exit the drawing mode.
  40.  
  41. Edit
  42. ====
  43. To enter edit mode, click on the !Lissajous icon, or select Edit from the
  44. menu. Click on a field to enter input mode. The title shows the name of the
  45. Lissajous file being editted, or <new> if it has not been saved yet. There
  46. are 3 sections on the editing panel - the source numbers and function for
  47. the x and y axes, and the start points for each of the axes.
  48.  
  49. Data: supply the minimum and maximum values of the x/y values as input to
  50. the function. Min and Max values may be given as simple numbers or as
  51. expressions using BASIC's standard functions eg. 2*PI, LOG(10). The function
  52. is made up of BASIC functions operating on the x/y value - thus x or y must
  53. appear somewhere in the expression. The resulting value of the function you
  54. enter is used as the value of the x/y plots. Typically functions are based
  55. on SIN and COS, but other functions can also be used.
  56.  
  57. Setting the Y Data 'Same as X' button on makes the Y data values the same as
  58. X and prevents you entering data into the Y Data fields.
  59.  
  60. Start Point: !Lissajous does not continuously evaluate the functions, but
  61. pre-calculates 256 values from Min to Max. The Initial x/y values are the
  62. index into the table of these 256 values. The values wrap around at 256, but
  63. may be specified as negative numbers as well. The Current x/y values show
  64. the index values after using the cursor keys during plotting, allowing you
  65. to set new Initial x/y values.
  66.  
  67. OK: click for your input to be entered and evaluated. An error message will
  68. be produced if the function produces an invalid number (too large or small).
  69.  
  70. Draw: Same as OK but then enters draw mode to show the resulting plot.
  71.  
  72. Cancel: discards the data and closes the Edit window.
  73.  
  74. Notes: If you press Select over OK or Draw, the Edit box will be closed, but
  75. not if you use Adjust. Load the sample Lissajous files to see how functions
  76. can be defined. Use the up/down cursor keys or Return to move around the
  77. editable fields. A plot can be reversed by swapping the Min & Max values -
  78. eg. Min=2*PI Max=0 is valid.
  79.  
  80. Saving And Loading Data
  81. =======================
  82. The function data can be saved by selecting Save from the menu - it operates
  83. in the standard RiscOS way. Saved files are loaded br dragging onto the
  84. Lissajous icon or into the Edit window. If you double click on a Lissajous
  85. file it is loaded into !TidyDesk, not !Lissajous.
  86.  
  87. The supplied Lissajous directory contains some sample Lissajous functions.
  88. The name of the current file is shown in the Edit panel title.
  89.  
  90. --------------------------------------------------------------------------
  91. Extensions
  92. ----------
  93. There are several ways you might like to extend this program. 
  94.  
  95. 1) Plot more points - currently 256 are plotted, but the plot mechanism is
  96. fast enough to allow many more points to be plotted each screen refresh.
  97.  
  98. 2) Multiple plots - using the same function data, different x & y index
  99. points can be used to show the plot at different phases.
  100.  
  101. 3) Colour - possible in 16 or 256 colour modes, but you will need to change
  102. the plotting mechanism.
  103.  
  104. I would be interested in seeing any successful results.
  105.  
  106. --------------------------------------------------------------------------
  107.  
  108. Copyright
  109. ---------
  110. This software is copyrighted by Mike Curnow and IS NOT PUBLIC DOMAIN.
  111. However permission is hereby granted for use of !Lissajous 1.00 on any
  112. machine so long as no charges are levied for its usage. This software must
  113. not be resold without prior consent from the author. 
  114.  
  115. !Lissajous is based on an original program by Michael St Aubyn published in
  116. Acorn User in November 1985.
  117.  
  118. Mike Curnow,
  119. Stoneleigh
  120. Swan Lane
  121. Great Bourton
  122. Banbury
  123. OX17 1QR
  124.  
  125. SAE with all correspondance please.
  126.