home *** CD-ROM | disk | FTP | other *** search
/ Amiga ACS 1998 #4 / amigaacscoverdisc1998-041998.iso / utilities / shareware / workbench / fblit / fblit24.doc < prev    next >
Encoding:
Text File  |  1998-03-07  |  5.4 KB  |  186 lines
  1.  
  2. FBlit 2.4
  3. ---------
  4. 'FBlit' is © Stephen Brookes 1997-98
  5.  
  6.  
  7.  
  8. Blah
  9. ----
  10. This software is experimental, incomplete and fundamentaly dangerous, so
  11. don't use it! I will take no responsibility for any undesirable effects
  12. resulting from the use of any software or information in this archive.
  13.  
  14.  
  15.  
  16. Distribution
  17. ------------
  18. 'FBlit' is freely distributable.
  19.  
  20.  
  21.  
  22. Required
  23. --------
  24. 020+ CPU, the faster the better.
  25. Fast RAM
  26. V39+
  27.  
  28. The GUI requires MUI, but the GUI itself is not essential. Indeed, you are
  29. advised not to go anywhere near it!
  30.  
  31.  
  32.  
  33. Installation
  34. ------------
  35. Put 'FBlit' and 'FBlitGUI' in 'C:'
  36.  
  37. If you were using a pre v2.38 version of FBlit. Delete 'envarc:fblit.cfg'
  38. and reset after installing this one, otherwise you will not get the current
  39. task promotion list.
  40.  
  41.  
  42.  
  43. Usage
  44. -----
  45. Type 'run >nil: fblit', or launch from the workbench.
  46.  
  47. For a permanent installation. Add the line 'run >nil: c:fblit' to your
  48. 's:startup-sequence' soon after 'env:' and 'envarc:' have been set up.
  49.  
  50. See separate doc for GUI usage, or better still, don't touch it. If you
  51. ever see the GUI, pressing 'cancel' is probably the best plan of action.
  52.  
  53.  
  54.  
  55. What's That?
  56. ------------
  57. If you skipped the 'Blah' section, go and read it now!
  58.  
  59. In case you still can't be bothered. This software is not complete. It is
  60. experimental and has only been released at this time due to pressure from
  61. people for whom it has worked, and the possibility that I may have had
  62. enough of developing it for now.
  63.  
  64. FBlit patches some OS functions that normally use the blitter, such that
  65. they now use the CPU and consequently may function outside chip mem.
  66.  
  67. The patched functions are also faster and will suffer less from colour
  68. flicker on non-interleaved data.
  69.  
  70. In addition, FBlit allows non-displayable bitmaps to be allocated in fast
  71. mem for named tasks.
  72.  
  73. The current version of FBlit with default config will do the following.
  74.  
  75. - Minor OS rendering speed up.
  76. - Reduction in colour flicker.
  77. - Allow NewIcons to be stable in RTG mode on a standard Amiga (if you can
  78.   live with corrupt icons while dragging them, or are running DopusMag)
  79. - Forces the following programmes to use fast ram for some graphics data.
  80.     Voyager 288
  81.     IBrowse
  82.     AWeb
  83.     IPrefs (workbench/window backdrops)
  84.  
  85. Note that FBlit must be run early in the startup sequence if default
  86. wbpatterns are to be promoted, and similarly if NewIcons is to be launched
  87. in its RTG mode.
  88.  
  89.  
  90.  
  91. Trouble And Strife
  92. ------------------
  93. FBlit appears to function perfectly on the majority of systems, but it can
  94. never be 100% compatible. There is much scope for other software to cause
  95. problems and some certainly does.
  96.  
  97. Unfortunately, none has been identified at this time. If FBlit causes
  98. corrupt graphics on your system you will have to either forget about FBlit,
  99. or find the software causing the problems and then decide which is more
  100. important to you.
  101.  
  102. Other software that patches the same functions as FBlit may also cause
  103. trouble. MCX, MCP, CPUBlit etc... though I run MCP here without problems.
  104.  
  105.  
  106.  
  107. Short Tech Bit
  108. --------------
  109. FBltBitMap is fully functional and the most complete/tested patch.
  110. FBltClear is also fully functional, but probably pretty pointless.
  111. FBltTemplate only intercepts and discards operations in Fast RAM.
  112. FBltPattern will only work in Fast RAM with JAM2 and no mask/area pattern.
  113. FBitMapScale is fully functional, but a very early version.
  114. FAllocMem and FAllocBitMap are of no interest.
  115.  
  116. The fact that 'BltBitMap' is patched also effects a large number of other
  117. OS functions. I don't know exactly how much of the OS can now operate in
  118. Fast RAM, 'DrawGList' (BOBs etc.) probably won't, 'BltTemplate' (text) and
  119. 'BltPattern' certainly won't. 'BltBitMapRastPort', 'ClipBlit',
  120. 'BltMaskBitMapRastPort' and 'DrawImage' are useful ones that will. Super
  121. bitmap stuff also appears to work.
  122.  
  123. 'FBLITPLANES' is a special default task name recognized by FBlit. If FBlit
  124. is running, and your task has that name during a call to 'allocbitmap' (for
  125. a non-displayable bitmap), you will get a bitmap with all planes in fast
  126. ram, or nothing. Of course, if FBlit isn't running, or is set up in certain
  127. ways, you will get a perfectly normal 'allocbitmap' call.
  128.  
  129. FBlit also maintains a public message port 'FBlit', but since this version
  130. can be set up such that it does not process data in fast mem it is not
  131. advisable to take the presense of the port as a licence to keep all your
  132. intuition images etc. in fast ram. Have an RTG switch instead.
  133.  
  134. More techy nonsense is in the GUI doc...
  135.  
  136.  
  137.  
  138. Past
  139. ----
  140. There has been loads of that, and I'm not going into it here.
  141.  
  142.  
  143.  
  144. Future
  145. ------
  146. Functional patches for 'blttemplate' and 'bltpattern' may make FBlit
  147. considerably more usefull, but I'm not sure I can be bothered.
  148.  
  149.  
  150.  
  151. Built With Amiga?
  152. -----------------
  153. Development machine is...
  154. A1200 040/40 V40 etc.
  155.  
  156.  
  157.  
  158. Please Crash My Computer
  159. ------------------------
  160. Thanks to some people who like corrupt displays so much, they tried this
  161. software...
  162.  
  163.  Evan Tuer              et@enterprise.net
  164.                         http://homepages.enterprise.net/et
  165.                         (Endless Testing and icon)
  166.  
  167.  Gary Colville          gary@empire.u-net.com
  168.                         2:250/366.12
  169.                         http://www.personal.u-net.com/~empire
  170.                         (Testing)
  171.  
  172.  James L Boyd        jamesboyd@velvety.demon.co.uk
  173.                         (More testing)
  174.  
  175.  Colin Wenzel           colstv@pronet.net.au
  176.             http://www.pronet.net.au/~colstv
  177.             (Yet more testing)
  178.  
  179.  
  180.  
  181. Contact
  182. -------
  183.  
  184.  Stephen Brookes        2:258/4.15
  185.                         sbrookes@tpec.u-net.com
  186.