home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / education / multiplot / !MultiPlot / !help < prev    next >
Text File  |  1992-03-19  |  10KB  |  293 lines
  1. !MultiPlot, © Chris Johnson, 1991
  2.  
  3. *********************************************************
  4.  
  5. ACKNOWLEDGEMENT
  6.  
  7. THIS PROGRAM WAS COMPILED USING THE DABS PRESS ARCHIMEDES
  8. BASIC COMPILER (ABC)
  9.  
  10. *********************************************************
  11.  
  12.  
  13. The software referred to in these notes is NOT placed
  14. into the  public domain, but remains the copyright of
  15. the author, Chris Johnson. It should not be posted on
  16. any bulletin boards or supplied as public domain
  17. software. It is available free of charge to all
  18. registered users of Graphdraw.
  19.  
  20.  
  21. **********************************************************
  22.  
  23.  
  24. What This Software Does
  25.  
  26. This fully RISC-OS compliant multitasking 
  27. application allows the plotting of up to five graphs on 
  28. the same set of axes. Suitable data files may be 
  29. produced using e.g. !GraphDraw, !FnPlotter or 
  30. !CurveFit. This application does not allow the direct 
  31. entry of data, and does no data processing. It simply 
  32. combines several graphs onto the same set of 
  33. scaled axes.
  34.  
  35. **************************************************
  36.  
  37. Multiplot now fully supports Acorn's !Help application.
  38. When the !Help window is open, information on
  39. Multiplot's windows and icons is continuously displayed.
  40.  
  41. ***************************************************
  42.  
  43. Running the Application
  44.  
  45. As a fully RISC-OS compliant application it can be 
  46. started from within the desktop in all the normal 
  47. ways.
  48.  
  49. NB. The display of the graph uses outline fonts to 
  50. annotate the axes etc.. It is therefore necessary for 
  51. the operating system to have "seen" the !fonts 
  52. directory before the program is run. Otherwise an 
  53. error message may be generated. The default font 
  54. used is Trinity.Medium, since this comes on the 
  55. RISC-OS applications disc, and both old and new 
  56. version font managers can deal with it (the new 
  57. outline font manager will work with the old 
  58. bitmapped fonts). It is possible to change to a 
  59. different font, and to make a different font the default 
  60. if you wish.
  61.  
  62. Double clicking on the !MultiPlot icon in a directory 
  63. viewer will install its icon on the icon bar. 
  64.  
  65. The application may also be started by double 
  66. clicking on any !MultiPlot data file in a directory 
  67. viewer. This will only work if the !MultiPlot 
  68. application has been 'seen' by the filer, so that the 
  69. filer knows to run !MultiPlot before loading the file. If 
  70. the application is started in this way, besides the 
  71. icon appearing on the icon bar, the icon will show 
  72. the number of data files loaded.
  73.  
  74.  
  75. The Iconbar Menu
  76.  
  77. Clicking 'menu' on the iconbar icon will bring up a 
  78. menu with the following options.
  79.  
  80.  
  81.  
  82. Info
  83.      A standard information window with version 
  84. number. This is the number that should be 
  85. quoted in any communication regarding the 
  86. application.
  87.  
  88. Plot graph
  89.      This option will open a window showing a  graph of
  90. the loaded data. The style of the  graph is the same as
  91. that of the !GraphDraw  application. A submenu will
  92. allow the plot to use semi-log or log-log axes. The
  93. programs traps (I hope) attempts to take the log of zero
  94. or a negative number.
  95.  
  96. Options...
  97.      Selecting this brings up a dialogue box that 
  98. allows a range of options to be changed, and 
  99. these changes may be made permanent so 
  100. that they become the new defaults when the 
  101. application is subsequently started.
  102.  
  103.  
  104.  
  105.      The choices should be self explanatory. The 
  106. font name and size can be changed. To 
  107. change the font, simply click on the name 
  108. field, when a menu will open with all the 
  109. installed fonts shown, from which a choice can 
  110. be made. Clicking on either of the size icon 
  111. fields will place the caret ready to enter the 
  112. new size. The type of point symbol (size and 
  113. whether filled) used for the graph can be 
  114. changed by clicking on the appropriate 
  115. buttons. The changes will not come into 
  116. operation until the OK button is pressed. If the 
  117. cancel button (or the window close icon) is 
  118. pressed, the dialogue box is removed from the 
  119. screen, and the original defaults remain in 
  120. effect. The selection can be made the new 
  121. default by clicking on the save icon. (This 
  122. option is NOT available when the application 
  123. is running over econet). Note that the default 
  124. file is saved within the !MultiPlot application, 
  125. therefore, if the application is being run from a 
  126. floppy disc, the filer may request the disc 
  127. containing the !MultiPlot application to be 
  128. inserted in the disc drive.
  129.  
  130. Clear data
  131. Selecting this option will irretrievably clear all 
  132. data currently loaded. The iconbar icon will 
  133. show 'no lines' below it after this operation.
  134.  
  135. Save Data
  136. This will lead to a standard "save as" dialogue 
  137. box, allowing all the current data to be saved 
  138. in the one file. This is useful if you have 
  139. several lines loaded and wish to save the 
  140. complete set. Remember that MultiPlot data 
  141. files cannot be loaded into any other 
  142. applications, and once a composite data file 
  143. has been produced, there is no simple way to 
  144. extract the component parts again.
  145.  
  146. Quit
  147. The method by which you quit the application.  All
  148. windows belonging to the application will  be
  149. closed, and its icon will be removed from  the
  150. iconbar. Since there are no editing  facilities in
  151. this application, it will simply quit. It  is up
  152. to the user to ensure that any data which is to be
  153. saved has  been saved before the quit operation is
  154. invoked.
  155.  
  156. Graph Window Menus
  157.  
  158. Whenever a graph is being displayed, clicking 
  159. 'menu' will lead to a further range of options. These 
  160. options are essentially the same as are offered in 
  161. the !GraphDraw application.
  162.  
  163.  
  164.  
  165.  
  166. Legend
  167. This opens a window which allows you to 
  168. enter text to label the graph axes, and a title 
  169. string for the graph. Clicking on display will 
  170. place the labels on the graph, while delete will 
  171. remove labels from the graph (the text 
  172. remains in memory and can be reinstated by 
  173. reselecting label and clicking on display). 
  174. Simply closing the menu will leave the state of 
  175. the labels as they were.
  176.  
  177.  
  178.  
  179. The labels are dragable icons and can thus be 
  180. dragged to anywhere on the graph if you do 
  181. not like the default positions. The same labels 
  182. will appear on any graph, with the previous 
  183. position being remembered. The y-axis label is plotted
  184. horizontally or plotted vertically, reading downwards.
  185. This is  something I am not too sure about as far as 
  186. the aesthetics of display are concerned. I have  not yet
  187. worked out how to rotate outline font  text through 90
  188. degrees so that it reads up the axis without writing a
  189. great deal of extra code!
  190.  
  191. One way to produce such text if you have access
  192. either to !DrawPlus or !FontFX is to produce the
  193. graph with no y-axis label (just press return)
  194. and produce a DrawFile of the graph. DrawPlus is
  195. able to produce outline text reading in any
  196. direction, so simply load the drawfile into
  197. DrawPlus and add the y-axis label. With access to
  198. FontFX and Draw, load the graph drawfile into
  199. !Draw and then use !FontFX to produce the  rotated
  200. y-axis annotation. Once this has been added to
  201. the !Draw document, it can be rescaled and
  202. dragged to a suitable position.
  203.  
  204. If data is saved after legends have been 
  205. entered, then the text is also saved, and is 
  206. reloaded when the data is reloaded.
  207.  
  208. Print Graph
  209.  
  210. Choosing this option gives a printout of the 
  211. complete graph via whichever RISC-OS  printer driver
  212. application is installed. A printer  driver must be
  213. installed, otherwise !MultiPlot  will complain. This
  214. allows a much higher  quality hard copy to be obtained
  215. compared to  a simple screen dump, up to the best
  216. available  resolution of the printer used. The "print"
  217. key can be used as a shortcut.
  218.  
  219. Make Drawfile
  220.  
  221. A standard 'save as' dialogue box will be 
  222. opened. The file icon may be dragged to a 
  223. directory viewer, or if the full filename path is 
  224. set up it is possible to click on OK. The file 
  225. saved is a Drawfile of the graph being 
  226. displayed. It is also permissible to drag the file 
  227. icon into a !draw window to add the graph to 
  228. an existing draw document, or drag the icon to 
  229. the !draw icon on the iconbar, when a new 
  230. draw window will be opened. These latter 
  231. operations make use of the wimp$scrap 
  232. protocol in the present version - direct memory 
  233. to memory transfer is to come! The production 
  234. of !Draw format files means that the graphs 
  235. can be loaded into !Draw or !DrawPlus