home *** CD-ROM | disk | FTP | other *** search
/ Acorn User 4 / AUCD4.iso / art_design / imaging / draw_zerr / !DrawZerr / !Help < prev    next >
Text File  |  1994-07-20  |  3KB  |  89 lines
  1. ************************************
  2. * D r a w   Z e r r           1.10 *
  3. *                                  *
  4. * © 1994  Andreas Feldner          *
  5. *          of the "Flying Snails"  *
  6. ************************************
  7.  
  8.   This program allows you to transform Draw files
  9. using arbitrary mathmatical equations. It operates
  10. by transforming every point in the Draw file, but
  11. it does not change the junctions between the
  12. points (i.e. a staight line stays a straight line).
  13.  
  14.   Sprites and text lines are only shifted, but not
  15. transformed (unless converted to paths). This
  16. program cannot handle rotated sprites or texts
  17. (these are left unchanged).
  18.  
  19.   You start the program by double clicking on its
  20. icon in the filer window. It installs itself on
  21. the icon bar. Click on its icon to open a display
  22. window and a setup dialogue box.
  23.  
  24.   You can load a Draw file by dragging it into the
  25. display window. Initially, it will be shown
  26. undistorted. Now you can fill in the two
  27. transformation formulae in the setup dialogue box.
  28. Use the variables x and y to refer to the original
  29. co-ordinates of each point. Please note that you
  30. can use x in the formula for the new y co-ordinate
  31. and vice versa (thus allowing rotations, etc.).
  32. The expression syntax is quite similar to BASIC
  33. expressions and will be explained below. The unit
  34. length is one inch. When you are ready, click on
  35. the OK button to transform the file. The original
  36. version is still held in memory, so if you change
  37. the formula and click OK again, this refers to the
  38. original Draw file.
  39.  
  40.   You can restore the formulae for the currently
  41. displayed picture by clicking on the Reset button.
  42. This also clears all additional variables (see
  43. below).
  44.  
  45.   To save the transformed Draw file, click Menu
  46. over the display window and chose the Save option,
  47. which leads you to the familiar "Save as" dialogue
  48. box.
  49.  
  50.  
  51.  
  52. The syntax for the formulae:
  53. ****************************
  54.  
  55. You can construct a formula using
  56.   
  57. a) Infix operators:
  58.  
  59.               +  -  *  /  ^
  60.               
  61.   (e.g. x+y, x^2+2*x*y+y^2)
  62.   
  63. b) Prefix operators:
  64.    -  SQR   SQRT   LN   LG   EXP   SIN   COS   TAN  
  65.    ABS   ATAN
  66.    (e.g. SQR(x), etc.)
  67.    
  68. c) Numbers:
  69.    123.45e-67, -2, etc.
  70.    
  71. d) Variables:
  72.    These consist of lower case characters. Only x
  73.    and y have a special meaning (the original
  74.    co-ordinates). Other variables may be used
  75.    freely; you get asked for their value before
  76.    the transformation begins. Once defined, the
  77.    variables keep their values until you click on
  78.    the Reset button in the setup dialogue box.
  79.  
  80.  
  81. Some typical formulae:
  82.      x axis                    y axis
  83. ----------------------------------------------------       
  84.      x                         LNy
  85.      x*COSphi-y*SINphi         x*SINphi+y*COSphi
  86.      5*COSx                    5*COSy
  87.      3*(COSx+SINy)             3*(SINx+COSy)
  88. ----------------------------------------------------
  89.