home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #4 / amigamamagazinepolishissue1998.iso / c / ffppatch.readme < prev    next >
Text File  |  1997-06-16  |  4KB  |  120 lines

  1. Short:    mathffp.library FPU speedup patch
  2. Author:   Jess Sosnoski (at the below address!!!)
  3. Uploader: starblaz@postoffice.ptd.net
  4. Type:     util/boot
  5. Version:  1.1beta
  6. Requires: kick 2.04+, fmath406.lha, an 020+, and a 68881/2 FPU.
  7. Long:
  8.  
  9. FFPpatch 1.1beta © 1997 Jess Sosnoski
  10.  
  11. DESCRIPTION:
  12. -----------
  13. This is a program that patches some functions of the mathffp.library
  14. to use 68881/2 instructions, thus squeezing out a bit more speed.
  15.  
  16. This is also the first speedup patch I ever attempted to write! :)
  17.  
  18. This program REQUIRES mathtrans.library v40+ from the fmath406.lha archive
  19. on aminet...and a 68881/2 FPU. (AND at least a 68020)
  20. (and if you have an FPU you will definately have at least an 020)
  21.  
  22. But...will it work on an 040....I'd guess it would, as it doesn't use
  23. any trig functions whatsoever...so all you lucky 040 (060!) owners can
  24. knock yourselves out too! :)
  25.  
  26. For now mathtrans.library is required to convert FFP math to IEEE math...
  27. eventually, I'm going to remove this requirement and put the conversion
  28. routines directly into the patch.
  29.  
  30. If you don't use the fmath406 libraries, the patched functions will likely
  31. run slower.
  32.  
  33. DISCLAIMER:
  34. ----------
  35. Use this program at your own risk!
  36. I assume no responsibility or liability for problem(s) and/or damage(s)
  37. that occur by the use, modification, and/or existence of this product,
  38. and/or its parts in any form.
  39.  
  40.  But if it don't work right, or slows things down, don't be afraid
  41.  to send me email...or even send some email if it makes your system
  42.  outprocess a cray (yeah, right)
  43.  
  44. Anywayz tho...the following functions are patched, and here's the
  45. speed differences I got with a test program I wrote:
  46. (the test program wasn't the best in the world either, but....)
  47.  
  48.           (time in seconds)
  49. Function     New      Old
  50. ----------------------------
  51. SPAbs        1.93     2.44
  52. SPNeg        1.84     2.53
  53. SPMul        4.52     7.88
  54. SPDiv        4.98     5.56
  55. SPFloat      2.31     2.89
  56. SPFloor         4.30     5.90
  57.  
  58. No astronomical difference, but multiply is definately a lot faster.
  59. (Proably a hair faster than ffppatch 1.0 though :) )
  60.  
  61. USAGE:
  62. -----
  63. run <>NIL: ffppatch
  64.  
  65. OUTPUT:
  66. ------
  67. None...as I didn't feel like figuring out how to to text output
  68. in assembly.
  69. Although, if you don't have the right versions of the required libraries,
  70. it will exit with a returncode of 20.
  71.  
  72. REMOVAL:
  73. -------
  74. sorry....once it's in...it stays in!
  75. (didn't I hear Al Bundy say that to Peg once...hmmm....)
  76.  
  77. CAVEATS:
  78. -------
  79. Opens mathffp and mathtrans.libraries, and never closes them...oh well...
  80. (well...it'll close mathffp if mathtrans isn't right version)
  81. (I was too lazy to put that code in)
  82.  
  83. HISTORY:
  84. -------
  85. 1.0     First Release
  86. 1.1    Now closes mathffp.library when mathtrans.lib v40 cant be opened
  87.     Optimized spmul, spdiv, spabs, spneg, spflt, spfloor and squeezed
  88.     a couple more clock cycles out.
  89.     (spadd and spsub optimized too, but disabled cuz they were
  90.      slower for some reason :( )
  91.     Removed SPFix patch...it was slower :(
  92.     
  93. FUTURE:
  94. ------
  95. Remove mathtrans.library references and do conversion from within the
  96. patch.
  97. Add more patches for the other functions.
  98. Make this doc file a bit more presentable, and maybe leave it as plain
  99. text without amigaguide OR HTML just for kicks.
  100.  
  101. BUGS:
  102. ----
  103. Hmmm...what would Tom say, ohyeah, um....possibly.
  104.  
  105. AUTHOR:
  106. ------
  107. Jess Sosnoski
  108. 651 Hillside Drive
  109. Mount Carmel, PA 17851-2463
  110. USA
  111.  
  112. starblaz@postoffice.ptd.net
  113. http://home.ptd.net/~starblaz
  114.  
  115. IRC nick: starblaz
  116. On: galaxynet (#amichat), beyondirc (#styx, #amirc), dalnet (#nin ,#c-64)
  117.  
  118. Emails, gifts, money, food, cigarettes, Amiga4060T's will all be
  119. gladly accepted.
  120.