home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / program / debug / vecscope / !VecScope / !Help < prev    next >
Encoding:
Text File  |  1991-07-25  |  6.0 KB  |  149 lines
  1.  
  2.  ------------------------------ V e c S c o p e ----------------------------
  3.  ------------------------------     V 1.00      ----------------------------
  4.  
  5.       This program is Public Domain and may be copied freely.
  6.  
  7.       Purpose
  8.       -------
  9.  
  10.       This utility is capable of monitoring all system vectors in the
  11.       desktop constantly by way of opening one or more windows each
  12.       displaying a vector's counting, it is mainly useful for programmers
  13.       and other expierenced users.
  14.  
  15.       What is a vector?
  16.  
  17.       A vector is in fact a handler to a standard program in your ma-
  18.       chine which is executed when an event occurs, eg when a character
  19.       is send to the screen.
  20.  
  21.       What is the value of VecScope?
  22.  
  23.       1) Obtain a better knowledge of the working of your Archimedes,
  24.          for example by:
  25.  
  26.          - visually confirm your expectations about operations of
  27.            Risc OS
  28.  
  29.          - discover what operation effects a vector
  30.  
  31.          - see the impact of operations seeming unimportant
  32.  
  33.       2) Debug programs by visually check your expectations about the
  34.          working of a program under development, especially with the
  35.          vectors concerning fileoperations (FileV,GBPBV,etc).
  36.  
  37.  
  38.       Usage
  39.       -----
  40.       To start VecScope, double click on its icon in a directory
  41.       viewer; it will put itself on the iconbar as usual.
  42.  
  43.       The VecScope icon will only respond to a click on it with the
  44.       middle mouse button <menu>; a menu will pop up with the follow-
  45.       ing items on it:
  46.  
  47.         Info    - moving the pointer over the arrow, next to 'Info',
  48.                   will show the familiar box containing global infor-
  49.                   mation
  50.  
  51.         Vectors - this item has an arrow too; moving the pointer over
  52.                   it will pop up a submenu with items explained later
  53.                   on
  54.  
  55.         Quit    - a click on this item will close down VecScope; this
  56.                   means that all the windows belonging to VecScope
  57.                   are removed and that the icon disappear from the
  58.                   icon bar
  59.  
  60.                   Quiting using the taskmanager display is NOT recom-
  61.                   mended because in this way the counting of vectors
  62.                   may remain active internally!
  63.  
  64.  
  65.  
  66.       Of course the real stuff is started by following the earlier
  67.       mentioned 'Vectors' item.
  68.       The 'Vectors' submenu has five items all having another submenu
  69.       of their own containing the names of all the (32) software vectors
  70.       in your Archimedes.
  71.       By selecting such a name, VecScope opens a window with two numbers
  72.       in it called 'Start time' and 'Count'.
  73.  
  74.         'Start time' shows the time the window was opened by VecScope,
  75.         so you can roughly estimates the usage of a vector during the
  76.         excistance of the window.
  77.  
  78.         'Count' is the most importly part of the whole program; this
  79.         value is updated immediately when the vecor was called by your
  80.         Archimedes, giving you the ability to monitor a vector con-
  81.         stantly
  82.  
  83.       Because it is very well possible to open more then one window,
  84.       each window has the name of the vector it is counting as its
  85.       title.
  86.  
  87.       The five items of the 'Vectors' submenu are symbolic names of
  88.       vector groups, they are:
  89.  
  90.         Rarely   - this item has a submenu containing vector names
  91.                    of vectors that are updated rarely by the system;
  92.                    only in special cases the are called more frequently,
  93.                    for example when some software uses the UserV vector
  94.                    it is increasing otherwise it will remain zero all
  95.                    the time.
  96.  
  97.         Regular  - vectors belonging to this group are executed regular
  98.                    by your machine, for example CLIV is used whenever
  99.                    a *-command is issued.
  100.  
  101.         Often    - these vectors are called rather often like the WrchV
  102.                    vector which is called every time something is written
  103.                    to an output device such as the screen and printer.
  104.  
  105.         Constant - the counter in these vectorwindows are updated con-
  106.                    stantly, one of them is TickerV, a vector executed
  107.                    100 times in one second to keep the internal time
  108.                    up to date; it is not very useful to keep a window
  109.                    open for these vectors because the constant updating
  110.                    of the counters makes the other programs slower.
  111.  
  112.         Bursts   - the last group of vectors are increased in bursts,
  113.                    ie only when a program needs it; eg the DrawV vec-
  114.                    tor is only used when Draw-operation are performed,
  115.                    like in Impression or of course in '!Draw' itself.
  116.  
  117.  
  118.       To emphasis the fun of VecScope I will end with some practical
  119.       examples you can try out for yourself:
  120.  
  121.       - see WordV incrementing every second when '!Alarm' is running;
  122.         it halts when '!Alarm' is removed
  123.  
  124.       - watch the rapid incrementing of CLIV when the directory viewer
  125.         of Application disc 2 is made; this gives an impression of the
  126.         amount of *-commands issued during such an operation
  127.  
  128.       - notice the amount of calls to BgetV when using a *DUMP issued
  129.         from a shell (eg after <f12>)
  130.  
  131.       - observe the calls to ColourV after a mode-change while displaying
  132.         a sprite in '!Paint'
  133.  
  134.       - try loading two copies of VecScope in your desktop (and nothing
  135.         else) and open both their WrchV windows; see how the first copy
  136.         monitors the second and vice versa, when you close one of the
  137.         WrchV windows, the remaining will stop increasing
  138.  
  139.       If you have any suggestions or if you want to give some remarks,
  140.       please don't hesitate to contact me.
  141.  
  142.       In the mean time have fun using VecScope.
  143.  
  144.                                                    29 june 1990,
  145.  
  146.                                                    Machiel Jansen
  147.                                                    Willem de Zwijgerln 66 1
  148.                                                    1056 JT  Amsterdam.
  149.