home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 4: Demo 1 / almathera_demo1.bin / amos / docs.lzh / AMOS-Monitor.Doc next >
Text File  |  1999-07-17  |  7KB  |  216 lines
  1.  
  2.  
  3.  
  4.                        A m o s   M o n i t o r   v 1 . 0
  5.                      -------------------------------------
  6.  
  7.                        Written, by Ben Ashley  © 1 9 9 2
  8.  
  9.                                 Odyssey Software
  10.  
  11.  
  12. ***************************************************************************
  13. This program is nameware.  If you use it in the creation of your games, 
  14. then please mention my name.  I can`t do anything if you don`t, as I have
  15. no way of checking.  So it`s up to you to keep a clear conciounce.
  16. ***************************************************************************
  17.  
  18. To alot of AMOS Programmer, the FOLLOW command is pathetic.  I`m one of
  19. those people.  Ok, so you can follow each command one by one, and display
  20. varibles.  It does not REALLY give you a helping hand.  And usually, it
  21. doesn`t work anyway.
  22. So, a bit miffed, I have produced a Monitor for the Masses, which can do
  23. many things.  But it does not do it command by command, it is REAL-TIME.
  24.  
  25. Installation
  26. ------------
  27. Installation is quite simple.  Load up the program, AMOS-MONITOR.AMOS
  28. , this is a whole program, used as an example.  Go down through the
  29. listing, and save the procedure, MONITOR, out as an Ascii file.  Mereg this
  30. into the program you want to debug.
  31.  
  32. Firstly, before you do anything, near the start of your program, add the
  33. following varibles to your global list.  Or if you don`t have a global
  34. list, start one.
  35.  
  36.              Global OPEN,CAL,XN,YN,IN,DATE$,TIME$
  37.  
  38. Now, depending upon where you want your monitor to be called, you place a 3
  39. lines of necessary code.  Lets say you want it to be called in your
  40. mainloop, then somewhere in that loop you would put:
  41. Actually, the `Screen 0', should be changed to whatever screen is being
  42. used, BEFORE the monitor routine is called.
  43.  
  44.  
  45.                     If OPEN<2
  46.                        MONITOR[V1,V2,V3,V4,V5,V6,V7,V8]
  47.                        Screen 0
  48.                     End If
  49.  
  50.  
  51. V1-V8, are varibles which you can monitor.  More on that later.
  52. What you have done now, will actually monitor the progress of your loop. 
  53. But you can`t see it.  Here, you can decide which key brings it up.  In the
  54. Next example I use, ESCAPE for this....
  55.  
  56.                     If Key State(69)
  57.                        CAL=1
  58.                     End If
  59.  
  60. Bingo!  That`s the installation coding complete.
  61.  
  62. In the program itself, ( Where you cut the procedure out, in the first
  63. place ), you`ll find that it calls the Monitor with a number of varibles,
  64. of screen co-ordinates and mouse co-ordinates. 
  65.  
  66.  
  67. The Options
  68. -----------
  69. You can select a number of different things to do, from the menu`s.
  70.  
  71. Menu 1:  
  72. =======
  73.  
  74. System    :  Displays Free Chip, Free Fast, Free Text Buffer.
  75.  
  76. DiskInfo  :  Gives you information about Df0:
  77.  
  78. Utilities :  Allows you to:
  79.                            1. Delete Bobs
  80.                            2. Delete Icons
  81.                            3. Paste Bobs
  82.                            4. Paste Icons
  83.                            5. Insert Bobs
  84.                            6. Insert Icons
  85.  
  86. Menu 2:
  87. =======
  88.  
  89. Variables        :  Will display the contents of the 8 variables which can
  90.                     be followed, by putting them in the call, as a parameter.
  91.  
  92. Output to RAMDISK:  Quite a useful one.  Outputs information of bob 
  93.                     definitions, and the 8 tracked variables, every frame.
  94.                     To stop this, select it again, and when you do,
  95.                     you`ll be asked whether or not you want the ASCII file
  96.                     in RAM to be transfered to Df0:, so you can look at it
  97.                     using an ASCII displayer.
  98.  
  99. Co-Ordinates     :  Displays X & Y Mouse Co-Ordinates, and X & Y Screen
  100.                     Co-Ordinates.
  101.     
  102.  
  103. Menu 3:  Monitor Menu
  104. =======
  105.  
  106. Hide Monitor     :  Closes the monitor, as if it has not been called.
  107.                     To call it back, just use the same checks, of 
  108.                     setting CAL to 1.
  109.  
  110. Close Monitor    :  Basically the same as above, but it is not run at 
  111.                     all!  You can call it back in the same way though!
  112.  
  113. About Monitor    :  Doesn`t take an ediot to work this out.
  114.  
  115.  
  116.  
  117. Menu 4:  3D Specific
  118. =======
  119.  
  120. Priority          :  You can specify the drawing priority on any of your
  121.                      objects.
  122.                   
  123. Colour Combination:  Allows you to choose one of the combinations for your
  124.                      3D object to use.  Same as the function within the 
  125.                      3D modeller.
  126.  
  127. Pragma            :  This is an un-documented command, which requires 2 
  128.                      parameters, the first of which, I have taken to be
  129.                      an object number.  I don`t know what it does at all, 
  130.                      and I see no visible affect.  But you can adjust it.
  131.  
  132.  
  133.  
  134. Menu 5:  Tome specific
  135. =======
  136.  
  137. Map Info           :  Gives the size of your map in X and Y co-ords.
  138.  
  139. Tile Value         :  Gives the Tile Value, and Tile Number at the 
  140.                       X and Y mouse, co-ordinates!
  141.  
  142.  
  143. Menu 6:
  144. =======
  145.  
  146. Break On           :  Turn the CTRL-C check on.
  147.  
  148. Break Off          :  Turn the CTRL-C check off.
  149.  
  150. Back to AMOS       :  Deletes any RAM disk files, and goes back to AMOS!
  151.  
  152.  
  153. Menu 7:
  154. =======
  155.  
  156. Areg Values        :  Displays, in real-time, all 6 AREG values!
  157.  
  158. Dreg Values        :  Displays, in real-time, all 7 DREG values!
  159.  
  160.  
  161. Menu 8:
  162. =======
  163.  
  164. Date & Time        :  Displays, in real-time, the date and the time
  165.  
  166. RAM save Frames    :  Gives you the option, of when you want the RAM DISK
  167.                       to be updated.  This can be from 1-9 frames!
  168.  
  169.  
  170. The menu`s which have a SPECIFIC, after them, require that extension to
  171. work.  AMOS-Monitor, does not check, and an error will occur.  But it won`t
  172. say, as all errors are resumed on the next command, so as not to upset your
  173. program.
  174.  
  175.  
  176. Limitations
  177. -----------
  178. All programs have limitations, including AMOS - Monitor.....
  179.  
  180. * Amos Monitor, uses SCREEN 7.  If your program uses this, then of course,
  181. problems will arise!
  182.  
  183. * Amos Monitor, requires a mouse pointer.  Even if it`s just for
  184. programming time, have the mouse pointer on.
  185.  
  186. * Whilst saving to the RAM Disk, and displaying things in 
  187. realtime, the program will be slightly slower, due to the updating process 
  188. of the monitor!
  189.  
  190. * Your program can`t use the variables that the monitor uses.  All problems
  191. in this field can be avoided, by planning ahead.
  192.  
  193.  
  194.  
  195. Anything Else?
  196. --------------
  197. I am considering, doing an update to AMOS-MONITOR, and I would greatly
  198. appreciate your views & ideas for it.  Anyway, if you understand my coding,
  199. it is not too difficult to update yourself.
  200. The main problem with updating though, is keeping the monitor to a
  201. reasonable size.  I don`t want it too large.  Anyway, here is a list of
  202. things I would like to include:
  203.  
  204.  
  205.  
  206. Any ideas to me, you can send them to:
  207.  
  208.                         Odyssey Software
  209.                         331 London Road
  210.                         Stoneygate
  211.                         Leicester
  212.                         LE2 3NE
  213.  
  214.  Or, better still:      Tel: (0533) 705630
  215.                         Fax: (0533) 704673
  216.