home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilsf / jfshared / !JFUsage / !Help next >
Encoding:
Text File  |  1995-06-08  |  4.6 KB  |  142 lines
  1.                                     JFUsage
  2.                                     -------
  3. Version 1.00 (08 Jun 1995)
  4.  
  5. Introduction
  6. ------------
  7. If you've programmed any desktop proglets then at sometime or another you'll
  8. have wanted to find out if they are running speedily. I recently decided to
  9. go through all my programs and mask out the null polls on them all -
  10. something I should have done originally. But I wanted to test the speed
  11. increase. So I wrote JFUsage as the Acorn Usage meter is not very useful if
  12. you want to compare speeds figuratively.
  13.  
  14. The clock measures the average time taken to perform 20 Wimp_Polls and return
  15. with Null codes. This is measured in centi-seconds and is really quite fast
  16. on a well organised desktop.
  17.  
  18. Usage
  19. -----
  20. • Run the program.
  21. • Watch the figures until the overall average settles down to a relatively
  22.   constant value.
  23. • Make changes to programs.
  24. • Click Reset on the menu.
  25. • Wait for figures to settle to see speed change
  26.     
  27.  
  28. How it works
  29. ------------
  30. The main average (the top one) is the average of the last 20 polls. The
  31. overall average (the bottom one) is the average of the polls since the
  32. program was last reset.
  33.  
  34.  
  35. Expected results
  36. ----------------
  37. I have a A5000 33Mhz RO3.22m (VAPOURWARE!). So timings are related to this :
  38.  • On an unoptimised desktop I got 2.385 cs poll-time
  39.  • By optimising using Wimp_Poll with nulls masked out, and using
  40.    Wimp_PollIdle where this is not appropriate I got 0.899 cs poll-time. An
  41.    increase of about 165% in responsiveness!
  42.  • As I write this the desktops overall average is 0.855 cs poll-time.
  43.    Currently I have these applications running :
  44.      Alarm
  45.      Justin's Filer
  46.      Virtual Desktop 2.10
  47.      Reminders - Modified (used to slow down the desktop massively)
  48.      DarkHorse - Modified (ditto)
  49.      ReadMail 1.15
  50.      Zap 1.20
  51.      StrongHelp 2.01
  52.      Close - my app to close files which are left open
  53.      PackDir 1.18
  54.      JFUsage - obviously
  55.      TaskManager
  56.      Filer
  57.      ADFS Filer
  58.      Resource Filer
  59.      Free
  60.      Palette Utility
  61.      VProtect
  62.      ClipBoard (Röling ?)
  63.  
  64.  
  65. Bugs
  66. ----
  67. I did encounter one ‘bug’ in the program or perhaps in the Wimp. When running
  68. the average can jump massively if very few apps are running. Whilst trying to
  69. find out the fastest the desktop would run I hit upon the limit of about
  70. 0.135 cs with 4 tasks running. Quitting another made little difference, until
  71. I had quite everything (as in not even an iconbar) and all that remained was
  72. JFUsage. When I did this the average shot up from 0.135 to 0.435.
  73.  
  74. Why this should be I don't know and due to the circumstances (ie no editors
  75. or debuggers loaded!) I could discover no more.
  76.  
  77. Remember the act of measuring must effect the quantity being measured. Well
  78. know physical fact which bears true here and may be the cause of this
  79. spurious result.
  80.  
  81.  
  82. Sprite ?
  83. --------
  84. Don't ask me what the sprite is, I don't know. I designed it specifically for
  85. this and I haven't a clue what relevance it has - feel free to design
  86. another.
  87.  
  88.  
  89. Help and message files
  90. ----------------------
  91. This application is fully !Help compliant and it is recommended that when
  92. getting to grips with it the help should be used if only to give it some
  93. purpose! It also supports the use of MessageTrans and therefore translation
  94. to another language or changing the messages for the fun of it is much easier
  95. than it might have been.
  96.  
  97.  
  98. <BasicLibrary$File>
  99. -------------------
  100. This application requires Justin Fletcher's JFShared library to function.
  101. This can be obtained from Arcade and possibly other bulletin boards. I have
  102. seen QuickHelp on Digital Databank, so it is possible that JFShared exists
  103. there also.
  104.  
  105.  
  106. Compatibility
  107. -------------
  108. This application has been tested on the author's A5000, but due to the lack
  109. of friends with Acorns has not been tested on other systems. Therefore, it
  110. ought to work on any RO3.1 machine, and with a RO2 machine if it is
  111. recognised in JFShared and uses no specific RO3 features.
  112.  
  113.  
  114. Disclaimer
  115. ----------
  116.   The author accepts no responsibility for any problems which this
  117. application may cause or loss of data resulting in its use. This application
  118. is Public Domain. This means that it may be distributed, so long as no charge
  119. other than copying costs are charged for it.
  120.   
  121.         
  122. Contact                
  123. -------
  124. Any comments, queries, donations or bug reports can be sent to :
  125.  
  126. Fidonet NetMail :  Justin Fletcher at Arcade (0181 655 4412) [2:254/27]
  127. E-Mail : Gerph@arcade.demon.co.uk
  128.  
  129. Snail Mail :
  130.     Justin Fletcher
  131.     “Galadriel”
  132.     17b Cromwell Road,
  133.     Weeting,
  134.     Brandon,
  135.     Suffolk.
  136.     IP27 0QT
  137.  
  138.  
  139. History
  140. -------
  141. Version 1.00 : 8th June 1995
  142.                First version written